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 ser adicionado à lista de permissão adequada para se conectar
ao
ReachPlanService, mesmo que já esteja 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 em mais detalhes nas seções a seguir.
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 do cliente específico em que uma campanha seria veiculada.
Ferramentas internas
Se você cria ferramentas para uso interno na sua organização, confira nossas recomendações.
Planejadores sem acesso direto à conta do cliente
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 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.
Planejadores com acesso à conta de cliente
Se os planejadores tiverem acesso a uma conta de administrador do Google Ads que gerencia as contas dos clientes, implemente o fluxo de aplicativo da Web para permitir que o app use as credenciais OAuth dos planejadores. Em seguida, transmita o ID do cliente correspondente ao cliente do seu plano.
Ferramentas externas
Se você criar uma ferramenta para usuários externos, recomendamos abordagens semelhantes:
Contas por cliente
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.
Acesso concedido pelo usuário
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.
A seguir
Saiba como especificar um plano de mídia.