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 versiones posteriores.
Instalación
Usa la lista de materiales (BOM) de la API de Google Ads en tu pom.xml o
build.gradle archivo para administrar las versiones de dependencia:
<!-- 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>48.0.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
Para usar la API de Google Ads, debes realizar varios pasos para obtener acceso a la API y configurar tus cuentas de Google Ads. Sigue la guía de inicio rápido, que te guiará por 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 aprender a 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 los archivos ads.properties, las variables de entorno y la 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: Ayudantes para construir y calcular máscaras de campo de actualización
- ResourceNames: Utilidades para dar formato a cadenas de nombres de recursos de entidades
- Operaciones de larga duración: Ayudantes 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.