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 usar cuando se crea una instancia del cliente.

Si no usas argumentos cuando creas instancias de una instancia, haz lo siguiente:

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

La biblioteca buscará en la ubicación especificada en la variable de entorno GOOGLE_ADS_CONFIGURATION_FILE_PATH. Si no está configurada, 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.

La manera más fácil de generar este archivo es copiar el google_ads_config.rb del repositorio de GitHub y modificarlo para incluir tu token de actualización, tu ID de cliente y el secreto del 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 crear 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 el token de actualización de OAuth.
  • client_id: Es tu ID de cliente de OAuth.
  • client_secret: El secreto de cliente de OAuth
  • developer_token: El token de desarrollador para acceder a la API.
  • login_customer_id: Consulta la documentación de acceso-cliente-id.

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

  • log_level: Son los mensajes del nivel de registro mínimo 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: Dónde deseas acceder, como STDERR.
  • logger: Especifica tu propio registrador personalizado. Si lo especificas, se anularán log_level y log_target.

Variables de entorno

Puedes configurar la biblioteca cliente con las 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 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 llame a este método, el estado actual de las variables de entorno reemplazará 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 configurarlas 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: Como se indicó anteriormente en log_level.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: Especifica un proxy HTTP.