As solicitações ao ReachPlanService precisam
fornecer as credenciais do OAuth e um ID de cliente que suas credenciais do OAuth possam
acessar. Além disso, o projeto na nuvem do Google Cloud ao qual as credenciais do OAuth pertencem precisa ser aprovado para usar esse serviço.
Este guia aborda detalhes de autenticação específicos do
ReachPlanService. Se você ainda não fez isso,
conclua as etapas descritas em
Primeiros passos e volte a este ponto.
Credenciais de OAuth
Além das orientações apresentadas em Primeiros passos, lembre-se do seguinte:
- O número do seu projeto na nuvem do Google Cloud precisa ser adicionado à lista de permissões 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. - Você precisa 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 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 que tenham permissão para acessar esse
ID de cliente. 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 uma campanha seria veiculada.
Ferramentas internas
Se você criar ferramentas para uso interno na sua organização, confira nossas recomendações.
Planejadores sem acesso direto à conta de cliente
Se seus planejadores não tiverem acesso às contas do Google Ads dos clientes,
gere credenciais do OAuth usando o fluxo de autenticação de usuário único para um usuário com acesso à
sua conta de administrador. Em seguida, crie ou receba uma conta do Google Ads para cada equipe
que usa sua ferramenta e vincule-as à sua conta de administrador.
Ao fazer solicitações ao ReachPlanService
forneça o ID de cliente correspondente à equipe de um usuário.
Planejadores com acesso à conta de cliente
Se seus planejadores tiverem acesso a uma conta de administrador do Google Ads que gerencia as contas dos clientes, implemente o fluxo de autenticação multiusuário para permitir que seu app use as credenciais do OAuth dos planejadores. Em seguida, você pode transmitir o ID de cliente correspondente ao cliente do seu plano.
Ferramentas externas
Se você criar uma ferramenta para usuários externos, recomendamos abordagens semelhantes:
Por contas de cliente
Gere credenciais do OAuth usando o fluxo de autenticação de usuário único para um usuário com acesso à sua conta de administrador. Crie uma conta do Google Ads por cliente externo e vincule-as à sua conta de administrador. Em seguida, configure sua ferramenta para fornecer o ID de cliente correspondente de um cliente quando ele estiver gerando planos.
Acesso concedido pelo usuário
Ofereça aos usuários a capacidade de conceder acesso à ferramenta às contas deles
usando o fluxo de autenticação multiusuário. Depois que um usuário conceder
permissão, use o
CustomerService para fornecer
uma lista de contas do Google Ads que ele pode acessar.
O objetivo é garantir que os planejadores tenham o mínimo de 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 teste. 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.