Configuração

A biblioteca de cliente PHP da Google Ads API oferece várias definições de configuração que podem ser usadas para personalizar o comportamento da biblioteca.

Arquivo de configuração

Você pode armazenar a maioria dessas configurações em arquivos ini e usá-las ao instanciar clientes, por exemplo, google_ads_php.ini.

A credencial e os builders de cliente fornecem métodos fromFile para carregar as configurações desses arquivos:

$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 nenhum caminho do arquivo de configuração for fornecido como argumento, os métodos fromFile serão carregados pelo caminho do arquivo de configuração padrão:

1. O valor da variável de ambiente chamada GOOGLE_ADS_CONFIGURATION_FILE_PATH, se definido.
2. Caso contrário, o arquivo google_ads_php.ini no diretório HOME.

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

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

Configuração dinâmica

Você pode definir essas definições de configuração dinamicamente ao instanciar clientes.

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

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

Variáveis de ambiente de configuração

É possível definir algumas definições de configuração a partir de variáveis de ambiente ao instanciar clientes. Consulte a lista completa.

Os criadores de credenciais e clientes fornecem métodos fromEnvironmentVariables para carregar configurações de variáveis de ambiente:

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

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

Campos de configuração

As definições de configuração aceitam vários campos organizados em categorias.

1. Campos usados por OAuth2TokenBuilder:
   • Modo do aplicativo
     • [OAUTH2] clientId: seu ID do cliente OAuth2.
     • [OAUTH2] clientSecret: a chave secreta do cliente do OAuth2.
     • [OAUTH2] refreshToken: seu token de atualização do OAuth2.
   • Modo da conta de serviço
     • [OAUTH2] jsonKeyFilePath: o caminho do arquivo de chave Json.
     • [OAUTH2] scopes: os escopos
     • [OAUTH2] impersonatedEmail: o e-mail a ser personificado.
2. Campos usados por GoogleAdsClientBuilder:
   • [GOOGLE_ADS] developerToken: o token de desenvolvedor para acessar a API.
   • [GOOGLE_ADS] loginCustomerId: o ID de cliente de login.
   • [GOOGLE_ADS] linkedCustomerId: o ID do cliente vinculado.
   • [LOGGING] logFilePath: o caminho do arquivo para geração de registros.
   • [LOGGING] logLevel: o nível de geração de registros.
   • [CONNECTION] proxy: o URL do servidor proxy usado para conectividade com a Internet.
   • [CONNECTION] transport: o transporte.
   • [CONNECTION] grpcChannelIsSecure: se o canal gRPC é seguro ou não.
   • [CONNECTION] grpcChannelCredential: as credenciais do canal gRPC.
   • [CONNECTION] unaryMiddlewares: os middlewares unários.
   • [CONNECTION] streamingMiddlewares: os middlewares de streaming.
   • [CONNECTION] grpcInterceptors: os interceptadores do gRPC.

Validação de configuração

As configurações são verificadas ao instanciar clientes, e as exceções são geradas quando inválidas. Veja as regras:

1. Os campos [OAUTH2] não podem ser definidos para os modos de aplicativo e de conta de serviço ao mesmo tempo.
2. [OAUTH2] jsonKeyFilePath e [OAUTH2] scopes precisam ser definidos ao usar o modo de conta de serviço.
3. [OAUTH2] clientId, [OAUTH2] clientSecret e [OAUTH2] refreshToken precisam ser definidos ao usar o modo de aplicativo.
4. [GOOGLE_ADS] developerToken precisa ser sempre definido.
5. Se definido, [GOOGLE_ADS] loginCustomerId e [GOOGLE_ADS] linkedCustomerId precisam ser números positivos.
6. Se definido, [CONNECTION] proxy precisará ser um URL válido. Consulte o filtro FILTER_VALIDATE_URL.
7. Se definido, [LOGGING] logLevel precisa ser um nível de registro PSR válido em letras maiúsculas, como INFO.
8. Se definido, [CONNECTION] transport precisa ser grpc ou rest.
9. Se [CONNECTION] transport estiver definido como grpc, o transporte gRPC precisará ser aceito pelo ambiente. Consulte o guia Transporte.
10. [CONNECTION] grpcChannelIsSecure precisa ser true quando [CONNECTION] transport não está definido como grpc.
11. [CONNECTION] grpcChannelCredential só pode ser definido quando [CONNECTION] transport é definido como grpc.
12. [CONNECTION] grpcChannelCredential só pode ser definido quando [CONNECTION] grpcChannelIsSecure é true.