As solicitações para a ReachPlanService precisam fornecer 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 associado às suas credenciais do OAuth precisa ser aprovado para usar esse serviço.
Este guia aborda detalhes de autenticação específicos do
ReachPlanService. Se ainda não tiver feito isso, conclua as etapas descritas em Primeiros passos e volte para este guia.
Credenciais do OAuth
Além das orientações apresentadas em Começar, lembre-se dos seguintes pontos:
- O número do seu projeto do Google Cloud precisa ser adicionado à lista de permissões adequada para se conectar ao
ReachPlanService, mesmo que ele 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 API Google Ads para se conectar a ela.
- O usuário que possui 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 de destino e credenciais do OAuth autorizadas a acessar esse ID.
No entanto, o ReachPlanService é destinado a atividades de planejamento de vídeo que podem ocorrer antes de você estabelecer uma conta de cliente específica para veicular uma campanha.
Ferramentas internas
Se você cria ferramentas para uso interno na sua organização, considere as seguintes opções:
- Planejadores sem acesso direto à conta de cliente: se os planejadores não tiverem acesso às contas do Google Ads dos seus 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 para
ReachPlanService, forneça o ID de cliente correspondente à equipe do 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 seus clientes, implemente o fluxo de autenticação de vários usuários para permitir que o aplicativo use as credenciais do OAuth dos planejadores. Em seguida, transmita o ID de cliente correspondente ao plano do cliente.
Ferramentas externas
Se você cria ferramentas para usuários externos ou de terceiros, recomendamos as seguintes opções:
- 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 para cada cliente externo e vincule-as à sua conta de administrador. Configure sua ferramenta para fornecer o ID de cliente correspondente ao gerar planos.
- Acesso concedido pelo usuário: permita que os usuários concedam à sua ferramenta acesso às contas deles usando o fluxo de autenticação multiusuário. Depois que um usuário conceder permissão, use o
CustomerServicepara recuperar a lista de contas do Google Ads que ele pode acessar.
Antes de integrar a API, selecione uma das abordagens anteriores com base nos requisitos do seu sistema e identifique alguns IDs de cliente de teste. Em caso de dúvida, comece com o fluxo de autenticação de usuário único com contas vinculadas.
A seguir
Saiba como especificar um plano de mídia.