Configuração

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

Arquivo de configuração

É possível especificar um arquivo googleads.properties para usar ao instanciar o cliente.

Se você não usar argumentos ao instanciar:

my $api_client = Google::Ads::GoogleAds::Client->new();

Em seguida, a biblioteca procurará o arquivo no diretório HOME.

Como alternativa, especifique um caminho:

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

Nesse caso, o cliente procurará o arquivo nesse caminho de arquivo.

A maneira mais fácil de gerar esse arquivo é copiar o googleads.properties do repositório do GitHub e modificá-lo para incluir o ID do cliente, a chave secreta do cliente e o token de atualização.

Configuração dinâmica

É possível definir a configuração dinamicamente ao instanciar a biblioteca ou mesmo depois:

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

É possível até mesmo modificar a configuração após a instanciação:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Também é possível receber um objeto OAuth2ApplicationsHandler do API Client e alterar o ID do cliente, a chave secreta do cliente e o token de atualização no momento da execução:

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

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.

O módulo do cliente fornece a função configure_from_environment_variables para carregar valores de variáveis de ambiente:

# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();

# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();

Campos de configuração

As propriedades de configuração aceitam os seguintes campos:

Campos persistidos em OAuth2ApplicationsHandler:

  • client_id: seu ID do cliente OAuth2.
  • client_secret: a chave secreta do cliente do OAuth2.
  • refresh_token: seu token de atualização do OAuth2.

Campos persistidos no Cliente da API:

  • developer_token: o token de desenvolvedor para acessar a API.
  • login_customer_id: consulte a documentação de login-customer-id.
  • proxy: o URL do servidor proxy usado para conectividade com a Internet.