Bibliotecas cliente

Nuestras bibliotecas cliente proporcionan vistas de alto nivel y los componentes básicos de la funcionalidad de la API de Google Ads, lo que facilita el desarrollo rápido de apps. Recomendamos que comiences con una si usas la API por primera vez.

Biblioteca cliente Origen Distribución Ejemplos de código
Java google-ads-java Maven, tar.gz Ver en GitHub
.NET google-ads-dotnet. tar.gz: zip Ver en GitHub
PHP google-ads-php. tar.gz Ver en GitHub
Python google-ads-python tar.gz: zip Ver en GitHub
Ruby google-ads-ruby (en inglés) gemas, tar.gz, zip Ver en GitHub
Perl google-ads-perl. tar.gz: zip Ver en GitHub

Versiones de la API compatibles

En la siguiente tabla, se enumeran las versiones de biblioteca específicas que admiten cada versión de la API disponible.

Versión de API Versión de la biblioteca de Python Versión de la biblioteca de Ruby Versión de biblioteca PHP Versión de la biblioteca Java Versión de la biblioteca .NET Versión de la biblioteca de Perl
Versión 11 >= 17.0.0 >= 18.0.0 >=15.1.0 >= 19.0.0 >= 12.1.0 >= 12.0.0
V10 >= 15.0.0 >= 16.0.0 >= 14.0.0 >= 17.0.0 >= 11.0.0 >= 10.0.0
V9 >= 14.1.0 >= 15.0.0 >= 12.1.0 >= 16.0.0 >= 10.2.0 >= 9.2.0

Configuración

Cada biblioteca cliente de la API de Ads proporciona diferentes parámetros de configuración y métodos de carga que puedes usar para personalizar su comportamiento.

A continuación, se muestran las variables de entorno que son comunes a todas las bibliotecas cliente y que se pueden cargar para establecer la configuración:

  • Biblioteca cliente
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: Ruta de acceso al archivo de configuración
  • OAuth2
    • Modo de aplicación
      • GOOGLE_ADS_CLIENT_ID: establece este valor en tu ID de cliente de OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET: establece este valor en tu secreto de cliente de OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN: Establece este valor en un token de actualización de OAuth2 generado previamente si deseas volver a usar los tokens de OAuth2. Esta configuración es opcional.
    • Modo de cuenta de servicio
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : establece este valor en la ruta de acceso del archivo de configuración JSON de OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL: Establece este valor como la dirección de correo electrónico de la cuenta que estás robando.
  • API de Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN: Configura esto en tu token de desarrollador.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID: Este es el ID de cliente del cliente autorizado que se usará en la solicitud, sin guiones (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID: Este encabezado solo es necesario para los métodos que actualizan los recursos de una entidad cuando se lo permite a través de cuentas vinculadas en la IU de Google Ads (recurso AccountLink en la API de Google Ads). Establece este valor en el ID de cliente del proveedor de datos que actualiza los recursos del ID de cliente especificado. Debe configurarse sin guiones (-). Para obtener más información sobre las cuentas vinculadas, visita el Centro de ayuda.