Основное использование

Основное использование клиентской библиотеки выглядит следующим образом:

use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V22\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\ApiCore\ApiException;

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file and the
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

// Create the CampaignServiceClient.
$campaignServiceClient = $googleAdsClient->getCampaignServiceClient();

// Make calls to CampaignServiceClient.

Создайте экземпляр GoogleAdsClient

Наиболее важным классом в PHP-библиотеке Google Ads API является класс GoogleAdsClient . Он позволяет создавать предварительно настроенные объекты клиентских служб, которые можно использовать для выполнения вызовов API. GoogleAdsClient предоставляет различные способы его создания:

• Используйте файл google_ads_php.ini .
• Использование переменных среды.
• Использование сеттеров в GoogleAdsClientBuilder .

Для получения более подробной информации обратитесь к руководству по настройке .

Для настройки объекта GoogleAdsClient создайте объект OAuth2TokenBuilder и объект GoogleAdsClientBuilder и задайте необходимые параметры:

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

Создать сервис

Объект GoogleAdsClient предоставляет метод-геттер для каждого объекта клиента сервиса. Например, чтобы создать экземпляр CampaignServiceClient , вызовите метод GoogleAdsClient->getCampaignServiceClient() , как показано в предыдущем примере.

Обработка ошибок

Не каждый вызов API будет успешным. Сервер может выдавать ошибки, если ваши вызовы API по какой-либо причине завершатся неудачей. Важно перехватывать ошибки API и обрабатывать их соответствующим образом.

При возникновении ошибки API генерируется исключение GoogleAdsException . Оно содержит подробную информацию, которая поможет вам разобраться, что пошло не так:

use Google\Ads\GoogleAds\Lib\V22\GoogleAdsException;
use Google\ApiCore\ApiException;

try {
    // Make your API call here.
} catch (GoogleAdsException $googleAdsException) {
    printf(
        "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
        $googleAdsException->getRequestId(),
        PHP_EOL,
        PHP_EOL
    );
    foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) {
        printf(
            "\t%s: %s%s",
            $error->getErrorCode()->getErrorCode(),
            $error->getMessage(),
            PHP_EOL
        );
    }
} catch (ApiException $apiException) {
    printf(
        "ApiException was thrown with message '%s'.%s",
        $apiException->getMessage(),
        PHP_EOL
    );
}