Preparar a conta do cliente

Nesta etapa, você vai identificar uma conta do Google Ads para fazer chamadas de API. Você precisa do endereço de e-mail para gerar tokens de atualização do OAuth 2.0. Pode ser uma conta de produção (ativa) ou de teste. Cada abordagem tem vantagens e desvantagens.

Contas de produção
Contas de teste
Vantagens
  • Mais fáceis de escrever e testar códigos que funcionam em conteúdos específicos da conta.
  • Mais fácil de escrever e testar código que processa dados de relatórios em tempo real.
  • As contas de teste não veiculam anúncios. Portanto, os bugs de programação não afetarão suas campanhas ativas.
  • Funciona com tokens de desenvolvedor que têm o nível de acesso de teste.
Desvantagens
  • Um bug de programação na fase de desenvolvimento pode afetar a veiculação da campanha ao vivo, levando a problemas como baixo desempenho da campanha, veiculação incorreta ou perdas financeiras.
  • O token de desenvolvedor precisa ter pelo menos o nível de acesso básico para fazer chamadas de API.
  • Você precisa recriar campanhas nas contas de teste para testar um código que funcione em conteúdos específicos da conta.
  • Como as contas de teste não veiculam anúncios, recursos relacionados à veiculação em tempo real, como estatísticas de relatórios, erros de violação de políticas ou processamento de importações de conversões off-line, não são compatíveis, o que dificulta o teste.

Recomendamos usar uma conta de teste ao desenvolver seu aplicativo quando possível. Para instruções, consulte Criar campanhas e contas de teste.

Uma alternativa é configurar uma conta de produção com um orçamento de conta baixo, como US $1,00/dia, explicitamente para testar recursos que não são compatíveis com uma conta de teste.

Escolha do conjunto de recursos

Ao escolher uma conta para fazer chamadas de API, outra consideração é a lista de recursos que você quer usar com a API. Mesmo que você opte por usar uma conta de produção, existem alguns recursos que são específicos da conta, por exemplo:

  • Para recursos de faturamento, você precisa de uma conta com faturamento mensal.
  • Alguns recursos novos podem estar restritos a uma lista de contas na lista de permissões.

Antes de finalizar a conta para fazer chamadas de API, consulte a documentação do recurso específico para garantir que ele não tenha restrições adicionais.

Acesso do usuário, ID de cliente de login e ID de cliente

Para fazer uma chamada de API para um cliente do Google Ads, você precisa ter acesso a ele diretamente ou por meio de uma conta de administrador vinculada. Você também precisa das permissões adequadas, dependendo da chamada de API específica.

Ao fazer login no Google Ads, você pode escolher entre mais de uma conta de cliente. A conta selecionada estabelece o ID do cliente de login, que é um cabeçalho obrigatório para algumas chamadas de API, e seu nível de acesso.

Depois de identificar o cliente do Google Ads para fazer chamadas de API, observe os seguintes detalhes:

  • O ID de cliente de 10 dígitos da conta de cliente para a qual você planeja fazer chamadas de API. Ele também é chamado de cliente operacional.

  • O endereço de e-mail da conta do cliente em que você fez login. Isso é necessário para gerar o token de atualização do OAuth 2.0.

  • O ID de cliente de login de 10 dígitos da conta de cliente em que você fez login. Se você tiver feito login como cliente operacional, o ID de cliente de login será igual ao ID de cliente.