Configure un proyecto de la Consola de API de Google para la API de Google Ads

Se requieren credenciales para acceder a los servidores de OAuth2 de Google a fin de autenticar y autorizar a los usuarios de Google Ads. Estas credenciales identifican tu aplicación en Google, lo que te permite generar tokens OAuth para administrar usuarios de Google Ads. El acceso a las credenciales de Google OAuth2 se administra desde la Consola de API de Google.

Mira este video con algunas prácticas recomendadas para los proyectos de Cloud

Verificación de OAuth de Google

Todas las apps de Google Cloud que se usen para obtener credenciales para el alcance de la API de Google Ads deberán someterse a una verificación de OAuth de Google a fin de evitar una pantalla de IU no verificada para los usuarios. En este contexto, una aplicación se define como un ID de cliente de OAuth 2.0 único en Google Cloud.

Esta verificación es independiente y se suma a cualquier revisión realizada como parte del proceso de aprobación del token de desarrollador y es obligatoria, ya que el alcance de la API de Google Ads es un alcance sensible.

La verificación de Google no tiene costo, que suele completarse en 3 a 5 días hábiles. Esta política se aplica a todas las apps.

Recomendamos que todas las apps pasen por el proceso de verificación de Google OAuth lo antes posible para evitar interrupciones del negocio.

Cómo crear un proyecto

Ve a la Consola de API de Google. Haz clic en Crear proyecto, ingresa un nombre y haz clic en Crear.

Punto clave: Si habilitaste la facturación (por ejemplo, Google Cloud), debes seleccionar una cuenta de facturación para el proyecto nuevo.

No se aplican cargos por usar la API de Google Ads. Sin embargo, hay una cuota para la cantidad total de proyectos de Cloud. Como alternativa, puedes registrarte para obtener una nueva Cuenta de Google que incluya una cuota de proyecto gratuita.

Habilite la API de Google Ads en su proyecto

Para habilitar la API de Google Ads en tu proyecto, sigue estos pasos:

1. Abre la Biblioteca de API en la Consola de API de Google. Si se te solicita, selecciona tu proyecto o crea uno nuevo. En la biblioteca de API, se enumeran todas las API disponibles, agrupadas por familia de productos y popularidad.

2. Utilice la búsqueda para encontrar la API de Google Ads si no aparece en la lista.

3. Seleccione la API de Google Ads y, luego, haga clic en el botón Habilitar.

Elige un tipo de usuario y un estado de publicación

Después de habilitar la API, debes especificar el Tipo de usuario y el Estado de publicación del proyecto. En la siguiente tabla, se destacan algunos atributos y limitaciones clave de cada combinación de estos parámetros de configuración. Consulta la documentación de Google Cloud Platform para obtener más detalles.

Tipo de usuario	Estado de publicación	Limitaciones
Interno	Prueba	Solo está disponible para proyectos asociados con una organización de Google Cloud. Se limita a un máximo de 100 usuarios de prueba incluidos en la pantalla de consentimiento de OAuth. Los usuarios de prueba deben ser usuarios internos de la organización de Google Cloud asociada con el proyecto. Las autorizaciones vencen siete días después del consentimiento.
Externa	Prueba	Disponible para todos los proyectos. Se limita a un máximo de 100 usuarios de prueba incluidos en la pantalla de consentimiento de OAuth. Los usuarios de prueba pueden ser cualquier usuario con una Cuenta de Google. Las autorizaciones vencen siete días después del consentimiento.
Interno	En producción	Solo está disponible para proyectos asociados con una organización de Google Cloud. Permite autorizar a cualquier usuario de la organización de Google Cloud asociada con el proyecto.
Externa	En producción	Disponible para todos los proyectos. Permite autorizar a cualquier usuario con una Cuenta de Google.

Si no completas la verificación de OAuth de Google, ocurrirá lo siguiente, independientemente del tipo de usuario o del estado de publicación de tu proyecto:

• Durante el proceso de autorización, los usuarios ven una pantalla de IU sin verificar.

• Solo puedes autorizar a 100 usuarios.

Cómo configurar la pantalla de consentimiento de OAuth

1. Abre la página Pantalla de consentimiento y selecciona tu proyecto en el menú desplegable de la parte superior de la página.

2. Seleccione el Tipo de usuario y haga clic en CREAR.

3. Llena el formulario de la pantalla de consentimiento. Puedes editarlo más tarde si es necesario. Haz clic en GUARDAR Y CONTINUAR cuando termines.

4. 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 Agregar permisos manualmente:

     https://www.googleapis.com/auth/adwords
     

   • Haga clic en AGREGAR A LA TABLA.

   • Agrega cualquier otro alcance que solicite tu proyecto y, luego, haz clic en ACTUALIZAR.

   • Haz clic en GUARDAR Y CONTINUAR.

5. Si no planeas publicar tu proyecto de inmediato, agrega la dirección de correo electrónico de cada cuenta de usuario que usarás para las pruebas y, luego, haz clic en GUARDAR Y CONTINUAR.

6. Revisa la página de resumen y haz clic en VOLVER AL PANEL.

Una vez que hayas probado tu aplicación y el proceso de autorización, puedes volver al panel y hacer clic en PUBLICAR APP para cambiar el Estado de publicación de Prueba a En producción.

Selecciona un tipo de app

Existen dos opciones de tipos de aplicaciones para la API de Google Ads: Computadoras de escritorio o web. Consulta la siguiente tabla a fin de determinar qué tipo es el más apropiado para la app que quieres compilar:

Elegir este tipo de aplicación	Si ...
App de escritorio	Administra todas sus cuentas de Google Ads mediante una única cuenta de administrador de nivel superior. Si es un usuario nuevo o si desea comenzar rápidamente con la configuración más simple. Tu app solo autenticará a los usuarios de Google desde una máquina.
Aplicación web	Quieres autenticarte como un usuario que puede otorgar permiso a tu app para acceder a los datos de su cuenta de Google Ads. Deseas generar fácilmente varias credenciales de autorización para administrar las cuentas de terceros, por ejemplo. Tu app requiere URL de devolución de llamada. Estas URL no son compatibles con el flujo de la app de escritorio.

Punto clave: De todos modos, puedes elegir el flujo de la app de escritorio, incluso si estás desarrollando una app para que se ejecute en un servidor. La diferencia es si la autorización OAuth se completa de forma local o remota. Un flujo de escritorio requiere que la autorización se complete en la máquina local, mientras que el flujo web permite que la autorización se complete en el servidor de autorización de Google.

Si quieres obtener más detalles, consulta la documentación de OAuth de Google Identity Platform para aplicaciones de escritorio o aplicaciones web.

Crea un ID de cliente y un secreto de cliente

Una vez que hayas determinado tu tipo de app, sigue estas instrucciones para generar el ID de cliente y el secreto de cliente de OAuth2:

1. Abre la página Credenciales. Selecciona un proyecto creado anteriormente o crea uno nuevo.

2. En la pantalla Credenciales, haz clic en CREAR CREDENCIALES y, luego, selecciona ID de cliente de OAuth.

   1. Si nunca habías configurado una pantalla de consentimiento de OAuth para este proyecto, se te indicará que lo hagas ahora. Haz clic en CONFIGURAR LA PANTALLA DE CONSENTIMIENTO.

      1. Seleccione el tipo de usuario y haga clic en CREAR.

      2. Complete el formulario inicial. Puedes editarlo más tarde si es necesario. Haz clic en Guardar cuando termines.

   2. Para continuar, regresa a Credenciales > CREAR CREDENCIALES > ID de cliente de OAuth.

3. Selecciona App de escritorio o Aplicación web como el tipo de app, según el caso de uso.

4. Asígnele un nombre y, luego, haga clic en Crear.

5. Si tu tipo de cliente es Aplicación web, agrega al menos un URI de redireccionamiento autorizado.

   Para las pruebas locales que son compatibles con la configuración predeterminada en nuestros ejemplos de biblioteca cliente, usa http://127.0.0.1.

   Nota: Puedes agregar un número de puerto a tu URI de redireccionamiento para restringir el uso a un puerto específico. Si el puerto no está configurado, un cliente de OAuth puede redireccionar a cualquier puerto.

   Para los clientes de la app de escritorio, seguirás usando un redireccionamiento de IP de bucle invertido, pero el URI no está configurado de forma explícita en Cloud Console.

6. En la página de confirmación, copia Tu ID de cliente y Tu secreto del cliente al portapapeles, ya que los necesitarás cuando configures tu biblioteca cliente. También puedes volver a la página de credenciales más tarde para recuperar estos detalles.