Configurazione

La libreria client PHP dell'API Google Ads fornisce diverse impostazioni di configurazione che puoi utilizzare per personalizzare il comportamento della libreria.

File di configurazione

Puoi archiviare la maggior parte di queste impostazioni di configurazione in Puoi archiviare la maggior parte di queste impostazioni di configurazione in ini file e utilizzarli quando crei un'istanza dei client, ad esempio, google_ads_php.ini.

I generatori di credenziali e client forniscono entrambi metodi fromFile per caricare le impostazioni da questi file:

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

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

Se non viene fornito alcun percorso di configurazione come argomento, i metodi fromFile vengono caricati dal percorso di configurazione predefinito, ovvero:

  1. Il valore della variabile di ambiente denominata GOOGLE_ADS_CONFIGURATION_FILE_PATH, se impostata.
  2. In caso contrario, il file google_ads_php.ini nella directory HOME.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

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

Configurazione dinamica

Puoi impostare queste impostazioni di configurazione in modo dinamico quando crei un'istanza dei client.

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

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

Variabili di ambiente di configurazione

Puoi impostare alcune delle impostazioni di configurazione dalle variabili di ambiente quando crei un'istanza dei client (vedi l'elenco esaustivo).

I generatori di credenziali e client forniscono entrambi metodi fromEnvironmentVariables per caricare le impostazioni dalle variabili di ambiente:

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

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

Campi di configurazione

Le impostazioni di configurazione supportano diversi campi organizzati in categorie.

  1. Campi utilizzati da OAuth2TokenBuilder:
    • Modalità applicazione
      • [OAUTH2] clientId: il tuo ID client OAuth2.
      • [OAUTH2] clientSecret: il tuo secret client OAuth2.
      • [OAUTH2] refreshToken: il tuo token di aggiornamento OAuth2.
    • Modalità account di servizio
      • [OAUTH2] jsonKeyFilePath: il percorso della chiave JSON.
      • [OAUTH2] scopes: gli ambiti.
      • [OAUTH2] impersonatedEmail: l'indirizzo email da rappresentare.
  2. Campi utilizzati da GoogleAdsClientBuilder:
    • [GOOGLE_ADS] loginCustomerId: l'ID del cliente autorizzato da utilizzare nella richiesta.
    • [GOOGLE_ADS] linkedCustomerId: l'ID cliente collegato.
    • [LOGGING] logFilePath: il percorso per la registrazione.
    • [LOGGING] logLevel: il livello di logging.
    • [CONNECTION] proxy: l'URL del server proxy utilizzato per la connettività internet.
    • [CONNECTION] transport: il trasporto.
    • [CONNECTION] grpcChannelIsSecure: indica se il canale gRPC è sicuro o meno.
    • [CONNECTION] grpcChannelCredential: le credenziali del canale gRPC.
    • [CONNECTION] unaryMiddlewares: i middleware unitari.
    • [CONNECTION] streamingMiddlewares: i middleware di streaming.
    • [CONNECTION] grpcInterceptors: gli intercettori gRPC.

Convalida della configurazione

Le impostazioni di configurazione vengono controllate quando crei un'istanza dei client e vengono generate eccezioni quando non sono valide. Ecco le regole:

  1. I campi [OAUTH2] non devono essere impostati contemporaneamente per la modalità applicazione e la modalità account di servizio.
  2. [OAUTH2] jsonKeyFilePath e [OAUTH2] scopes devono essere impostati quando si utilizza la modalità account di servizio.
  3. [OAUTH2] clientId, [OAUTH2] clientSecret e [OAUTH2] refreshToken devono essere impostati quando si utilizza la modalità applicazione.
  4. Se impostati, [GOOGLE_ADS] loginCustomerId e [GOOGLE_ADS] linkedCustomerId devono essere numeri positivi.
  5. Se impostato, [CONNECTION] proxy deve essere un URL valido (vedi filtro FILTER_VALIDATE_URL).
  6. Se impostato, [LOGGING] logLevel deve essere un valido livello di log PSR in lettere maiuscole, ad esempio INFO.
  7. Se impostato, [CONNECTION] transport deve essere grpc o rest.
  8. Se [CONNECTION] transport è impostato su grpc, il trasporto gRPC deve essere supportato dall'ambiente (vedi la guida al trasporto).
  9. [CONNECTION] grpcChannelIsSecure deve essere true quando [CONNECTION] transport non è impostato su grpc.
  10. [CONNECTION] grpcChannelCredential può essere impostato solo quando [CONNECTION] transport è impostato su grpc.
  11. [CONNECTION] grpcChannelCredential può essere impostato solo quando [CONNECTION] grpcChannelIsSecure è true.