Las solicitudes a ReachPlanService deben
proporcionar un token de desarrollador aprobado, credenciales de OAuth y un ID de cliente al que
puedan acceder tus credenciales de OAuth.
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, vuelve a este punto.
Token de desarrollador y credenciales de OAuth
Además de la orientación que se presenta en Cómo comenzar, ten en cuenta lo siguiente:
- Tu token de desarrollador debe agregarse a la lista de entidades permitidas correspondiente para conectarse
a
ReachPlanService, incluso si ya está aprobado para usarse 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
la cuenta de administrador de tu token de desarrollador. Luego, crea o adquiere
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 de varios usuarios 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:
Por cuentas de cliente
Genera credenciales de OAuth con el flujo de autenticación de un solo usuario para un usuario con acceso a la cuenta de administrador de tu token de desarrollador. 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 de varios usuarios. 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.