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 nei file di ini
e utilizzarle per creare un'istanza dei client, ad esempio google_ads_php.ini
.
Entrambi gli strumenti di creazione di credenziali e client forniscono 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 è stato fornito un percorso del file di configurazione come argomento, i metodi fromFile
vengono caricati dal percorso del file di configurazione predefinito, ovvero:
- Il valore della variabile di ambiente denominata
GOOGLE_ADS_CONFIGURATION_FILE_PATH
, se impostata. - In caso contrario, il file
google_ads_php.ini
nella directoryHOME
.
$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 l'istanza dei client.
$oAuth2Credential = (new OAuth2TokenBuilder())
->withClientId('INSERT_CLIENT_ID')
// ...
->build();
$googleAdsClient = (new GoogleAdsClientBuilder())
->withOAuth2Credential($oAuth2Credential)
->withDeveloperToken('INSERT_DEVELOPER_TOKEN_HERE')
// ...
->build();
Variabili di ambiente di configurazione
Puoi impostare alcune delle impostazioni di configurazione dalle variabili di ambiente durante l'identificazione dei client (consulta l'elenco completo).
Entrambi gli strumenti per la creazione di credenziali e client forniscono fromEnvironmentVariables
metodi 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.
- Campi utilizzati da
OAuth2TokenBuilder
:- Modalità applicazione
[OAUTH2] clientId
: il tuo ID client OAuth2.[OAUTH2] clientSecret
: il tuo client secret OAuth2.[OAUTH2] refreshToken
: il tuo token di aggiornamento OAuth2.
- Modalità account di servizio
[OAUTH2] jsonKeyFilePath
: il percorso del file della chiave JSON.[OAUTH2] scopes
: gli ambiti.[OAUTH2] impersonatedEmail
: l'email di cui vuoi rubare l'identità.
- Modalità applicazione
- Campi utilizzati da
GoogleAdsClientBuilder
:[GOOGLE_ADS] developerToken
: il tuo token sviluppatore per accedere all'API.[GOOGLE_ADS] loginCustomerId
: l'ID del cliente autorizzato da utilizzare nella richiesta.[GOOGLE_ADS] linkedCustomerId
: l'ID cliente collegato.[LOGGING] logFilePath
: il percorso del file per il logging.[LOGGING] logLevel
: il livello di logging.[CONNECTION] proxy
: l'URL del server proxy utilizzato per la connettività a internet.[CONNECTION] transport
: il trasporto.[CONNECTION] grpcChannelIsSecure
: se il canale gRPC è sicuro o meno.[CONNECTION] grpcChannelCredential
: le credenziali del canale gRPC.[CONNECTION] unaryMiddlewares
: i middleware unari.[CONNECTION] streamingMiddlewares
: i middleware per lo streaming.[CONNECTION] grpcInterceptors
: gli intercetti gRPC.
[GAPIC] useGapicV2Source
: se utilizzare il codice sorgente GAPIC v2 durante la creazione dei client di servizio.
Convalida della configurazione
Le impostazioni di configurazione vengono controllate quando si creano istanze di client ed eccezioni quando non sono validi. Ecco le regole:
- I campi
[OAUTH2]
non devono essere impostati contemporaneamente per la Modalità applicazione e la Modalità Account di servizio. [OAUTH2] jsonKeyFilePath
e[OAUTH2] scopes
devono essere impostati quando si utilizza la modalità account di servizio.- Durante l'utilizzo della modalità applicazione è necessario
impostare
[OAUTH2] clientId
,[OAUTH2] clientSecret
e[OAUTH2] refreshToken
. [GOOGLE_ADS] developerToken
deve essere sempre impostato.- Se impostato,
[GOOGLE_ADS] loginCustomerId
e[GOOGLE_ADS] linkedCustomerId
devono essere numeri positivi. - Se impostato,
[CONNECTION] proxy
deve essere un URL valido (vedi filtro FILTER_VALIDATE_URL). - Se impostato,
[LOGGING] logLevel
deve essere un livello di log PSR valido in lettere maiuscole, ad esempioINFO
. - Se impostato,
[CONNECTION] transport
deve esseregrpc
orest
. - Se
[CONNECTION] transport
è impostato sugrpc
, il trasporto gRPC deve essere supportato dall'ambiente (consulta la guida sul trasporto). [CONNECTION] grpcChannelIsSecure
deve esseretrue
quando[CONNECTION] transport
non è impostato sugrpc
.[CONNECTION] grpcChannelCredential
può essere impostato solo quando il criterio[CONNECTION] transport
è impostato sugrpc
.[CONNECTION] grpcChannelCredential
può essere impostato solo quando il valore di[CONNECTION] grpcChannelIsSecure
ètrue
.