Autenticación

Importante: Esta función solo está disponible para las cuentas incluidas en la lista de entidades permitidas. Comunícate con tu representante de Google si necesitas acceder a la función.

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 abordan los 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.

Token de desarrollador y credenciales de OAuth

Además de la orientación que se ofrece en Comenzar, ten en cuenta lo siguiente:

1. Tu token de desarrollador debe estar en la lista de entidades permitidas 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.
2. Debes aceptar las Condiciones del Servicio de la API de Google Ads para conectarte a la API de Google Ads.
3. El usuario que es propietario de tu token de actualización de OAuth determina qué IDs de cliente puedes consultar en ReachPlanService. Esto informa tu integración y se explica con más detalles a continuación.

ID del cliente

La mayoría de los servicios dentro de la API de Google Ads operan en campañas y cuentas de Google Ads específicas. Como resultado, la mayoría de las solicitudes requieren un ID de cliente a fin de identificar la cuenta que estás administrando o consultando, y credenciales de OAuth que tienen permiso para acceder a ese ID de cliente. Sin embargo, ReachPlanService está diseñado para actividades de planificación de video que pueden ocurrir antes de que sepas el ID de cliente específico en el que publicarías una campaña.

Para los socios que compilan herramientas de uso interno en su organización, recomendamos una de las siguientes opciones:

1. Si tus planificadores no tienen acceso a las cuentas de Google Ads de tus clientes: Genera credenciales de OAuth mediante el flujo de aplicaciones instalada para un usuario que tenga acceso a la cuenta de administrador de tu token de desarrollador. Luego, crea u obtén una cuenta de Google Ads para cada equipo que utilice tu herramienta y vincúlalos a tu cuenta de administrador. Cuando realices solicitudes a ReachPlanService, proporciona el ID de cliente correspondiente al equipo de un usuario.

2. Si tus planificadores tienen acceso a una cuenta de administrador de Google Ads que administra las cuentas de tus clientes, implementa el flujo de aplicación web 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.

En el caso de los socios que compilan una herramienta para usuarios externos, recomendamos enfoques similares:

1. Genera credenciales de OAuth mediante el flujo de aplicación instalada para un usuario con acceso a la cuenta de administrador del token de desarrollador. Crea una cuenta de Google Ads por cliente externo y vincúlalos a tu cuenta de administrador. Luego, configura tu herramienta para proporcionar el ID de cliente correspondiente a un cliente cuando genere planes.

2. Otórgales a los usuarios la capacidad de otorgar a la herramienta acceso a sus cuentas mediante el flujo de aplicación web. Una vez que el usuario otorgue permiso, usa el CustomerService para proporcionarle una lista de las cuentas de Google Ads a las que puede acceder.

El objetivo es asegurarse de que los planificadores tengan la menor fricción posible cuando usen ReachPlanService. Antes de integrar la API, selecciona uno de los dos enfoques según tu situación y, luego, identifica algunos ID de cliente para probar. Si tienes dudas, usa el primer enfoque sugerido para tu tipo de herramienta.