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 prefieras. Nuestros artefactos se publican en el repositorio central de Maven.
Te recomendamos que uses la lista de materiales (BOM) de la API de Google Ads 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 necesarias 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 de 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 tu ID de cliente de la 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 examples en google-ads-examples contiene varios ejemplos útiles. La mayoría de los ejemplos requieren parámetros. Puedes pasar los parámetros como argumentos (opción recomendada) o editar los valores de INSERT_XXXXX_HERE en el código fuente. Para ver una declaración de uso de un ejemplo, pasa --help como ú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 en 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'