Las solicitudes a la ReachPlanService deben proporcionar credenciales de OAuth y un ID de cliente al que puedan acceder tus credenciales de OAuth. Además, el proyecto de Google Cloud asociado con tus credenciales de OAuth debe
aprobarse 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 Comienza y, luego, regresa a esta guía.
Credenciales de OAuth
Además de la orientación que se presenta en Comienza a usar la API, ten en cuenta los siguientes puntos:
- Tu número de proyecto de Google Cloud debe agregarse a la lista de entidades permitidas correspondiente
para conectarse a la
ReachPlanService, incluso si ya se aprobó para su uso 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 ella.
- El usuario propietario de tu token de actualización de OAuth determina los IDs de cliente que puedes consultar en
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. Por lo tanto, la mayoría de las solicitudes requieren un ID de cliente para identificar la cuenta de destino y credenciales de OAuth autorizadas para acceder a ese ID de cliente.
Sin embargo, ReachPlanService está diseñado para las actividades de planificación de videos que podrían ocurrir antes de que establezcas una cuenta de cliente específica para publicar una campaña.
Herramientas internas
Si creas herramientas para uso interno dentro de tu organización, considera las siguientes opciones:
- 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 que corresponda al equipo del 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 aplicación use las credenciales de OAuth de tus planificadores. Luego, puedes pasar el ID de cliente correspondiente al plan del cliente.
Herramientas externas
Si compilas herramientas para usuarios externos o de terceros, te recomendamos las siguientes opciones:
- Cuentas de 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 cada cliente externo y vincúlalas a tu cuenta de administrador. Configura tu herramienta para que proporcione el ID de cliente correspondiente cuando genere planes.
- Acceso otorgado por el usuario: Permite que los usuarios otorguen a tu herramienta acceso a sus
cuentas con el flujo de autenticación
multiusuario. Una vez que un usuario otorgue el permiso, usa el
CustomerServicepara recuperar la lista de cuentas de Google Ads a las que puede acceder.
Antes de integrar la API, selecciona uno de los enfoques anteriores según los requisitos del sistema y, luego, identifica algunos IDs de cliente de prueba. Si tienes dudas, comienza con el flujo de autenticación de un solo usuario con cuentas vinculadas.
¿Qué sigue?
Obtén más información para especificar un plan de medios.