Cómo configurar un proyecto en la Consola de API de Google para la API de Google Ads

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

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

Verificación de OAuth de Google

Cualquier app de Google Cloud que se use para obtener credenciales para el permiso de la API de Google Ads deberá someterse a una verificación de OAuth de Google para evitar una pantalla de IU no verificada para sus usuarios. En este contexto, una app se define como un ID de cliente de OAuth 2.0 único en Google Cloud.

Esta verificación es independiente y, además de las revisiones que se realizan como parte del proceso de aprobación de tokens de desarrollador, es obligatoria, ya que el permiso de la API de Google Ads es un permiso sensible.

La verificación de Google no tiene costo y, por lo general, se completa en un plazo de 3 a 5 días hábiles. Esta política se aplica a todas las apps.

Recomendamos que todas las apps se sometan al proceso de verificación de OAuth de Google lo antes posible para evitar interrupciones en las operaciones comerciales.

Crea 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 tienes habilitada la facturación (por ejemplo, para 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 crear una Cuenta de Google nueva que incluya una cuota de proyecto gratuita.

Habilita la API de Google Ads en tu proyecto

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

1. 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 API muestra todas las APIs disponibles, agrupadas por familia de productos y popularidad.

2. Usa la búsqueda para encontrar la API de Google Ads si no está visible en la lista.

3. Selecciona la API de Google Ads y, luego, haz 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 de tu proyecto. En la siguiente tabla, se destacan algunos atributos y limitaciones clave de cada combinación de estos parámetros de configuración. Para obtener más detalles, consulta la documentación de Google Cloud Platform.

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 que aparecen 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 de que se otorga el consentimiento.
Externo	Prueba	Disponible para todos los proyectos. Se limita a un máximo de 100 usuarios de prueba que aparecen en la pantalla de consentimiento de OAuth. Los usuarios de prueba pueden ser cualquier usuario que tenga una Cuenta de Google. Las autorizaciones vencen siete días después de que se otorga el 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.
Externo	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 el estado de publicación de tu proyecto:

• Durante el proceso de autorización, a los usuarios se les presenta una pantalla de IU no verificada.

• 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. Selecciona el Tipo de usuario y haz clic en CREAR.

3. Completa el formulario de la pantalla de consentimiento. Si es necesario, puedes editar esta información más adelante. Cuando termines, haz clic en GUARDAR Y CONTINUAR.

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 Agregar manualmente alcances:

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

   • Haz clic en AGREGAR A LA TABLA.

   • Agrega cualquier otro permiso que solicite tu proyecto y, luego, haz clic en UPDATE.

   • 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 PUBLISH APP para cambiar su estado de publicación de Pruebas a En producción.

Selecciona un tipo de app

Existen dos opciones de tipo de aplicación para la API de Google Ads: para computadoras de escritorio o para la Web. Consulta la siguiente tabla para determinar qué tipo es el más adecuado para la app que deseas compilar:

Elige este tipo de app	Si…
App para computadoras	Administras todas tus cuentas de Google Ads con una sola cuenta de administrador de nivel superior. Es la primera vez que usas la plataforma o quieres comenzar a usarla rápidamente con la configuración más simple. Tu app solo autenticará a los usuarios de Google desde una máquina.
App web	Quieres autenticarte como un usuario que puede otorgar permiso a tu app para acceder a los datos de su cuenta de Google Ads. Quieres generar varias credenciales de autorización fácilmente, por ejemplo, para administrar cuentas de terceros. Tu app requiere URLs de devolución de llamada. Las URLs de devolución de llamada no son compatibles con el flujo de apps para computadoras de escritorio.

Punto clave: Puedes elegir el flujo de la app para computadoras de escritorio, incluso si estás desarrollando una app para ejecutar en un servidor. La diferencia es si la autorización de OAuth se completa de forma local o remota. Un flujo para computadoras 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.

Para 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 el tipo de app, sigue las instrucciones que se indican a continuación 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 no configuraste una pantalla de consentimiento de OAuth para este proyecto antes, se te indicará que lo hagas ahora. Haz clic en CONFIGURAR PANTALLA DE CONSENTIMIENTO.

      1. Selecciona el tipo de usuario y haz clic en CREATE.

      2. Completa el formulario inicial. Si es necesario, puedes editar esta información más adelante. Haz clic en Guardar cuando termines.

   2. Vuelve a Credenciales > CREAR CREDENCIALES > ID de cliente de OAuth para continuar.

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

4. Asóciale un nombre y, luego, haz clic en Crear.

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

   Para pruebas locales compatibles con la configuración predeterminada de nuestros ejemplos de bibliotecas 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 no se configura el puerto, un cliente de OAuth puede redireccionar a cualquier puerto.

   En el caso de los clientes de aplicaciones para computadoras, seguirás usando un redireccionamiento de IP de bucle invertido, pero el URI no se configura de forma explícita en la consola de Cloud.

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