Google Cloud Retail V2 Client - Class CatalogServiceClient (2.1.0)

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AddCatalogAttributeRequest;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\CatalogAttribute;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;

/**
 * @param string $formattedAttributesConfig Full AttributesConfig resource name. Format:
 *                                          `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
 *                                          Please see {@see CatalogServiceClient::attributesConfigName()} for help formatting this field.
 * @param string $catalogAttributeKey       Attribute name.
 *                                          For example: `color`, `brands`, `attributes.custom_attribute`, such as
 *                                          `attributes.xyz`.
 *                                          To be indexable, the attribute name can contain only alpha-numeric
 *                                          characters and underscores. For example, an attribute named
 *                                          `attributes.abc_xyz` can be indexed, but an attribute named
 *                                          `attributes.abc-xyz` cannot be indexed.
 *
 *                                          If the attribute key starts with `attributes.`, then the attribute is a
 *                                          custom attribute. Attributes such as `brands`, `patterns`, and `title` are
 *                                          built-in and called system attributes.
 */
function add_catalog_attribute_sample(
    string $formattedAttributesConfig,
    string $catalogAttributeKey
): void {
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $catalogAttribute = (new CatalogAttribute())
        ->setKey($catalogAttributeKey);
    $request = (new AddCatalogAttributeRequest())
        ->setAttributesConfig($formattedAttributesConfig)
        ->setCatalogAttribute($catalogAttribute);

    // Call the API and handle any network failures.
    try {
        /** @var AttributesConfig $response */
        $response = $catalogServiceClient->addCatalogAttribute($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
{
    $formattedAttributesConfig = CatalogServiceClient::attributesConfigName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]'
    );
    $catalogAttributeKey = '[KEY]';

    add_catalog_attribute_sample($formattedAttributesConfig, $catalogAttributeKey);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\GetAttributesConfigRequest;

/**
 * @param string $formattedName Full AttributesConfig resource name. Format:
 *                              `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
 *                              Please see {@see CatalogServiceClient::attributesConfigName()} for help formatting this field.
 */
function get_attributes_config_sample(string $formattedName): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var AttributesConfig $response */
        $response = $catalogServiceClient->getAttributesConfig($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 = CatalogServiceClient::attributesConfigName('[PROJECT]', '[LOCATION]', '[CATALOG]');

    get_attributes_config_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\CompletionConfig;
use Google\Cloud\Retail\V2\GetCompletionConfigRequest;

/**
 * @param string $formattedName Full CompletionConfig resource name. Format:
 *                              `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
 *                              Please see {@see CatalogServiceClient::completionConfigName()} for help formatting this field.
 */
function get_completion_config_sample(string $formattedName): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var CompletionConfig $response */
        $response = $catalogServiceClient->getCompletionConfig($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 = CatalogServiceClient::completionConfigName('[PROJECT]', '[LOCATION]', '[CATALOG]');

    get_completion_config_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\GetDefaultBranchRequest;
use Google\Cloud\Retail\V2\GetDefaultBranchResponse;

/**
 * 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_default_branch_sample(): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var GetDefaultBranchResponse $response */
        $response = $catalogServiceClient->getDefaultBranch($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\Retail\V2\Catalog;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\ListCatalogsRequest;

/**
 * @param string $formattedParent The account resource name with an associated location.
 *
 *                                If the caller does not have permission to list
 *                                [Catalog][google.cloud.retail.v2.Catalog]s under this location, regardless
 *                                of whether or not this location exists, a PERMISSION_DENIED error is
 *                                returned. Please see
 *                                {@see CatalogServiceClient::locationName()} for help formatting this field.
 */
function list_catalogs_sample(string $formattedParent): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

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

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

        /** @var Catalog $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 = CatalogServiceClient::locationName('[PROJECT]', '[LOCATION]');

    list_catalogs_sample($formattedParent);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\RemoveCatalogAttributeRequest;

/**
 * @param string $formattedAttributesConfig Full AttributesConfig resource name. Format:
 *                                          `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
 *                                          Please see {@see CatalogServiceClient::attributesConfigName()} for help formatting this field.
 * @param string $key                       The attribute name key of the
 *                                          [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute] to remove.
 */
function remove_catalog_attribute_sample(string $formattedAttributesConfig, string $key): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $request = (new RemoveCatalogAttributeRequest())
        ->setAttributesConfig($formattedAttributesConfig)
        ->setKey($key);

    // Call the API and handle any network failures.
    try {
        /** @var AttributesConfig $response */
        $response = $catalogServiceClient->removeCatalogAttribute($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
{
    $formattedAttributesConfig = CatalogServiceClient::attributesConfigName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]'
    );
    $key = '[KEY]';

    remove_catalog_attribute_sample($formattedAttributesConfig, $key);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\CatalogAttribute;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\ReplaceCatalogAttributeRequest;

/**
 * @param string $formattedAttributesConfig Full AttributesConfig resource name. Format:
 *                                          `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
 *                                          Please see {@see CatalogServiceClient::attributesConfigName()} for help formatting this field.
 * @param string $catalogAttributeKey       Attribute name.
 *                                          For example: `color`, `brands`, `attributes.custom_attribute`, such as
 *                                          `attributes.xyz`.
 *                                          To be indexable, the attribute name can contain only alpha-numeric
 *                                          characters and underscores. For example, an attribute named
 *                                          `attributes.abc_xyz` can be indexed, but an attribute named
 *                                          `attributes.abc-xyz` cannot be indexed.
 *
 *                                          If the attribute key starts with `attributes.`, then the attribute is a
 *                                          custom attribute. Attributes such as `brands`, `patterns`, and `title` are
 *                                          built-in and called system attributes.
 */
function replace_catalog_attribute_sample(
    string $formattedAttributesConfig,
    string $catalogAttributeKey
): void {
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $catalogAttribute = (new CatalogAttribute())
        ->setKey($catalogAttributeKey);
    $request = (new ReplaceCatalogAttributeRequest())
        ->setAttributesConfig($formattedAttributesConfig)
        ->setCatalogAttribute($catalogAttribute);

    // Call the API and handle any network failures.
    try {
        /** @var AttributesConfig $response */
        $response = $catalogServiceClient->replaceCatalogAttribute($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
{
    $formattedAttributesConfig = CatalogServiceClient::attributesConfigName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]'
    );
    $catalogAttributeKey = '[KEY]';

    replace_catalog_attribute_sample($formattedAttributesConfig, $catalogAttributeKey);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\SetDefaultBranchRequest;

/**
 * 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 set_default_branch_sample(): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

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

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

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\UpdateAttributesConfigRequest;

/**
 * @param string $attributesConfigName Immutable. The fully qualified resource name of the attribute
 *                                     config. Format: `projects/*/locations/*/catalogs/*/attributesConfig`
 */
function update_attributes_config_sample(string $attributesConfigName): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $attributesConfig = (new AttributesConfig())
        ->setName($attributesConfigName);
    $request = (new UpdateAttributesConfigRequest())
        ->setAttributesConfig($attributesConfig);

    // Call the API and handle any network failures.
    try {
        /** @var AttributesConfig $response */
        $response = $catalogServiceClient->updateAttributesConfig($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
{
    $attributesConfigName = '[NAME]';

    update_attributes_config_sample($attributesConfigName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Catalog;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\ProductLevelConfig;
use Google\Cloud\Retail\V2\UpdateCatalogRequest;

/**
 * @param string $catalogName        Immutable. The fully qualified resource name of the catalog.
 * @param string $catalogDisplayName Immutable. The catalog display name.
 *
 *                                   This field must be a UTF-8 encoded string with a length limit of 128
 *                                   characters. Otherwise, an INVALID_ARGUMENT error is returned.
 */
function update_catalog_sample(string $catalogName, string $catalogDisplayName): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $catalogProductLevelConfig = new ProductLevelConfig();
    $catalog = (new Catalog())
        ->setName($catalogName)
        ->setDisplayName($catalogDisplayName)
        ->setProductLevelConfig($catalogProductLevelConfig);
    $request = (new UpdateCatalogRequest())
        ->setCatalog($catalog);

    // Call the API and handle any network failures.
    try {
        /** @var Catalog $response */
        $response = $catalogServiceClient->updateCatalog($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
{
    $catalogName = '[NAME]';
    $catalogDisplayName = '[DISPLAY_NAME]';

    update_catalog_sample($catalogName, $catalogDisplayName);
}

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Client\CatalogServiceClient;
use Google\Cloud\Retail\V2\CompletionConfig;
use Google\Cloud\Retail\V2\UpdateCompletionConfigRequest;

/**
 * @param string $completionConfigName Immutable. Fully qualified name
 *                                     `projects/*/locations/*/catalogs/*/completionConfig`
 */
function update_completion_config_sample(string $completionConfigName): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $completionConfig = (new CompletionConfig())
        ->setName($completionConfigName);
    $request = (new UpdateCompletionConfigRequest())
        ->setCompletionConfig($completionConfig);

    // Call the API and handle any network failures.
    try {
        /** @var CompletionConfig $response */
        $response = $catalogServiceClient->updateCompletionConfig($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
{
    $completionConfigName = '[NAME]';

    update_completion_config_sample($completionConfigName);
}