Preparar a conta do cliente

Observação: a etapa atual deste tutorial depende do tipo de aplicativo que você está criando. Recomendamos usar uma conta de serviço para fazer chamadas de API. No entanto, a opção de autenticação do usuário também é oferecida como alternativa. O restante deste tutorial será personalizado com base na sua escolha.

Contas de serviço Autenticação de usuário

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

	Contas de produção	Contas de teste
Vantagens	É mais fácil escrever 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. Portanto, bugs de programação não afetam suas campanhas ativas. Funciona com tokens de desenvolvedor que têm nível de acesso de teste.
Desvantagens	Um bug de programação na fase de desenvolvimento pode afetar a veiculação de campanhas ativas, 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 em 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 em tempo real, como estatísticas de relatórios, erros de violação da política ou processamento de importações de conversão off-line, não são compatíveis, o que dificulta o teste desses recursos.

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

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

Escolha do conjunto de atributos

Ao escolher uma conta para fazer chamadas 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 de uma conta com faturamento mensal.
• Alguns novos recursos da conta podem ser restritos por listas de permissão.

Antes de finalizar a conta para fazer chamadas de API, consulte a documentação do recurso específico para verificar se ele não tem outras restrições.

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

Para fazer uma chamada de API a um cliente do Google Ads, você precisa conceder acesso e permissões adequadas à sua conta de serviço na conta do cliente, diretamente ou por uma conta de administrador vinculada. Para fazer 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 que você seleciona estabelece o ID de 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, anote os seguintes detalhes:

• O ID de cliente de 10 dígitos da conta de cliente em que você planeja fazer chamadas de API. Às vezes, ele é chamado de cliente operacional.

• O ID de cliente de login com 10 dígitos da conta de cliente em que você fez login. Se você fez login como o cliente operacional, o ID do cliente de login é 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. Faça login na sua conta do Google Ads como administrador e 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 "E-mail" 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 as suas chamadas de API exigirem acesso de administrador, faça 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.