Google Cloud Dialogflow V2 Client - Class EntityTypesClient (1.15.1)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Dialogflow\V2\BatchCreateEntitiesRequest;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\EntityType\Entity;
use Google\Rpc\Status;

/**
 * @param string $formattedParent         The name of the entity type to create entities in. Format:
 *                                        `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. Please see
 *                                        {@see EntityTypesClient::entityTypeName()} for help formatting this field.
 * @param string $entitiesValue           The primary value associated with this entity entry.
 *                                        For example, if the entity type is *vegetable*, the value could be
 *                                        *scallions*.
 *
 *                                        For `KIND_MAP` entity types:
 *
 *                                        *   A reference value to be used in place of synonyms.
 *
 *                                        For `KIND_LIST` entity types:
 *
 *                                        *   A string that can contain references to other entity types (with or
 *                                        without aliases).
 * @param string $entitiesSynonymsElement A collection of value synonyms. For example, if the entity type
 *                                        is *vegetable*, and `value` is *scallions*, a synonym could be *green
 *                                        onions*.
 *
 *                                        For `KIND_LIST` entity types:
 *
 *                                        *   This collection must contain exactly one synonym equal to `value`.
 */
function batch_create_entities_sample(
    string $formattedParent,
    string $entitiesValue,
    string $entitiesSynonymsElement
): void {
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entitiesSynonyms = [$entitiesSynonymsElement,];
    $entity = (new Entity())
        ->setValue($entitiesValue)
        ->setSynonyms($entitiesSynonyms);
    $entities = [$entity,];
    $request = (new BatchCreateEntitiesRequest())
        ->setParent($formattedParent)
        ->setEntities($entities);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $entityTypesClient->batchCreateEntities($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::entityTypeName('[PROJECT]', '[ENTITY_TYPE]');
    $entitiesValue = '[VALUE]';
    $entitiesSynonymsElement = '[SYNONYMS]';

    batch_create_entities_sample($formattedParent, $entitiesValue, $entitiesSynonymsElement);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Dialogflow\V2\BatchDeleteEntitiesRequest;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Rpc\Status;

/**
 * @param string $formattedParent     The name of the entity type to delete entries for. Format:
 *                                    `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. Please see
 *                                    {@see EntityTypesClient::entityTypeName()} for help formatting this field.
 * @param string $entityValuesElement The reference `values` of the entities to delete. Note that
 *                                    these are not fully-qualified names, i.e. they don't start with
 *                                    `projects/<Project ID>`.
 */
function batch_delete_entities_sample(string $formattedParent, string $entityValuesElement): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entityValues = [$entityValuesElement,];
    $request = (new BatchDeleteEntitiesRequest())
        ->setParent($formattedParent)
        ->setEntityValues($entityValues);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $entityTypesClient->batchDeleteEntities($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::entityTypeName('[PROJECT]', '[ENTITY_TYPE]');
    $entityValuesElement = '[ENTITY_VALUES]';

    batch_delete_entities_sample($formattedParent, $entityValuesElement);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Dialogflow\V2\BatchDeleteEntityTypesRequest;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Rpc\Status;

/**
 * @param string $formattedParent        The name of the agent to delete all entities types for. Format:
 *                                       `projects/<Project ID>/agent`. Please see
 *                                       {@see EntityTypesClient::agentName()} for help formatting this field.
 * @param string $entityTypeNamesElement The names entity types to delete. All names must point to the
 *                                       same agent as `parent`.
 */
function batch_delete_entity_types_sample(
    string $formattedParent,
    string $entityTypeNamesElement
): void {
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entityTypeNames = [$entityTypeNamesElement,];
    $request = (new BatchDeleteEntityTypesRequest())
        ->setParent($formattedParent)
        ->setEntityTypeNames($entityTypeNames);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $entityTypesClient->batchDeleteEntityTypes($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::agentName('[PROJECT]');
    $entityTypeNamesElement = '[ENTITY_TYPE_NAMES]';

    batch_delete_entity_types_sample($formattedParent, $entityTypeNamesElement);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Dialogflow\V2\BatchUpdateEntitiesRequest;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\EntityType\Entity;
use Google\Rpc\Status;

/**
 * @param string $formattedParent         The name of the entity type to update or create entities in.
 *                                        Format: `projects/<Project ID>/agent/entityTypes/<Entity Type ID>`. Please see
 *                                        {@see EntityTypesClient::entityTypeName()} for help formatting this field.
 * @param string $entitiesValue           The primary value associated with this entity entry.
 *                                        For example, if the entity type is *vegetable*, the value could be
 *                                        *scallions*.
 *
 *                                        For `KIND_MAP` entity types:
 *
 *                                        *   A reference value to be used in place of synonyms.
 *
 *                                        For `KIND_LIST` entity types:
 *
 *                                        *   A string that can contain references to other entity types (with or
 *                                        without aliases).
 * @param string $entitiesSynonymsElement A collection of value synonyms. For example, if the entity type
 *                                        is *vegetable*, and `value` is *scallions*, a synonym could be *green
 *                                        onions*.
 *
 *                                        For `KIND_LIST` entity types:
 *
 *                                        *   This collection must contain exactly one synonym equal to `value`.
 */
function batch_update_entities_sample(
    string $formattedParent,
    string $entitiesValue,
    string $entitiesSynonymsElement
): void {
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entitiesSynonyms = [$entitiesSynonymsElement,];
    $entity = (new Entity())
        ->setValue($entitiesValue)
        ->setSynonyms($entitiesSynonyms);
    $entities = [$entity,];
    $request = (new BatchUpdateEntitiesRequest())
        ->setParent($formattedParent)
        ->setEntities($entities);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $entityTypesClient->batchUpdateEntities($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            printf('Operation completed successfully.' . PHP_EOL);
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::entityTypeName('[PROJECT]', '[ENTITY_TYPE]');
    $entitiesValue = '[VALUE]';
    $entitiesSynonymsElement = '[SYNONYMS]';

    batch_update_entities_sample($formattedParent, $entitiesValue, $entitiesSynonymsElement);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Dialogflow\V2\BatchUpdateEntityTypesRequest;
use Google\Cloud\Dialogflow\V2\BatchUpdateEntityTypesResponse;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Rpc\Status;

/**
 * @param string $formattedParent The name of the agent to update or create entity types in.
 *                                Format: `projects/<Project ID>/agent`. Please see
 *                                {@see EntityTypesClient::agentName()} for help formatting this field.
 */
function batch_update_entity_types_sample(string $formattedParent): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = (new BatchUpdateEntityTypesRequest())
        ->setParent($formattedParent);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $entityTypesClient->batchUpdateEntityTypes($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            /** @var BatchUpdateEntityTypesResponse $result */
            $result = $response->getResult();
            printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::agentName('[PROJECT]');

    batch_update_entity_types_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\CreateEntityTypeRequest;
use Google\Cloud\Dialogflow\V2\EntityType;
use Google\Cloud\Dialogflow\V2\EntityType\Kind;

/**
 * @param string $formattedParent       The agent to create a entity type for.
 *                                      Format: `projects/<Project ID>/agent`. Please see
 *                                      {@see EntityTypesClient::agentName()} for help formatting this field.
 * @param string $entityTypeDisplayName The name of the entity type.
 * @param int    $entityTypeKind        Indicates the kind of entity type.
 */
function create_entity_type_sample(
    string $formattedParent,
    string $entityTypeDisplayName,
    int $entityTypeKind
): void {
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entityType = (new EntityType())
        ->setDisplayName($entityTypeDisplayName)
        ->setKind($entityTypeKind);
    $request = (new CreateEntityTypeRequest())
        ->setParent($formattedParent)
        ->setEntityType($entityType);

    // Call the API and handle any network failures.
    try {
        /** @var EntityType $response */
        $response = $entityTypesClient->createEntityType($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::agentName('[PROJECT]');
    $entityTypeDisplayName = '[DISPLAY_NAME]';
    $entityTypeKind = Kind::KIND_UNSPECIFIED;

    create_entity_type_sample($formattedParent, $entityTypeDisplayName, $entityTypeKind);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\DeleteEntityTypeRequest;

/**
 * @param string $formattedName The name of the entity type to delete.
 *                              Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`. Please see
 *                              {@see EntityTypesClient::entityTypeName()} for help formatting this field.
 */
function delete_entity_type_sample(string $formattedName): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = (new DeleteEntityTypeRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        $entityTypesClient->deleteEntityType($request);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = EntityTypesClient::entityTypeName('[PROJECT]', '[ENTITY_TYPE]');

    delete_entity_type_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\EntityType;
use Google\Cloud\Dialogflow\V2\GetEntityTypeRequest;

/**
 * @param string $formattedName The name of the entity type.
 *                              Format: `projects/<Project ID>/agent/entityTypes/<EntityType ID>`. Please see
 *                              {@see EntityTypesClient::entityTypeName()} for help formatting this field.
 */
function get_entity_type_sample(string $formattedName): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = (new GetEntityTypeRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var EntityType $response */
        $response = $entityTypesClient->getEntityType($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = EntityTypesClient::entityTypeName('[PROJECT]', '[ENTITY_TYPE]');

    get_entity_type_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\EntityType;
use Google\Cloud\Dialogflow\V2\ListEntityTypesRequest;

/**
 * @param string $formattedParent The agent to list all entity types from.
 *                                Format: `projects/<Project ID>/agent`. Please see
 *                                {@see EntityTypesClient::agentName()} for help formatting this field.
 */
function list_entity_types_sample(string $formattedParent): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = (new ListEntityTypesRequest())
        ->setParent($formattedParent);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $entityTypesClient->listEntityTypes($request);

        /** @var EntityType $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = EntityTypesClient::agentName('[PROJECT]');

    list_entity_types_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Dialogflow\V2\EntityType;
use Google\Cloud\Dialogflow\V2\EntityType\Kind;
use Google\Cloud\Dialogflow\V2\UpdateEntityTypeRequest;

/**
 * @param string $entityTypeDisplayName The name of the entity type.
 * @param int    $entityTypeKind        Indicates the kind of entity type.
 */
function update_entity_type_sample(string $entityTypeDisplayName, int $entityTypeKind): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $entityType = (new EntityType())
        ->setDisplayName($entityTypeDisplayName)
        ->setKind($entityTypeKind);
    $request = (new UpdateEntityTypeRequest())
        ->setEntityType($entityType);

    // Call the API and handle any network failures.
    try {
        /** @var EntityType $response */
        $response = $entityTypesClient->updateEntityType($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $entityTypeDisplayName = '[DISPLAY_NAME]';
    $entityTypeKind = Kind::KIND_UNSPECIFIED;

    update_entity_type_sample($entityTypeDisplayName, $entityTypeKind);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Location\GetLocationRequest;
use Google\Cloud\Location\Location;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function get_location_sample(): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = new GetLocationRequest();

    // Call the API and handle any network failures.
    try {
        /** @var Location $response */
        $response = $entityTypesClient->getLocation($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Dialogflow\V2\Client\EntityTypesClient;
use Google\Cloud\Location\ListLocationsRequest;
use Google\Cloud\Location\Location;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function list_locations_sample(): void
{
    // Create a client.
    $entityTypesClient = new EntityTypesClient();

    // Prepare the request message.
    $request = new ListLocationsRequest();

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $entityTypesClient->listLocations($request);

        /** @var Location $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}