As solicitações para o ReachPlanService precisam fornecer um token de desenvolvedor aprovado, credenciais de OAuth e um ID de cliente que suas credenciais de OAuth possam acessar.
Este guia aborda detalhes de autenticação específicos para
ReachPlanService. Primeiro, conclua as etapas descritas em Começar,
se ainda não tiver feito isso, e volte a este ponto.
Token de desenvolvedor e credenciais do OAuth
Além das orientações apresentadas em Começar, lembre-se dos seguintes pontos:
- 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. - Você precisa aceitar os Termos de Serviço da Google Ads API para se conectar a ela.
- O usuário proprietário do token de atualização OAuth determina quais IDs de cliente podem ser consultados no
ReachPlanService. Isso informa sua integração e é explicado em mais detalhes abaixo.
IDs do cliente
A maioria dos serviços da API Google Ads funciona em contas e campanhas específicas do Google Ads. Consequentemente, a maioria das solicitações exige um ID de cliente para identificar a conta que você está gerenciando ou consultando, e credenciais do OAuth que tenham permissão para acessar esse ID. No entanto, ReachPlanService é destinado a atividades de planejamento de vídeo que podem ocorrer antes de você saber o ID de cliente específico em que veicularia uma campanha.
Para parceiros que criam ferramentas para uso interno na organização, recomendamos uma das seguintes opções:
Se os planejadores não têm acesso às contas do Google Ads dos seus clientes: gere credenciais de OAuth usando o fluxo de aplicativos instalados para um usuário com acesso à conta de administrador do seu token de desenvolvedor. Em seguida, crie ou crie uma conta do Google Ads para cada equipe que usa sua ferramenta e vincule-a à sua conta de administrador. Ao fazer solicitações para
ReachPlanService, forneça o ID de cliente correspondente à equipe de um usuário.Se os planejadores têm 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 o app use as credenciais de OAuth dos planejadores. Em seguida, transmita o ID de 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 aplicativos instalados 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-a à sua conta de administrador. Em seguida, configure a ferramenta para fornecer o ID de cliente correspondente a um cliente ao gerar planos.
Ofereça aos usuários a capacidade de conceder à sua ferramenta acesso às contas deles usando o fluxo de aplicativos da Web. Depois que a permissão for concedida, use
CustomerServicepara fornecer a ele uma lista de contas do Google Ads que ele pode acessar.
O objetivo é garantir que os planejadores tenham o menor atrito 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 cliente para testar. Em caso de dúvida, use a primeira abordagem sugerida para
seu tipo de ferramenta.