Configuración

La configuración se realiza usando 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 desde variables de entorno.

Archivo de configuración

Puedes especificar google_ads_config.rb para usar cuando se crea una instancia del cliente.

Si no usas argumentos cuando creas una instancia, sucede 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 esa variable es Si no se establece, la biblioteca buscará el archivo en tu directorio HOME.

También puedes especificar una ruta de acceso:

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

en cuyo caso el cliente buscará el archivo en esa ruta.

La forma más fácil de generar este archivo es copiar el google_ads_config.rb de el repositorio de GitHub y modificarlo para incluir el token de actualización, el 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: Es tu secreto de cliente de OAuth.
• developer_token: Tu token de desarrollador para acceder a la API.
• login_customer_id: Consulta las documentación delogin-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ínimo que deseas registrar. Por ejemplo: especificar 'DEBUG' garantizará que veas todos los mensajes de registro, y especificar 'INFO' excluirá los mensajes "DEBUG", pero mostrará todos los demás mensajes.
• log_target: Indica el lugar al que deseas acceder, como STDERR.
• logger: Especifica tu propio registrador personalizado. Si especificas esto, se anularán ambos log_level y log_target.

Variables de entorno

Puedes configurar la biblioteca cliente mediante variables de entorno. No son se cargan de forma predeterminada y requieren una llamada adicional después de crear una instancia para cargarlo. Consulta la lista completa de variables de entorno compatible con todos 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 esto, el estado actual de las variables de entorno reemplaza todo lo que ya esté presente en Config. Con este puedes tener, por ejemplo, una configuración predeterminada, pero anular con variables de entorno o puedes configurar completamente variables de entorno.

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

• GOOGLE_ADS_RUBY_LOG_LEVEL: Como log_level, arriba.
• GOOGLE_ADS_RUBY_HTTP_PROXY: Especifica un proxy HTTP.