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 app para 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 APIs 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 del permiso de la API de Google Ads deberá someterse a una verificación de OAuth de Google para evitar que los usuarios vean una pantalla de la IU no verificada. 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 de las opiniones que se realizan 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, ya que 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 Google OAuth lo antes posible para evitar interrupciones en el 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.
Cómo habilitar 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 enumera todas las APIs disponibles, agrupadas por familia de productos y popularidad.
Use 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.
Elige un tipo de usuario y el 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 estas opciones 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 |
|
Externa | Prueba |
|
Interno | En producción |
|
Externa | En producción |
|
Si no se completa la verificación de OAuth de Google, se generará lo siguiente, sin importar el tipo de usuario o el estado de la publicación de tu proyecto:
Durante el proceso de autorización, se les presenta a los usuarios una pantalla de IU sin verificar.
Solo puedes autorizar a 100 usuarios.
Cómo configurar la 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. Haz clic en GUARDAR Y CONTINUAR cuando termines.
En la página siguiente, haz clic en AGREGAR O QUITAR ÁMBITOS.
Desplázate hacia abajo y, luego, ingresa lo siguiente en el campo debajo de Agregar permisos de forma manual:
https://www.googleapis.com/auth/adwords
Haz 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.
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.
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 su Estado de publicación de Prueba a En producción.
Selecciona un tipo de app
Existen dos opciones de tipos de aplicación para la API de Google Ads: Computadora de escritorio o Web. Consulta la siguiente tabla para determinar qué tipo es el más apropiado para la app que quieres compilar:
Elegir este tipo de app | Si ... |
---|---|
App para computadoras |
|
App web |
|
Si quieres obtener más información, consulta la documentación de OAuth de Google Identity Platform para apps de escritorio o apps web.
Crea un ID de cliente y un secreto de cliente
Una vez que hayas determinado el tipo de app, sigue las instrucciones que aparecen a continuación para generar el ID y el secreto del cliente de OAuth2:
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 nunca habías configurado una pantalla de consentimiento de OAuth para este proyecto, se te indicará que lo hagas ahora. 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.
Vuelve a Credenciales > CREAR CREDENCIALES > ID de cliente de OAuth para continuar.
Selecciona Aplicación de escritorio o Aplicación web como el tipo de aplicación, según tu caso de uso.
Asígnale un nombre y haz clic en Crear.
Si tu tipo de cliente es Aplicación web, agrega al menos un URI de redireccionamiento autorizado.
Para realizar pruebas locales que sean compatibles con la configuración predeterminada en nuestros ejemplos de bibliotecas cliente, usa
http://127.0.0.1
.Para los clientes de la app de escritorio, 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.
En la página de confirmación, copia Your Client ID y Your Client Secret en el portapapeles, ya que los necesitarás cuando configures la biblioteca cliente. También puedes volver a la página de credenciales más adelante para recuperar estos detalles.