Configuración

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

Archivo de configuración

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

Si no usas argumentos cuando creas una instancia, haz 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 cuyo caso el cliente buscará el archivo en esa ruta.

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

Configuración dinámica

Puedes establecer la configuración de forma dinámica cuando creas una instancia de la biblioteca o incluso después:

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

Incluso puedes modificar la configuración después de crear una instancia:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

También puedes obtener un objeto OAuth2ApplicationsHandler desde API Client y cambiar el ID de cliente, el secreto de cliente y el token de actualización en el entorno 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 establecer algunos de los ajustes de configuración desde las variables de entorno cuando creas instancias de clientes (consulta la lista exhaustiva).

El módulo cliente proporciona la función configure_from_environment_variables para cargar valores desde 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: Es el ID de cliente de OAuth2.
  • client_secret: Tu secreto del cliente de OAuth2.
  • refresh_token: Es el token de actualización de OAuth2.

Campos que se conservan en el cliente de la API:

  • developer_token: Es el token de desarrollador para acceder a la API.
  • login_customer_id: Consulta la documentación de login-customer-id.
  • proxy: La URL del servidor proxy que se usa para la conectividad a Internet.