Recomendamos usar la biblioteca cliente con Apache Maven (o Gradle).
Cómo crear un proyecto nuevo de Maven o Gradle
Crea un proyecto nuevo de Maven o Gradle en el IDE que elijas. Nuestros artefactos son publicado en la página principal de Cloud Storage.
La dependencia de Maven es la siguiente:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>33.0.0</version>
</dependency>
La dependencia de Gradle es la siguiente:
implementation 'com.google.api-ads:google-ads:33.0.0'
También puedes compilar desde la fuente. A los efectos de este se da por sentado que tienes una configuración de proyecto con las dependencias requeridas disponibles.
Obtén credenciales para autenticar con la API
Para acceder a la API de Google Ads, se requieren credenciales de OAuth y un desarrollador de la API de Google Ads token. En esta sección, se explica qué son, cómo se usan y cómo se usan. obtenidos.
Token de desarrollador (para acceder a la API)
El token de desarrollador está vinculado a un administrador. y puede encontrarse en la interfaz web de Google Ads.
Si bien el token de desarrollador está vinculado a una cuenta de administrador, no proporciona acceso a esa cuenta. En su lugar, el token de desarrollador otorga acceso a la API en general, y el acceso a nivel de la cuenta se configura a través de OAuth.
Credenciales OAuth (para acceder a cuentas de Google Ads)
Para autorizar el acceso a cuentas de Google Ads como usuarios de cuentas de Google, debes Debes proporcionar un conjunto de credenciales de OAuth.
Por lo general, se usan dos flujos de OAuth: una app para computadoras (instalada) o aplicación web. La principal diferencia entre ambos es que las apps de escritorio abre el navegador del sistema y proporciona un URI de redireccionamiento local para manejar las respuestas de servidor de autorización de Google, mientras que las aplicaciones web pueden redireccionar navegador de terceros para completar la autorización y enviar las credenciales a tu servidor. La biblioteca también admite la cuenta de servicio menos usada de tu flujo de trabajo.
- Si lo autorizas con tus propias credenciales (flujo de la aplicación para computadoras de escritorio)
- Consulte la aplicación de escritorio de OAuth de Terraform. Esto incluye todos los detalles que por lo que deberás autorizarlo con tus propias credenciales.
- Si autorizas como usuario externo de Google (flujo web)
- Consulta el flujo de aplicación web de OAuth. Esta muestra un ejemplo de cómo configurar la autorización de OAuth para aplicaciones usuarios.
- Si autorizas como usuario de un dominio de Google Apps (flujo de cuenta de servicio)
- Consulta la cuenta de servicio de OAuth de Terraform. Esto es un ejemplo de cómo Configurar la autorización de OAuth para los usuarios de un dominio de Google Apps.
Si tu acceso a la cuenta de cliente de Google Ads es a través de un administrador de Google Ads también debe especificar un ID de cliente que acceda como se describe a continuación.
ID de cliente de acceso (para acceder a las cuentas de Google Ads a través de una cuenta de administrador)
De forma opcional, especifica el ID de cliente de una cuenta de administrador que otorga acceso a la cuenta de publicación. Debes especificarlo si tienes acceso al cliente es a través de una cuenta de administrador. No es necesario especificar todos los administradores en la ruta hacia el ID de cliente, solo el ID de administrador de nivel superior que usan para los permisos de acceso. Para obtener más información, consulta la página documentación.
Configura la biblioteca cliente con tus credenciales
Puedes configurar la biblioteca cliente con un archivo de configuración variables de entorno o de manera programática. Para esta guía, usaremos el de archivos de configuración y se enfocan en los flujos web y de escritorio. Con un de configuración de Terraform suele ser un buen enfoque si solo tienes un conjunto credenciales (por ejemplo, si administras cuentas bajo un único administrador).
Crea un archivo ~/ads.properties con el siguiente contenido:
api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
Reemplaza los marcadores de posición por las credenciales que obtuviste en el paso anterior.
Además, si su token de actualización es para una cuenta de administrador, debe especifica el ID de cliente de esta cuenta como el cliente que accede:
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
Valida las credenciales
Para asegurarnos de que todo esté configurado correctamente, publicaremos la página GetCampaigns ejemplo.
Primero, navega al directorio google-ads-examples.
$ cd google-ads-examples
En este ejemplo, se requiere un parámetro --customerId en el que el valor sea tu
ID de cliente de la cuenta de Google Ads sin guiones.
Para ejecutarlo 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
edita los valores INSERT_XXXXX_HERE en el código fuente. Para ver una declaración de uso, sigue estos pasos:
Para ver 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.
ejemplos en un subdirectorio o ejemplos en los que la descripción incluye una búsqueda
tiempo.
# 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'