Konfiguracja

Biblioteka klienta w języku PHP interfejsu Google Ads API udostępnia kilka ustawień konfiguracji, których można użyć do dostosowania działania biblioteki.

Plik konfiguracji

Większość z tych ustawień konfiguracji możesz zapisać w ini i używać ich przy tworzeniu instancji klientów, na przykład google_ads_php.ini

Dane logowania i kreatory klientów udostępniają metody fromFile do wczytywania ustawienia z takich plików:

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

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

Jeśli nie podano ścieżki pliku konfiguracji jako argument, fromFile wczytywane są metody z domyślnej ścieżki pliku konfiguracji, która jest:

1. Wartość zmiennej środowiskowej o nazwie GOOGLE_ADS_CONFIGURATION_FILE_PATH, jeśli jest ustawione.
2. W przeciwnym razie plik google_ads_php.ini w katalogu HOME.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

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

Konfiguracja dynamiczna

Te ustawienia konfiguracji możesz wprowadzać dynamicznie podczas tworzenia instancji klientów.

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

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

Zmienne środowiskowe konfiguracji

Niektóre ustawienia konfiguracji za pomocą zmiennych środowiskowych możesz zmienić, tworzenia instancji klientów (zobacz pełne ).

Zarówno kreatory danych logowania, jak i kreatory klientów zapewniają fromEnvironmentVariables metody wczytywania ustawień ze zmiennych środowiskowych:

Uwaga: nieskonfigurowane zmienne środowiskowe nie są brane pod uwagę.

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

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

Pola konfiguracji

Uwaga: pola grpcChannelCredential, unaryMiddlewares, Nie można ustawić pozycji streamingMiddlewares i grpcInterceptors z poziomu konfiguracji pliku lub ciągu tekstowego, ale tylko dynamicznie.

Ustawienia konfiguracji obsługują kilka pól uporządkowanych według kategorii.

1. Pola używane przez grupę OAuth2TokenBuilder:
   • Tryb aplikacji
     • [OAUTH2] clientId: identyfikator klienta OAuth2.
     • [OAUTH2] clientSecret: tajny klucz klienta OAuth2.
     • [OAUTH2] refreshToken: token odświeżania OAuth2.
   • Tryb konta usługi
     • [OAUTH2] jsonKeyFilePath: ścieżka pliku klucza JSON.
     • [OAUTH2] scopes: zakresy.
     • [OAUTH2] impersonatedEmail: adres e-mail, pod który chcesz się podszywać.
2. Pola używane przez grupę GoogleAdsClientBuilder:
   • [GOOGLE_ADS] developerToken: token programisty pozwalający na dostęp do interfejsu API.
   • [GOOGLE_ADS] loginCustomerId: identyfikator autoryzowanego sprzedawcy klienta do wykorzystania w żądaniu.
   • [GOOGLE_ADS] linkedCustomerId: identyfikator połączonego klienta.
   • [LOGGING] logFilePath: ścieżka pliku logowania.
   • [LOGGING] logLevel: poziom rejestrowania.
   • [CONNECTION] proxy: adres URL serwera proxy używanego do połączenia z internetem.
   • [CONNECTION] transport: transport.
   • [CONNECTION] grpcChannelIsSecure: określa, czy kanał gRPC jest bezpieczny Nie.
   • [CONNECTION] grpcChannelCredential: dane logowania do kanału gRPC.
   • [CONNECTION] unaryMiddlewares: jednoargumentowe elementy pośredniczące.
   • [CONNECTION] streamingMiddlewares: elementy pośredniczące do strumieniowego przesyłania danych.
   • [CONNECTION] grpcInterceptors: elementy przechwytujące gRPC.
3. [GAPIC] useGapicV2Source: określa, czy należy użyć źródła GAPIC w wersji 2 kodu podczas tworzenia klientów usługi.

Sprawdzanie poprawności konfiguracji

Ustawienia konfiguracji są sprawdzane podczas tworzenia instancji klientów i wyjątków , jeśli są nieprawidłowe. Oto reguły:

1. Pola [OAUTH2] nie mogą być ustawione zarówno dla trybu aplikacji, jak i usługi tryb konta.
2. Jeśli używasz parametru [OAUTH2] jsonKeyFilePath i [OAUTH2] scopes, musisz ustawić jego wartość tryb konta usługi.
3. [OAUTH2] clientId, [OAUTH2] clientSecret i [OAUTH2] refreshToken muszą ustawiony w trybie aplikacji.
4. Pole [GOOGLE_ADS] developerToken musi być zawsze ustawione.
5. Jeśli są ustawione, [GOOGLE_ADS] loginCustomerId i [GOOGLE_ADS] linkedCustomerId muszą być liczbami dodatnimi.
6. Jeśli jest ustawiony, [CONNECTION] proxy musi być prawidłowym adresem URL (patrz filtr) FILTER_VALIDATE_URL).
7. Jeśli jest ustawiony, [LOGGING] logLevel musi być prawidłowym logem PSR poziom w wielkie litery, na przykład INFO.
8. Jeśli jest ustawiona, [CONNECTION] transport musi mieć wartość grpc lub rest.
9. Jeśli zasada [CONNECTION] transport ma wartość grpc, transport gRPC musi być obsługiwane przez środowisko (patrz przewodnik po transporcie).
10. Wartość [CONNECTION] grpcChannelIsSecure musi mieć wartość true, gdy [CONNECTION] transport nie ma wartości grpc.
11. Pole [CONNECTION] grpcChannelCredential można ustawić tylko wtedy, gdy zasada [CONNECTION] transport ma wartość grpc.
12. Wartość [CONNECTION] grpcChannelCredential można ustawić tylko wtedy, gdy pole [CONNECTION] grpcChannelIsSecure ma wartość true.