Preparar a conta do cliente

Nesta etapa, você identifica uma conta do Google Ads para fazer chamadas de API. A conta pode ser de produção (ativa) ou de teste. Cada abordagem tem vantagens e desvantagens.

Contas de produção
Contas de teste
Vantagens
  • É mais fácil programar e testar códigos que funcionam com conteúdos específicos da conta.
  • É mais fácil escrever e testar códigos que processam dados de relatórios em tempo real.
  • As contas de teste não veiculam anúncios. Por isso, bugs de programação não afetam 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 ativa, causando problemas como desempenho ruim, 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.
  • É necessário reconstruir campanhas nas contas de teste para testar o código que funciona com conteúdos específicos da conta.
  • Como as contas de teste não veiculam anúncios, os recursos relacionados à veiculação ativa, como estatísticas de relatórios, erros de violação de política ou processamento de importações de conversões off-line, não são compatíveis. Isso dificulta o teste desses recursos.

Recomendamos usar uma conta de teste durante o desenvolvimento do aplicativo, sempre que possível. Para instruções, consulte Criar contas e campanhas de teste.

Uma alternativa é configurar uma conta de produção com um orçamento baixo, como US $1/dia, explicitamente para testar recursos que não têm suporte a uma conta de teste.

Escolha do conjunto de recursos

Ao escolher uma conta para fazer a chamada de API, considere também a lista de recursos que você quer usar com a API. Mesmo que você escolha usar uma conta de produção, alguns recursos são específicos da conta, por exemplo:

  • Para usar os recursos de faturamento, você precisa ter uma conta com faturamento mensal.
  • Alguns recursos novos na conta podem ser restritos por listas de permissões.

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

Identificar o ID de cliente de login e o ID de cliente

Para fazer uma chamada de API para um cliente do Google Ads, você precisa conceder acesso e as permissões apropriadas à sua conta de serviço para a conta do cliente diretamente ou por uma conta de administrador vinculada. Para isso, você precisa ter acesso de administrador à conta do cliente.

Comece fazendo login na sua conta do Google Ads como administrador. Em alguns casos, você pode ter mais de uma conta de cliente para escolher. A conta selecionada estabelece o ID do cliente de login, que é um cabeçalho obrigatório para algumas chamadas de API.

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ê pretende fazer chamadas de API. Às vezes, isso é chamado de cliente operacional.

  • O ID de cliente de login de 10 dígitos da conta de cliente em que você fez login. Se você tiver feito login no cliente operacional, o ID de cliente de login será o mesmo que o ID do cliente. Se você fez login em uma conta de administrador do cliente operacional, o ID de cliente de login é o ID de cliente da conta de administrador.

Conceder acesso à conta de serviço

  1. Com a conta do Google Ads aberta como administrador, acesse Administrador > Acesso e segurança.

  2. Clique no botão + na guia Usuários.

  3. Digite o endereço de e-mail da conta de serviço na caixa de entrada E-mail. Selecione o nível de acesso à conta adequado e clique no botão Adicionar conta. O nível de acesso a e-mails não é compatível com contas de serviço.

  4. A conta de serviço recebe acesso.

Por padrão, não é possível conceder acesso de administrador a uma conta de serviço. Se suas chamadas de API exigirem acesso de administrador, você poderá fazer upgrade do acesso da seguinte maneira.

  1. Clique na seta suspensa ao lado do nível de acesso da conta de serviço na coluna Nível de acesso.

  2. Selecione Administrador na lista suspensa.