Configuración

La configuración se realiza con una clase Config. Puedes acceder a esta clase de varias maneras, como escribir un archivo de configuración, especificar valores durante la creación o cargar valores desde variables de entorno.

Archivo de configuración

Puedes especificar un archivo google_ads_config.rb para usarlo cuando crees una instancia del cliente.

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

client = Google::Ads::GoogleAds::GoogleAdsClient.new

entonces, la biblioteca buscará en la ubicación especificada en la variable de entorno GOOGLE_ADS_CONFIGURATION_FILE_PATH. Si no se configura esa variable, la biblioteca buscará el archivo en el directorio HOME.

Como alternativa, puedes especificar una ruta de acceso:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

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

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

Configuración dinámica

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

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

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

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

Campos de configuración

El objeto Config admite los siguientes campos.

Campos generales:

  • refresh_token: Es tu token de actualización de OAuth.
  • client_id: Es tu ID de cliente de OAuth.
  • client_secret: Es tu secreto de cliente de OAuth.
  • developer_token: Tu token de desarrollador para acceder a la API.
  • login_customer_id: Consulta la documentación de login-customer-id.

Campos de registro Consulta la guía de registro para obtener todos los detalles.

  • log_level: Los mensajes de nivel de registro mínimos que deseas registrar. Por ejemplo, si especificas 'DEBUG', te asegurarás de ver todos los mensajes del registro. Si especificas 'INFO', se excluirán los mensajes DEBUG, pero se mostrarán todos los demás mensajes.
  • log_target: El destino al que deseas acceder, como STDERR
  • logger: Especifica tu propio registrador personalizado. Si especificas esto, se anularán log_level y log_target.

Variables de entorno

Puedes configurar la biblioteca cliente con variables de entorno. No se cargan de forma predeterminada y requieren una llamada adicional después de crear una instancia del cliente para cargarlos. Consulta la lista completa de variables de entorno compatibles con todos los lenguajes.

Para cargar las variables de entorno en tu Config, llama a load_environment_config:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

Cada vez que se la llame, el estado actual de las variables de entorno reemplazará todo lo que ya esté presente en Config. Con este mecanismo, puedes, por ejemplo, tener una configuración predeterminada, pero anular valores específicos mediante variables de entorno, o puedes configurarlo por completo con variables de entorno.

Además de las variables de entorno que admiten todas las bibliotecas, la biblioteca de Ruby tiene dos variables adicionales:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: Como se muestra más arriba log_level.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Especifica un proxy HTTP.