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 dele para gerar tokens de atualização do OAuth 2.0. 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 facilidade para escrever e testar um código que funcione com 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 as 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 da campanha ativa, levando a problemas como desempenho insatisfatório 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 as campanhas nas contas de teste para testar códigos que funcionam com conteúdos específicos da conta. Como as contas de teste não veiculam anúncios, não há suporte para 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. Isso dificulta o teste desses recursos.

Recomendamos usar uma conta de teste ao desenvolver seu aplicativo quando 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 em uma conta de teste.

Escolha do conjunto de atributos

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ê escolha usar uma conta de produção, há alguns recursos específicos da conta, por exemplo:

• Para usar os recursos de faturamento, você precisa de uma conta com faturamento mensal.
• Alguns recursos novos podem estar restritos a uma lista de contas permitidas.

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.

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

Para fazer uma chamada de API a um cliente do Google Ads, você precisa ter acesso a ele diretamente ou por 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 ter mais de uma conta de cliente para escolher. A conta selecionada estabelece o ID de 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 o qual fazer chamadas de API, observe os seguintes detalhes:

• O ID de cliente de 10 dígitos da conta de cliente à 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 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.