Os testes são uma etapa importante na criação de uma integração bem-sucedida da API Google Ads, seja para iniciantes, manter um app ou adicionar novos recursos a uma integração atual. Este guia apresenta algumas práticas recomendadas para testar a integração da API Google Ads.
Contas de teste
As contas de teste estão disponíveis para fins de desenvolvimento. Nem todos os recursos podem ser testados em uma conta de teste, mas essa é uma ferramenta útil para confirmar se o código e a configuração do aplicativo estão funcionando conforme o esperado.
A produção é responsável pelo desenvolvimento
Quando as limitações da conta de teste impedirem que você teste alguns recursos na sua integração, você poderá usar uma conta de produção para 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, permitindo que você teste relatórios de desempenho e desbloqueie todos os outros recursos da API Google Ads.
Ao mesmo tempo, usá-las para desenvolvimento exige cuidado adicional. 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 baixo e fixo para a conta.
- Use contas de produção para desenvolvimento somente quando as contas de teste não puderem ser usadas.
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.
Também recomendamos criar tokens de atualização separados para fins de desenvolvimento.
Um token de atualização é gerado quando um usuário autoriza um aplicativo a acessar a API Google Ads em nome dele. Portanto, cada token de atualização tem o mesmo acesso que o usuário autorizado. Se todos os tokens de atualização usados para acessar as contas de desenvolvimento estiverem associados a usuários que não têm acesso às contas de produção, incluindo contas de administrador que gerenciam contas de produção, o risco de usar acidentalmente um token de atualização de teste para modificar uma conta de produção será reduzido.
Como o acesso depende do token de atualização usado, não é necessário criar credenciais de teste que não sejam tokens de atualização de teste. O token de desenvolvedor, o ID e a chave secreta do cliente usados para acessar as contas de produção podem ser usados com segurança para acessar contas de teste, desde que o token de atualização seja diferente.
Validação da solicitaçã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, assim como a maioria das solicitações de modificação.
Consulte a documentação de referência para verificar se esse
campo está disponível para determinado método.
API REST
Para testes ad hoc, por exemplo, para confirmar que uma solicitação produz a saída esperada, o uso da API REST geralmente é a opção mais fácil. Consulte os exemplos de REST para saber como usar o cURL ao fazer solicitações à API REST.