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 en la creación o cargar valores de las variables de entorno.

Archivo de configuración

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

Si no usas argumentos cuando creas una instancia de un objeto GoogleAdsClient, la biblioteca buscará en la ubicación especificada en la variable de entorno GOOGLE_ADS_CONFIGURATION_FILE_PATH. Si esa variable no está configurada, la biblioteca buscará el archivo en tu directorio HOME.

Como alternativa, puedes especificar una ruta de acceso cuando crees una instancia del objeto GoogleAdsClient de la siguiente manera, en cuyo caso el cliente buscará el archivo en esa ruta de acceso.

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

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

Configuración dinámica

Puedes configurar la configuración de forma dinámica cuando crees 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 instancias:

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: Tu token de actualización de OAuth.
  • client_id: Tu ID de cliente de OAuth.
  • client_secret: Tu secreto de cliente de OAuth.
  • 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: El nivel de registro mínimo de los mensajes que deseas registrar. Por ejemplo, si especificas 'DEBUG', te asegurarás de ver todos los mensajes de registro, y si especificas 'INFO', se excluirán los mensajes de DEBUG, pero se mostrarán todos los demás mensajes.
  • log_target: El lugar en el que deseas registrar, 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 cargarse. Consulta la lista completa de variables de entorno compatibles con todos los idiomas.

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 llama a este, el estado actual de las variables de entorno sobrescribirá todo lo que ya esté presente en el Config. Con este mecanismo, puedes, por ejemplo, tener una configuración predeterminada, pero anular valores específicos con variables de entorno, o puedes configurar por completo con variables de entorno.

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

  • GOOGLE_ADS_RUBY_LOG_LEVEL: log_level como se explicó anteriormente.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Especifica un proxy HTTP.