Os testes são uma etapa importante na criação de uma integração bem-sucedida da API Google Ads, seja você um iniciante, esteja fazendo a manutenção de um app ou adicionando novos recursos a uma integração. Este guia apresenta algumas práticas recomendadas para testar a integração da API Google Ads.
Contas de teste e de produção
As contas de teste estão disponíveis para fins de desenvolvimento. Com elas, você pode validar se o código e a configuração do aplicativo estão funcionando conforme o esperado.
No entanto, nem todos os recursos podem ser testados em uma conta de teste.
Quando as limitações da conta de teste impedem que você teste alguns recursos na integração, use uma conta de produção para desenvolvimento. As contas de produção para desenvolvimento são diferentes das contas de teste das seguintes maneiras:
- Veiculam anúncios que podem ser vistos pelos usuários.
- Exigem URLs válidos.
- Precisam obedecer às políticas de publicidade.
Como as contas de produção veiculam anúncios, elas geram métricas que permitem testar relatórios de desempenho e desbloquear todos os outros recursos da API Google Ads. No entanto, o uso delas para desenvolvimento exige mais cuidado. Recomendamos que você tome as seguintes medidas:
- Conceda acesso apenas aos usuários que precisam dele para fins de desenvolvimento.
- Defina um orçamento da conta diário fixo e baixo.
- Use contas de produção para desenvolvimento apenas quando as contas de teste não puderem ser usadas.
Portanto, para fazer testes completos da integração, você provavelmente precisará de credenciais de teste e de produção.
Credenciais para o teste
Para minimizar o risco de modificar acidentalmente as contas de produção ao tentar modificar as contas de desenvolvimento, recomendamos manter um conjunto de credenciais de teste separadas das credenciais do aplicativo de produção.
Para criar um conjunto de credenciais de teste:
- Crie uma conta de e-mail (por exemplo, api.test@example.com) ou uma conta de serviço que será usada apenas para fins de teste.
- Adicione esse usuário ou conta de serviço como um usuário válido nas contas do Google Ads em que você está executando os testes. Confira se você concedeu os níveis de acesso adequados a esse usuário ou conta de serviço. Não conceda acesso a nenhuma conta de produção a este usuário ou conta de serviço.
- Se você estiver usando o fluxo de autenticação do usuário do OAuth 2.0, em vez do fluxo da conta de serviço, gere um token de atualização para a conta de usuário de teste.
- Use essas novas credenciais ao testar o aplicativo. O token de desenvolvedor, o ID do cliente e o segredo do cliente podem ser reutilizados para fins de teste, já que não têm efeito na determinação de quais contas do Google Ads podem ser acessadas.
Solicitar validação
Se você só precisa testar se uma solicitação é válida, por exemplo, para
verificar se ela está estruturada corretamente e não viola
políticas, use o
validate_only
campo, que está disponível para GoogleAdsService.SearchStream e
GoogleAdsService.Search solicitações, bem como para a maioria das solicitações de mutação.
Consulte a documentação de referência para verificar
se esse campo está disponível para um determinado método.
API REST
Para testes ad hoc, por exemplo, para validar se uma solicitação gera a saída esperada, o uso da API REST costuma ser a opção mais fácil. Consulte os exemplos de REST para saber como usar o curl ao fazer solicitações para a API REST. Além disso, tente testar no Explorador de REST.