Configuración

La biblioteca cliente de la API de Google Ads proporciona varios parámetros de configuración que puedes usar para personalizar el comportamiento de la biblioteca.

Archivo de configuración

Puedes especificar un googleads.properties archivo para usar cuando crees una instancia del cliente.

Si no usas argumentos cuando creas una instancia, sucede lo siguiente:

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

La biblioteca buscará el archivo en tu directorio HOME.

Como alternativa, puedes especificar una ruta de acceso:

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

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

En ese caso, el cliente buscará el archivo en esa ruta de acceso.

La forma más sencilla de generar este archivo es copiar el archivo googleads.properties del repositorio de GitHub y modificarlo para incluir tu ID de cliente, secreto de cliente y token de actualización.

Configuración dinámica

Puedes configurar los parámetros de configuración de forma dinámica cuando crees una instancia de la biblioteca o incluso después:

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

Incluso puedes modificar la configuración después de la creación de instancias:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

También puedes obtener un objeto OAuth2ApplicationsHandler del API Client, y cambiar el ID de cliente, el secreto de cliente y el token de actualización en el tiempo de ejecución:

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");

Variables de entorno de configuración

Puedes configurar algunos de los parámetros de configuración de las variables de entorno cuando crees instancias de clientes (consulta la lista exhaustiva).

El módulo Client proporciona la función configure_from_environment_variables para cargar valores de las variables de entorno:

# 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 configuración

Las propiedades de configuración admiten los siguientes campos:

Campos persistentes en OAuth2ApplicationsHandler:

  • client_id: Tu ID de cliente de OAuth2
  • client_secret: Tu secreto de cliente de OAuth2
  • refresh_token: Tu token de actualización de OAuth2

Campos persistentes en el cliente de la API: