Biblioteca cliente de la API de Google Ads para Java

La biblioteca cliente para Java está alojada en GitHub y se distribuye a través de Maven Central. Ofrece varias funciones para ayudarte a usar la API, incluida una administración más sencilla de las credenciales y la creación de clientes de servicio de la API de Google Ads.

La biblioteca requiere Java 8 o una versión posterior.

Instalación

Usa la lista de materiales (BOM) de la API de Google Ads en tu archivo pom.xml o build.gradle para administrar las versiones de las dependencias:

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>46.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

También puedes compilar la biblioteca desde la fuente.

Realiza tu primera llamada a la API

Biblioteca de videos: Introducción a la biblioteca cliente de Java

Para usar la API de Google Ads, debes seguir varios pasos para obtener acceso a ella y configurar tus cuentas de Google Ads. Sigue la guía de inicio rápido, que te explica todos los pasos importantes, incluida la configuración de tus cuentas de Google Ads.

Uso básico

Consulta la guía de uso básico para obtener información sobre cómo configurar un proyecto, crear instancias de clientes de servicio y ejecutar ejemplos de código con la biblioteca cliente de Java.

Autenticación y autorización

La biblioteca cliente de Java admite varios enfoques para la autenticación y la autorización, incluidos los flujos de aplicaciones web y de escritorio de OAuth 2.0, las cuentas de servicio y las credenciales predeterminadas de la aplicación. Consulta la guía de autenticación y autorización para obtener más información.

Configuración y registro

La biblioteca cliente de Java admite varias opciones de configuración (incluidos archivos ads.properties, variables de entorno y configuración programática) y capacidades de registro para hacer un seguimiento de las solicitudes y respuestas de la API.

Utilidades

La biblioteca cliente de Java incluye clases de utilidad para mejorar la usabilidad de la API. Consulta las siguientes guías para obtener más información:

  • FieldMasks: Son asistentes para construir y calcular máscaras de campos de actualización.
  • ResourceNames: Utilidades para formatear cadenas de nombres de recursos de entidades.
  • Operaciones de larga duración: Son asistentes para supervisar y administrar operaciones de API asíncronas.

Ajusta tu aplicación

Consulta la guía de uso avanzado para obtener recomendaciones sobre cómo ajustar los tiempos de espera, la configuración de reintentos, la latencia de inicio y la administración de dependencias de tu aplicación.