Google Shopping Merchant Accounts V1beta Client - Class AccountsServiceClient (0.2.0)

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1beta\Account;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\CreateAndConfigureAccountRequest;
use Google\Shopping\Merchant\Accounts\V1beta\CreateAndConfigureAccountRequest\AddAccountService;
use Google\Type\TimeZone;

/**
 * @param string $accountAccountName  A human-readable name of the account. See
 *                                    [store name](https://support.google.com/merchants/answer/160556) and
 *                                    [business name](https://support.google.com/merchants/answer/12159159) for
 *                                    more information.
 * @param string $accountLanguageCode The account's [BCP-47 language
 *                                    code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
 */
function create_and_configure_account_sample(
    string $accountAccountName,
    string $accountLanguageCode
): void {
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

    // Prepare the request message.
    $accountTimeZone = new TimeZone();
    $account = (new Account())
        ->setAccountName($accountAccountName)
        ->setTimeZone($accountTimeZone)
        ->setLanguageCode($accountLanguageCode);
    $service = [new AddAccountService()];
    $request = (new CreateAndConfigureAccountRequest())
        ->setAccount($account)
        ->setService($service);

    // Call the API and handle any network failures.
    try {
        /** @var Account $response */
        $response = $accountsServiceClient->createAndConfigureAccount($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
{
    $accountAccountName = '[ACCOUNT_NAME]';
    $accountLanguageCode = '[LANGUAGE_CODE]';

    create_and_configure_account_sample($accountAccountName, $accountLanguageCode);
}

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\DeleteAccountRequest;

/**
 * @param string $formattedName The name of the account to delete.
 *                              Format: `accounts/{account}`
 *                              Please see {@see AccountsServiceClient::accountName()} for help formatting this field.
 */
function delete_account_sample(string $formattedName): void
{
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

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

    // Call the API and handle any network failures.
    try {
        $accountsServiceClient->deleteAccount($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 = AccountsServiceClient::accountName('[ACCOUNT]');

    delete_account_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\Shopping\Merchant\Accounts\V1beta\Account;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\GetAccountRequest;

/**
 * @param string $formattedName The name of the account to retrieve.
 *                              Format: `accounts/{account}`
 *                              Please see {@see AccountsServiceClient::accountName()} for help formatting this field.
 */
function get_account_sample(string $formattedName): void
{
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Account $response */
        $response = $accountsServiceClient->getAccount($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 = AccountsServiceClient::accountName('[ACCOUNT]');

    get_account_sample($formattedName);
}

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Shopping\Merchant\Accounts\V1beta\Account;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\ListAccountsRequest;

/**
 * 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_accounts_sample(): void
{
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

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

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

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

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Shopping\Merchant\Accounts\V1beta\Account;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\ListSubAccountsRequest;

/**
 * @param string $formattedProvider The parent account.
 *                                  Format: `accounts/{account}`
 *                                  Please see {@see AccountsServiceClient::accountName()} for help formatting this field.
 */
function list_sub_accounts_sample(string $formattedProvider): void
{
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

    // Prepare the request message.
    $request = (new ListSubAccountsRequest())
        ->setProvider($formattedProvider);

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

        /** @var Account $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
{
    $formattedProvider = AccountsServiceClient::accountName('[ACCOUNT]');

    list_sub_accounts_sample($formattedProvider);
}

use Google\ApiCore\ApiException;
use Google\Protobuf\FieldMask;
use Google\Shopping\Merchant\Accounts\V1beta\Account;
use Google\Shopping\Merchant\Accounts\V1beta\Client\AccountsServiceClient;
use Google\Shopping\Merchant\Accounts\V1beta\UpdateAccountRequest;
use Google\Type\TimeZone;

/**
 * @param string $accountAccountName  A human-readable name of the account. See
 *                                    [store name](https://support.google.com/merchants/answer/160556) and
 *                                    [business name](https://support.google.com/merchants/answer/12159159) for
 *                                    more information.
 * @param string $accountLanguageCode The account's [BCP-47 language
 *                                    code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`.
 */
function update_account_sample(string $accountAccountName, string $accountLanguageCode): void
{
    // Create a client.
    $accountsServiceClient = new AccountsServiceClient();

    // Prepare the request message.
    $accountTimeZone = new TimeZone();
    $account = (new Account())
        ->setAccountName($accountAccountName)
        ->setTimeZone($accountTimeZone)
        ->setLanguageCode($accountLanguageCode);
    $updateMask = new FieldMask();
    $request = (new UpdateAccountRequest())
        ->setAccount($account)
        ->setUpdateMask($updateMask);

    // Call the API and handle any network failures.
    try {
        /** @var Account $response */
        $response = $accountsServiceClient->updateAccount($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
{
    $accountAccountName = '[ACCOUNT_NAME]';
    $accountLanguageCode = '[LANGUAGE_CODE]';

    update_account_sample($accountAccountName, $accountLanguageCode);
}