Os testes são uma etapa importante para criar uma integração bem-sucedida da API Google Ads, seja para quem está começando, mantendo um app ou adicionando novos recursos a uma integração existente. Este guia apresenta algumas práticas recomendadas para testar sua integração da API Google Ads.
Contas de teste e de produção
Contas de teste estão disponíveis para fins de desenvolvimento. Com as contas de teste, 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 sua integração, use uma conta de produção para o desenvolvimento. As contas de produção para desenvolvimento diferem das contas de teste das seguintes maneiras:
- Veicular anúncios que podem ser vistos pelos usuários
- Exigir URLs válidos
- Precisa 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 performance e desbloquear todos os outros recursos da API Google Ads. No entanto, é preciso ter muito cuidado ao usá-los para desenvolvimento. Recomendamos que você tome as seguintes medidas:
- Conceda acesso apenas aos usuários que precisam dele para fins de desenvolvimento.
- Defina um orçamento diário fixo e baixo para a conta.
- Use contas de produção para desenvolvimento somente quando não for possível usar contas de teste.
Portanto, para fazer testes completos da sua integração, provavelmente você vai precisar de credenciais de teste e de produção.
Credenciais de teste
Para minimizar o risco de modificar acidentalmente contas de produção ao tentar modificar 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 a esse usuário ou conta de serviço acesso a nenhuma conta de produção.
- Se você estiver usando o fluxo de autenticação de usuário do OAuth 2.0 em vez do fluxo de conta de serviço, gere um token de atualização para sua conta de usuário de teste.
- Use essas novas credenciais ao testar seu aplicativo. O token de desenvolvedor, o ID e a chave secreta do cliente podem ser reutilizados para fins de teste, já que não afetam a determinação de quais contas do Google Ads podem ser acessadas.
Solicitar validação
Se você só precisar testar se uma solicitação é válida, por exemplo, para verificar se ela está estruturada corretamente e não viola as políticas, use o campo validate_only, que está disponível para solicitações GoogleAdsService.SearchStream e GoogleAdsService.Search, além da 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, usar a API REST geralmente é a opção mais fácil. Consulte os exemplos de REST para saber como usar curl ao fazer solicitações à API REST. Teste também no REST Explorer.