Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As solicitações para ReachPlanService precisam fornecer um token de desenvolvedor aprovado, credenciais do OAuth e um ID do cliente que suas credenciais do OAuth podem acessar.
Este guia aborda detalhes de autenticação específicos para
ReachPlanService. Se você ainda não fez isso, siga as etapas descritas em Começar e volte a este ponto.
Token de desenvolvedor e credenciais OAuth
Além da orientação apresentada em Começar, lembre-se do seguinte:
Seu token de desenvolvedor precisa estar na lista de permissões para se conectar ao
ReachPlanService, mesmo que já tenha sido aprovado para uso com outros serviços da API Google Ads. Para mais informações, consulte os requisitos de qualificação.
É necessário aceitar os Termos de Serviço da API Google Ads para se conectar a ela.
O usuário proprietário do seu token de atualização do OAuth determina quais IDs de cliente você pode consultar no ReachPlanService.
Isso informa sua integração e é explicado com mais detalhes abaixo.
IDs do cliente
A maioria dos serviços na API Google Ads opera em contas e campanhas específicas do Google Ads. Como resultado, a maioria das solicitações exige um ID de cliente para identificar a conta que você está gerenciando ou consultando e credenciais do OAuth com permissão para acessar esse ID de cliente. No entanto, o ReachPlanService
é destinado a atividades de planejamento de vídeo que podem ocorrer antes de você saber o
ID de cliente específico em que uma campanha seria veiculada.
Para parceiros que criam ferramentas para uso interno na organização, recomendamos uma das seguintes opções:
Se seus planejadores não tiverem acesso às contas do Google Ads dos clientes:
gere credenciais do OAuth usando o fluxo de aplicativo instalado para um usuário
com acesso à conta de administrador do seu token de desenvolvedor. Em seguida, crie ou obtenha uma conta do Google Ads para cada equipe que usa sua ferramenta e vincule-as à sua conta de administrador. Ao fazer solicitações para
ReachPlanService, forneça o ID do cliente
correspondente à equipe de um usuário.
Se os planejadores tiverem acesso a uma conta de administrador do Google Ads que gerencia as contas dos clientes: implemente o fluxo de aplicativos da Web para permitir que seu app use as credenciais OAuth dos planejadores. Em seguida, transmita o ID do cliente correspondente ao cliente do seu plano.
Para parceiros que criam uma ferramenta para usuários externos, recomendamos abordagens
semelhantes:
Gere credenciais do OAuth usando o fluxo de aplicativo instalado para um usuário
com acesso à conta de administrador do seu token de desenvolvedor. Crie uma conta do Google Ads para cada cliente externo e vincule-as à sua conta de administrador. Em seguida, configure sua ferramenta para fornecer o ID do cliente correspondente
ao gerar planos.
Use o fluxo de aplicativo da Web para permitir que os usuários concedam acesso às contas deles para sua ferramenta. Depois que um usuário concede permissão, use o
CustomerService para fornecer
uma lista de contas do Google Ads a que ele pode acessar.
O objetivo é garantir que os planejadores tenham a menor fricção possível ao usar o
ReachPlanService. Antes de integrar a API, selecione uma das duas abordagens de acordo com sua situação e identifique alguns IDs de clientes para testar. Em caso de dúvida, use a primeira abordagem sugerida para
seu tipo de ferramenta.
[null,null,["Última atualização 2025-08-27 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."]]
