Necesitas un proyecto de la Consola de API de Google para crear credenciales de OAuth 2.0, configurar una pantalla de consentimiento del usuario y habilitar la API de Google Ads para tu app.
Las credenciales son necesarias para la autenticación y autorización de los usuarios de Google Ads por parte de los servidores de Google. Estas credenciales te permiten generar tokens de OAuth para usarlos en llamadas a la API.
Selecciona o crea un proyecto en la Consola de APIs de Google
Si ya tienes un proyecto en la Consola de APIs de Google y quieres usarlo para crear credenciales, puedes pasar a la sección Crea un ID de cliente y un secreto de cliente.
Para crear un proyecto,
- Ve a la Consola de APIs de Google.
- Haz clic en Crear proyecto.
- Ingresa un nombre o acepta la sugerencia generada
- Confirma o edita los campos restantes
- Haz clic en Create.
Si tienes habilitada la facturación, selecciona una cuenta de facturación para el proyecto nuevo. No se aplican cargos por usar la API de Google Ads, pero existe una cuota para la cantidad total de proyectos de Cloud.
Cómo configurar la pantalla de consentimiento de OAuth
Si usas un proyecto existente de la Consola de APIs de Google y configuraste una pantalla de consentimiento de OAuth anteriormente, puedes omitir este paso y modificar la pantalla de consentimiento si agregas el alcance de OAuth 2.0 de la API de Google Ads.
Cuando usas OAuth 2.0 para la autorización, Google muestra una pantalla de consentimiento al usuario que incluye un resumen de tu proyecto, sus políticas y los permisos de acceso solicitados para la autorización. Si configuras la pantalla de consentimiento de OAuth de tu app, se define lo que se les muestra a los usuarios y los revisores de la app, y se registra la app para que puedas publicarla más tarde.
Configura una nueva pantalla de consentimiento de OAuth
- Abre la página Pantalla de consentimiento y selecciona tu proyecto en el menú desplegable de la parte superior de la página.
- Selecciona el Tipo de usuario y haz clic en CREAR.
- Completa el formulario de la pantalla de consentimiento. Puedes editarla más tarde si es necesario. Cuando termines, haz clic en GUARDAR Y CONTINUAR.
- En la página siguiente, haz clic en AGREGAR O QUITAR ALCANCES.
- Desplázate hacia abajo y, luego, ingresa lo siguiente en el campo debajo de Manually add scope:
https://www.googleapis.com/auth/adwords - Haz clic en AGREGAR A LA TABLA.
- Agrega cualquier otro permiso que pueda necesitar tu proyecto y, luego, haz clic en ACTUALIZAR.
- Haz clic en GUARDAR Y CONTINUAR.
- Si no planeas publicar tu proyecto de inmediato, agrega la dirección de correo electrónico de cada cuenta de usuario que puedas usar para las pruebas y, luego, haz clic en GUARDAR Y CONTINUAR.
- Revisa la página de resumen y haz clic en VOLVER AL PANEL.
Configura una pantalla de consentimiento de OAuth existente
- Abre la página Pantalla de consentimiento y selecciona tu proyecto en el menú desplegable de la parte superior de la página.
- Haz clic en EDITAR APP.
- Haz clic en GUARDAR Y CONTINUAR en el formulario pantalla de consentimiento de OAuth.
- En la página siguiente, haz clic en AGREGAR O QUITAR ALCANCES.
- Desplázate hacia abajo y, luego, ingresa lo siguiente en el campo debajo de Manually add scope:
https://www.googleapis.com/auth/adwords - Haz clic en AGREGAR A LA TABLA.
- Haz clic en GUARDAR Y CONTINUAR.
- Haz clic en GUARDAR Y CONTINUAR en el formulario Usuarios de prueba.
- Revisa la página de resumen y haz clic en VOLVER AL PANEL.
Crea un ID de cliente y un secreto de cliente
Puedes omitir este paso si usas un proyecto existente de la Consola de APIs de Google que ya tiene un ID de cliente y un secreto generados.
Una vez que hayas determinado el tipo de app, sigue las instrucciones a continuación para generar el ID de cliente y el secreto de cliente de OAuth 2.0:
Abre la página Credenciales. Selecciona un proyecto creado anteriormente o crea uno nuevo.
En la pantalla Credenciales, haz clic en CREAR CREDENCIALES y, luego, selecciona ID de cliente de OAuth.
Si todavía no configuraste una pantalla de consentimiento de OAuth para este proyecto, haz clic en CONFIGURAR PANTALLA DE CONSENTIMIENTO.
Selecciona el tipo de usuario y haz clic en CREAR.
Completa el formulario inicial. Puedes editarla más tarde si es necesario. Haz clic en Guardar cuando termines.
Regresa a Credenciales > CREAR CREDENCIALES > ID de cliente de OAuth para continuar.
Selecciona App para computadoras de escritorio o Aplicación web como el tipo de app, según el caso de uso. En esta guía, se usa Aplicación para computadoras de escritorio como el tipo de aplicación.
Ingresa un nombre para la app y, luego, haz clic en Crear.
En la página de confirmación, copia Tu ID de cliente y Tu secreto del cliente en el portapapeles para configurar la biblioteca cliente más adelante. Además, descarga las credenciales en formato JSON en un archivo llamado
credentials.json.
Habilita la API de Google Ads en tu proyecto
Para habilitar la API de Google Ads en tu proyecto, sigue estos pasos:
Abre la Biblioteca de APIs en la Consola de APIs de Google. Si se te solicita, selecciona tu proyecto o crea uno nuevo. La Biblioteca de APIs muestra todas las APIs disponibles agrupadas por familia de productos y popularidad.
Utiliza la búsqueda para encontrar la API de Google Ads si no está visible en la lista.
Selecciona la API de Google Ads y, luego, haz clic en el botón Habilitar.