Las solicitudes a ReachPlanService deben
proporcionar las credenciales de OAuth y un ID de cliente al que puedan acceder tus credenciales de OAuth. Además, el proyecto de Google Cloud al que pertenecen las credenciales de OAuth debe estar aprobado para usar este servicio.
En esta guía, se incluyen detalles de autenticación específicos de
ReachPlanService. Si aún no lo hiciste,
primero completa los pasos que se describen en
Cómo comenzar y, luego, regresa a este punto.
Credenciales de OAuth
Además de la orientación que se presenta en Cómo comenzar, ten en cuenta lo siguiente:
- El número de tu proyecto de Google Cloud debe agregarse a la lista de entidades permitidas correspondiente
para conectarse a
ReachPlanService, incluso si ya está aprobado para usarlo con otros servicios de la API de Google Ads. Para obtener más información, consulta los requisitos de elegibilidad. - Debes aceptar las Condiciones del Servicio de la API de Google Ads para conectarte a la API de Google Ads.
- El usuario que posee tu token de actualización de OAuth determina qué IDs de cliente tú
puedes consultar en el
ReachPlanService. Esto informa tu integración y se explica con más detalle en las siguientes secciones.
ID del cliente
La mayoría de los servicios de la API de Google Ads operan en cuentas y campañas específicas de Google Ads. Como resultado, la mayoría de las solicitudes requieren un ID de cliente para identificar
la cuenta que administras o consultas, y credenciales
de OAuth que tengan permiso para acceder a ese
ID de cliente. Sin embargo, ReachPlanService
está diseñado para actividades de planificación de video que podrían ocurrir antes de que conozcas el
ID de cliente específico en el que publicarías una campaña.
Herramientas internas
Si compilas herramientas para uso interno en tu organización, estas son nuestras recomendaciones.
Planificadores sin acceso directo a la cuenta de cliente
Si tus planificadores no tienen acceso a las cuentas de Google Ads de tus clientes,
genera credenciales de OAuth con el flujo de autenticación de un solo usuario para un usuario con acceso a
tu cuenta de administrador. Luego, crea u obtén una cuenta de Google Ads para cada equipo
que use tu herramienta y vincúlalas a tu cuenta de administrador.
Cuando realices solicitudes a ReachPlanService
proporciona el ID de cliente correspondiente al equipo de un usuario.
Planificadores con acceso a la cuenta de cliente
Si tus planificadores tienen acceso a una cuenta de administrador de Google Ads que administra las cuentas de tus clientes, implementa el flujo de autenticación multiusuario para permitir que tu app use las credenciales de OAuth de tus planificadores. Luego, puedes pasar el ID de cliente correspondiente al cliente de tu plan.
Herramientas externas
Si compilas una herramienta para usuarios externos, te recomendamos enfoques similares:
Cuentas por cliente
Genera credenciales de OAuth con el flujo de autenticación de un solo usuario para un usuario con acceso a tu cuenta de administrador. Crea una cuenta de Google Ads por cliente externo y vincúlalas a tu cuenta de administrador. Luego, configura tu herramienta para proporcionar el ID de cliente correspondiente de un cliente cuando genere planes.
Acceso otorgado por el usuario
Permite que tus usuarios otorguen acceso a tu herramienta a sus cuentas
mediante el flujo de autenticación multiusuario. Una vez que un usuario otorga
permiso, usa
CustomerService para proporcionar
una lista de las cuentas de Google Ads a las que puede acceder.
El objetivo es garantizar que los planificadores tengan la menor fricción posible cuando usen el
ReachPlanService. Antes de integrar la API, selecciona uno de los dos enfoques según tu situación y, luego, identifica algunos IDs de cliente para probar. En caso de duda, usa el primer enfoque sugerido para tu tipo de herramienta.
¿Qué sigue?
Obtén información para especificar un plan de medios.