El uso básico de la biblioteca cliente de Java es el siguiente:
Crea un proyecto nuevo de Maven o Gradle
Crea un proyecto nuevo de Maven o Gradle en el IDE que elijas. Nuestros artefactos se publican en el repositorio central de Maven.
Te recomendamos que uses la lista de materiales de la API de Google Ads (BOM) para administrar las versiones de las dependencias.
También puedes compilar desde la fuente. Para los fines de esta guía, se supone que tienes un proyecto configurado con las dependencias requeridas disponibles.
Si compilas desde la fuente, asegúrate de habilitar el procesamiento de anotaciones en tu IDE.
Configura el acceso a la API
Para conectarte a la API de Google Ads, debes proporcionar credenciales de autenticación y autorización. Consulta la guía de autenticación y autorización para obtener detalles sobre las credenciales requeridas y cómo configurar la biblioteca cliente.
Realiza tu primera llamada
Una vez que hayas configurado tus credenciales, podrás realizar tu primera llamada a la API.
Para validar tus credenciales y realizar tu primera llamada, ejecutaremos el ejemplo GetCampaigns.
Primero, navega al directorio google-ads-examples.
cd google-ads-examples
Este ejemplo requiere un parámetro --customerId en el que el valor sea el ID de cliente de tu cuenta de Google Ads sin guiones.
Para ejecutar con Gradle, haz lo siguiente:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Explora otros ejemplos
El paquete de ejemplos en google-ads-examples
contiene varios ejemplos útiles. La mayoría de los ejemplos requieren parámetros. Puedes pasar los parámetros como argumentos (recomendado) o editar los valores INSERT_XXXXX_HERE en el código fuente. Para ver una declaración de uso de un ejemplo, pasa --help como el único argumento.
Con Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
También puedes usar la tarea listExamples en Gradle para enumerar todos los ejemplos, los ejemplos de un subdirectorio o los ejemplos en los que la descripción incluye un término de búsqueda.
# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'