La bibliothèque cliente PHP de l'API Google Ads fournit plusieurs paramètres de configuration que vous pouvez utiliser pour personnaliser le comportement de la bibliothèque.
Fichier de configuration
Vous pouvez stocker la plupart de ces paramètres de configuration dans des fichiers ini
et les utiliser lors de l'instanciation de clients, par exemple google_ads_php.ini
.
Les compilateurs d'identifiants et de clients fournissent tous deux des méthodes fromFile
pour charger des paramètres à partir de ces fichiers:
$oAuth2Credential = (new OAuth2TokenBuilder())
->fromFile('/path/to/google_ads_php.ini')
->build();
$googleAdsClient = (new GoogleAdsClientBuilder())
->fromFile('/path/to/google_ads_php.ini')
->withOAuth2Credential($oAuth2Credential)
->build();
Si aucun chemin d'accès au fichier de configuration n'est fourni en tant qu'argument, les méthodes fromFile
se chargent à partir du chemin d'accès au fichier de configuration par défaut, à savoir:
- Valeur de la variable d'environnement nommée
GOOGLE_ADS_CONFIGURATION_FILE_PATH
si elle est définie. - Sinon, le fichier
google_ads_php.ini
se trouve dans votre répertoireHOME
.
$oAuth2Credential = (new OAuth2TokenBuilder())
->fromFile()
->build();
$googleAdsClient = (new GoogleAdsClientBuilder())
->fromFile()
->withOAuth2Credential($oAuth2Credential)
->build();
Configuration dynamique
Vous pouvez définir ces paramètres de configuration de manière dynamique lors de l'instanciation de clients.
$oAuth2Credential = (new OAuth2TokenBuilder())
->withClientId('INSERT_CLIENT_ID')
// ...
->build();
$googleAdsClient = (new GoogleAdsClientBuilder())
->withOAuth2Credential($oAuth2Credential)
->withDeveloperToken('INSERT_DEVELOPER_TOKEN_HERE')
// ...
->build();
Variables d'environnement de configuration
Vous pouvez définir certains des paramètres de configuration à partir de variables d'environnement lors de l'instanciation de clients (voir la liste exhaustive).
Les compilateurs d'identifiants et de clients fournissent tous deux des méthodes fromEnvironmentVariables
pour charger des paramètres à partir de variables d'environnement:
$oAuth2Credential = (new OAuth2TokenBuilder())
// ...
->fromEnvironmentVariables()
->build();
$googleAdsClient = (new GoogleAdsClientBuilder())
->withOAuth2Credential($oAuth2Credential)
// ...
->fromEnvironmentVariables()
->build();
Champs de configuration
Les paramètres de configuration acceptent plusieurs champs organisés en catégories.
- Champs utilisés par
OAuth2TokenBuilder
:- Mode d'application
[OAUTH2] clientId
: votre ID client OAuth2.[OAUTH2] clientSecret
: code secret de votre client OAuth2.[OAUTH2] refreshToken
: votre jeton d'actualisation OAuth2.
- Mode Compte de service
[OAUTH2] jsonKeyFilePath
: chemin d'accès au fichier de clé JSON.[OAUTH2] scopes
: champs d'application.[OAUTH2] impersonatedEmail
: adresse e-mail dont l'identité doit être empruntée.
- Mode d'application
- Champs utilisés par
GoogleAdsClientBuilder
:[GOOGLE_ADS] developerToken
: votre jeton de développeur pour accéder à l'API.[GOOGLE_ADS] loginCustomerId
: ID du client autorisé à utiliser dans la requête.[GOOGLE_ADS] linkedCustomerId
: numéro client associé.[LOGGING] logFilePath
: chemin d'accès au fichier de journalisation.[LOGGING] logLevel
: niveau de journalisation[CONNECTION] proxy
: URL du serveur proxy utilisée pour la connectivité Internet.[CONNECTION] transport
: transport.[CONNECTION] grpcChannelIsSecure
: indique si le canal gRPC est sécurisé ou non.[CONNECTION] grpcChannelCredential
: identifiants du canal gRPC.[CONNECTION] unaryMiddlewares
: intergiciel unaire.[CONNECTION] streamingMiddlewares
: intergiciel de streaming.[CONNECTION] grpcInterceptors
: intercepteurs gRPC.
[GAPIC] useGapicV2Source
: indique si le code source GAPIC v2 doit être utilisé lors de la création de clients de service.
Validation de la configuration
Les paramètres de configuration sont vérifiés lors de l'instanciation des clients, et les exceptions sont générées lorsqu'elles ne sont pas valides. Voici les règles:
- Les champs
[OAUTH2]
ne doivent pas être définis en même temps pour le mode Application et le mode Compte de service. [OAUTH2] jsonKeyFilePath
et[OAUTH2] scopes
doivent être définis lors de l'utilisation du mode Compte de service.[OAUTH2] clientId
,[OAUTH2] clientSecret
et[OAUTH2] refreshToken
doivent être définis lorsque vous utilisez le mode Application.[GOOGLE_ADS] developerToken
doit toujours être défini.- S'ils sont définis,
[GOOGLE_ADS] loginCustomerId
et[GOOGLE_ADS] linkedCustomerId
doivent être des nombres positifs. - S'il est défini,
[CONNECTION] proxy
doit être une URL valide (voir le filtre FILTER_VALIDATE_URL). - S'il est défini,
[LOGGING] logLevel
doit être un niveau de journalisation PSR valide en lettres majuscules (par exemple,INFO
). - S'il est défini,
[CONNECTION] transport
doit êtregrpc
ourest
. - Si
[CONNECTION] transport
est défini surgrpc
, le transport gRPC doit être compatible avec l'environnement (consultez le guide sur le transport). [CONNECTION] grpcChannelIsSecure
doit êtretrue
lorsque[CONNECTION] transport
n'est pas défini surgrpc
.[CONNECTION] grpcChannelCredential
ne peut être défini que lorsque[CONNECTION] transport
est défini surgrpc
.[CONNECTION] grpcChannelCredential
ne peut être défini que lorsque[CONNECTION] grpcChannelIsSecure
est défini surtrue
.