Para analizar nuestros productos y brindar comentarios sobre ellos, únete al canal oficial de Discord de Google Ads en el servidor de la Comunidad de Publicidad y Medición de Google.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 explican los detalles de autenticación específicos de ReachPlanService. Si aún no lo hiciste, primero completa los pasos que se describen en Primeros pasos y, luego, regresa a este punto.
Token de desarrollador y credenciales de OAuth
Además de la guía que se presenta en Primeros pasos, ten en cuenta los siguientes puntos:
Tu token de desarrollador debe estar en la lista de entidades permitidas para conectarse a ReachPlanService, incluso si ya está aprobado para su uso con otros servicios de la API de Google Ads. Para obtener más información, consulta los requisitos de elegibilidad.
Para conectarte a la API de Google Ads, debes aceptar sus Condiciones del Servicio.
El usuario que posee 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 detalles a continuación.
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 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 las actividades de planificación de video que pueden ocurrir antes de que conozcas el ID de cliente específico en el que publicarías una campaña.
Para los socios que crean herramientas para uso interno en su organización, recomendamos una de las siguientes opciones:
Si tus planificadores no tienen acceso a las cuentas de Google Ads de tus clientes, genera credenciales de OAuth con el flujo de aplicación instalada para un usuario con 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 use tu herramienta y vínculalas a tu cuenta de administrador. Cuando realices solicitudes a ReachPlanService, proporciona el ID de cliente correspondiente al equipo de un usuario.
Si tus planificadores tienen acceso a una cuenta de administrador de Google Ads que administra las cuentas de tus clientes: Implementa el flujo de la aplicación web para permitir que tu aplicación 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 crean una herramienta para usuarios externos, recomendamos enfoques similares:
Genera credenciales de OAuth con el flujo de aplicación instalada para un usuario con acceso a la cuenta de administrador de tu token de desarrollador. Crea una cuenta de Google Ads para cada cliente externo y vincúlalas a tu cuenta de administrador. Luego, configura tu herramienta para que proporcione el ID de cliente correspondiente cuando generes planes.
Permite que tus usuarios otorguen acceso a sus cuentas a tu herramienta con el flujo de aplicación web. Una vez que un usuario otorga permiso, usa CustomerService para proporcionarle 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 ReachPlanService. Antes de integrar la API, selecciona uno de los dos enfoques según tu situación e identifica algunos IDs de cliente para realizar pruebas. Si tienes dudas, usa el primer enfoque sugerido para tu tipo de herramienta.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[[["\u003cp\u003eThe ReachPlanService API requires allowlisted access, an approved developer token, OAuth credentials, and a valid customer ID.\u003c/p\u003e\n"],["\u003cp\u003eYour developer token needs to be specifically allowlisted for ReachPlanService, and you must accept the Google Ads API Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eCustomer ID selection depends on whether planners have access to client accounts or use a manager account, impacting OAuth credential flow.\u003c/p\u003e\n"],["\u003cp\u003ePartners building internal tools can choose between using a manager account with linked team accounts or leveraging planners' existing manager account access.\u003c/p\u003e\n"],["\u003cp\u003ePartners building external tools can use a similar approach, either linking client accounts to a manager account or utilizing the web application flow for direct user account access.\u003c/p\u003e\n"]]],[],null,["# Authentication\n\n| **Important:** This feature is available to allowlisted accounts only. Contact your Google representative if you need access to the feature.\n\n\u003cbr /\u003e\n\nRequests to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) must\nsupply an approved developer token, OAuth credentials, and a customer ID that\nyour OAuth credentials can access.\n\nThis guide covers authentication details specific to\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). If you haven't already,\nfirst complete the steps outlined in [Get\nstarted](/google-ads/api/docs/get-started/introduction), then come back to this point.\n\nDeveloper token and OAuth credentials\n-------------------------------------\n\nIn addition to the guidance presented by [Get\nstarted](/google-ads/api/docs/get-started/introduction), keep the following points in mind:\n\n1. Your developer token must be allowlisted to connect to the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService), even if it's already approved for use with other Google Ads API services. For more information, see the [eligibility\n requirements](/google-ads/api/docs/reach-forecasting#eligibility).\n2. You must accept the Google Ads API Terms of Service in order to connect to the Google Ads API.\n3. The user who owns your OAuth refresh token determines which customer IDs you can query in the [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). This informs your integration and is explained in more details below.\n\nCustomer IDs\n------------\n\nMost services within the Google Ads API operate on specific Google Ads accounts and\ncampaigns. As a result, most requests require both a customer ID to identify\nthe account you're managing or querying, and [OAuth\ncredentials](/google-ads/api/docs/oauth/overview) that have permission to access that\ncustomer ID. However, [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService)\nis meant for video planning activities that might occur before you know the\nspecific customer ID where you would run a campaign.\n\nFor partners who build tools for internal use in their organization, we\nrecommend one of the following choices:\n\n1. **If your planners don't have access to your clients' Google Ads accounts** :\n Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Then create or obtain\n a Google Ads account for each team that uses your tool, and [link them to\n your manager account](//support.google.com/google-ads/answer/7459601). When making requests to\n [`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService) provide the customer ID\n corresponding to a user's team.\n\n2. **If your planners have access to a Google Ads manager account that manages\n your clients' accounts** : Implement the *web application flow* to allow your\n app to use your planners' OAuth credentials. Then you can pass in the\n customer ID corresponding to the customer of your plan.\n\nFor partners who build a tool for external users, we recommend similar\napproaches:\n\n1. Generate OAuth credentials using the *installed application flow* for a user\n with access to your developer token's manager account. Create a Google Ads\n account per external client and [link them to your manager\n account](//support.google.com/google-ads/answer/7459601). Then configure your tool to provide a client's\n corresponding customer ID when they're generating plans.\n\n2. Give your users the ability to grant your tool access to their accounts\n by using the *web application flow* . Once a user grants permission, use the\n [`CustomerService`](/google-ads/api/docs/account-management/listing-accounts) to provide\n them with a list of Google Ads accounts they can access.\n\nThe goal is to ensure planners have the lowest possible friction when using the\n[`ReachPlanService`](/google-ads/api/reference/rpc/v21/ReachPlanService). Before you integrate the\nAPI, select one of the two approaches according to your situation and identify\na few customer IDs to test. If in doubt, use the first suggested approach for\nyour tool type."]]
