Temel kullanım

İstemci kitaplığının temel kullanımı aşağıdaki gibidir:

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 örneği oluşturma

Google Ads API PHP kitaplığındaki en önemli sınıf, GoogleAdsClient sınıfıdır. API çağrıları yapmak için kullanılabilecek önceden yapılandırılmış hizmet istemcisi nesneleri oluşturmanıza olanak tanır. GoogleAdsClient, onu başlatmak için çeşitli yöntemler sunar:

• google_ads_php.ini dosyası kullanın.
• Ortam değişkenlerini kullanma
• GoogleAdsClientBuilder üzerinde ayarlayıcıları kullanma.

Daha fazla bilgi edinmek için Yapılandırma kılavuzu'na bakın.

Bir GoogleAdsClient nesnesini yapılandırmak için bir OAuth2TokenBuilder nesnesi ve bir GoogleAdsClientBuilder nesnesi oluşturup gerekli ayarları yapın:

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

Hizmet oluştur

GoogleAdsClient, her hizmet istemci nesnesi için bir alıcı yöntemi sağlar. Örneğin, CampaignServiceClient örneği oluşturmak için önceki örnekte gösterildiği gibi GoogleAdsClient->getCampaignServiceClient() yöntemini çağırın.

Hata işleme

Her API çağrısı başarılı olmaz. API çağrılarınız herhangi bir nedenle başarısız olursa sunucu hata verebilir. API hatalarını yakalamak ve uygun şekilde ele almak önemlidir.

Bir API hatası oluştuğunda GoogleAdsException örneği oluşturulur. Bu mesajda, sorunun ne olduğunu anlamanıza yardımcı olacak ayrıntılar yer alır:

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