Google Cloud Retail V2 Client - Class CatalogServiceClient (1.0.1)

use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\AttributesConfig;
use Google\Cloud\Retail\V2\CatalogAttribute;
use Google\Cloud\Retail\V2\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.
 */
function add_catalog_attribute_sample(
    string $formattedAttributesConfig,
    string $catalogAttributeKey
): void {
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $catalogAttribute = (new CatalogAttribute())
        ->setKey($catalogAttributeKey);

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

/**
 * 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\CatalogServiceClient;

/**
 * @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();

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

/**
 * 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\CatalogServiceClient;
use Google\Cloud\Retail\V2\CompletionConfig;

/**
 * @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();

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

/**
 * 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\CatalogServiceClient;
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();

    // Call the API and handle any network failures.
    try {
        /** @var GetDefaultBranchResponse $response */
        $response = $catalogServiceClient->getDefaultBranch();
        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\CatalogServiceClient;

/**
 * @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();

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

        /** @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());
    }
}

/**
 * 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\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 $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();

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

/**
 * 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\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.
 */
function replace_catalog_attribute_sample(
    string $formattedAttributesConfig,
    string $catalogAttributeKey
): void {
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $catalogAttribute = (new CatalogAttribute())
        ->setKey($catalogAttributeKey);

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

/**
 * 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\CatalogServiceClient;

/**
 * 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();

    // Call the API and handle any network failures.
    try {
        $catalogServiceClient->setDefaultBranch();
        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\CatalogServiceClient;

/**
 * @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 any non-scalar elements to be passed along with the request.
    $attributesConfig = (new AttributesConfig())
        ->setName($attributesConfigName);

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

/**
 * 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\CatalogServiceClient;
use Google\Cloud\Retail\V2\ProductLevelConfig;

/**
 * @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 any non-scalar elements to be passed along with the request.
    $catalogProductLevelConfig = new ProductLevelConfig();
    $catalog = (new Catalog())
        ->setName($catalogName)
        ->setDisplayName($catalogDisplayName)
        ->setProductLevelConfig($catalogProductLevelConfig);

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

/**
 * 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\CatalogServiceClient;
use Google\Cloud\Retail\V2\CompletionConfig;

/**
 * @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 any non-scalar elements to be passed along with the request.
    $completionConfig = (new CompletionConfig())
        ->setName($completionConfigName);

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

/**
 * 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);
}