Yapılandırma

Google Ads API PHP istemci kitaplığı, kullanacağınız çeşitli yapılandırma ayarlarını sunar. kullanabileceğiniz bir komut dosyasıdır.

Yapılandırma dosyası

Bu yapılandırma ayarlarının çoğunu ini dosyaları kullanır ve bunları, örneğin istemciler için örnek google_ads_php.ini.

Hem kimlik bilgisi hem de istemci oluşturucular, fromFile yükleme yöntemi sunar ayarlarını yapabilirsiniz:

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

Bağımsız değişken olarak bir yapılandırma dosyası yolu sağlanmadıysa fromFile yöntemler, varsayılan yapılandırma dosyası yolundan yüklenir:

  1. Adlandırılmış ortam değişkeninin değeri Ayarlanmışsa GOOGLE_ADS_CONFIGURATION_FILE_PATH.
  2. Aksi halde HOME dizininizdeki google_ads_php.ini dosyası.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

Dinamik yapılandırma

İstemci örnekleri oluştururken bu yapılandırma ayarlarını dinamik olarak ayarlayabilirsiniz.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->withClientId('INSERT_CLIENT_ID')
    // ...
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    ->withDeveloperToken('INSERT_DEVELOPER_TOKEN_HERE')
    // ...
    ->build();

Yapılandırma ortamı değişkenleri

Şu durumlarda ortam değişkenlerinden bazı yapılandırma ayarlarını örnek oluşturma (ayrıntılı listesi) görürsünüz.

Hem kimlik bilgisi hem de istemci oluşturucular fromEnvironmentVariables sağlar yöntemlerinden birini çağırın:

$oAuth2Credential = (new OAuth2TokenBuilder())
    // ...
    ->fromEnvironmentVariables()
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    // ...
    ->fromEnvironmentVariables()
    ->build();

Yapılandırma alanları

Yapılandırma ayarları, kategoriler halinde düzenlenmiş çeşitli alanları destekler.

  1. OAuth2TokenBuilder tarafından kullanılan alanlar:
    • Uygulama Modu
      • [OAUTH2] clientId: OAuth2 istemci kimliğiniz.
      • [OAUTH2] clientSecret: OAuth2 istemci gizli anahtarınız.
      • [OAUTH2] refreshToken: OAuth2 yenileme jetonunuz.
    • Hizmet Hesabı Modu
      • [OAUTH2] jsonKeyFilePath: Json anahtar dosyası yolu.
      • [OAUTH2] scopes: Kapsamlar.
      • [OAUTH2] impersonatedEmail: Kimliğine bürünülecek e-posta adresi.
  2. GoogleAdsClientBuilder tarafından kullanılan alanlar:
    • [GOOGLE_ADS] developerToken: API'ye erişmek için geliştirici jetonunuz.
    • [GOOGLE_ADS] loginCustomerId: Yetkili kullanıcının kimliği müşterinin istek için kullanılabilir.
    • [GOOGLE_ADS] linkedCustomerId: Bağlı müşteri kimliği.
    • [LOGGING] logFilePath: Günlük kaydı dosya yolu.
    • [LOGGING] logLevel: Günlük kaydı düzeyi.
    • [CONNECTION] proxy: İnternet bağlantısı için kullanılan proxy sunucu URL'si.
    • [CONNECTION] transport: Ulaşım.
    • [CONNECTION] grpcChannelIsSecure: gRPC kanalının güvenli olup olmadığı değil.
    • [CONNECTION] grpcChannelCredential: gRPC kanalı kimlik bilgileri.
    • [CONNECTION] unaryMiddlewares: Tekli ara yazılımlar.
    • [CONNECTION] streamingMiddlewares: Akış ara yazılımları.
    • [CONNECTION] grpcInterceptors: gRPC önleyicileri.
  3. [GAPIC] useGapicV2Source: GAPIC v2 kaynağının kullanılıp kullanılmayacağı kodunu kullanın.

Yapılandırma doğrulaması

İstemciler ve istisnalar oluşturulurken yapılandırma ayarları kontrol edilir geçersiz olduğunda atılır. Kurallar şunlardır:

  1. [OAUTH2] alanları hem Uygulama Modu hem de Hizmet için ayarlanmamalıdır aynı anda Hesap Modu'nu kullanabilirsiniz.
  2. Kullanılırken [OAUTH2] jsonKeyFilePath ve [OAUTH2] scopes ayarlanmalıdır arasında geçiş yapacaktır.
  3. [OAUTH2] clientId, [OAUTH2] clientSecret ve [OAUTH2] refreshToken Uygulama Modu kullanılırken ayarlanabilir.
  4. [GOOGLE_ADS] developerToken her zaman ayarlanmalıdır.
  5. Ayarlanırsa [GOOGLE_ADS] loginCustomerId ve [GOOGLE_ADS] linkedCustomerId pozitif sayı olmalıdır.
  6. Ayarlanırsa [CONNECTION] proxy geçerli bir URL olmalıdır (filtreye bakın) FILTER_VALIDATE_URL).
  7. Ayarlanırsa [LOGGING] logLevel, geçerli bir PSR günlüğü olmalıdır seviye: büyük harfler (ör. INFO).
  8. Ayarlanırsa [CONNECTION] transport, grpc veya rest olmalıdır.
  9. [CONNECTION] transport, grpc olarak ayarlanırsa gRPC aktarımı tarafından desteklenir (kılavuz aktarımına bakın).
  10. [CONNECTION] transport, grpc olarak ayarlanmadığında [CONNECTION] grpcChannelIsSecure, true olmalıdır.
  11. [CONNECTION] grpcChannelCredential yalnızca [CONNECTION] transport, grpc olarak ayarlandığında ayarlanabilir.
  12. [CONNECTION] grpcChannelCredential yalnızca [CONNECTION] grpcChannelIsSecure, true olduğunda ayarlanabilir.