O teste é uma etapa importante na criação de uma integração bem-sucedida da Google Ads API, esteja você apenas começando, fazendo a manutenção de um aplicativo 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
As contas de teste estão disponíveis para fins de desenvolvimento. Embora nem todos os recursos possam ser testados em uma conta de teste, essa ainda é uma ferramenta útil para validar 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 impedem que você teste alguns recursos na integração, é possível usar uma conta de produção para desenvolvimento. As contas de produção para desenvolvimento têm as seguintes diferenças em relação às de teste:
- Veicule 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 desempenho e desbloquear todos os outros recursos da API Google Ads.
Ao mesmo tempo, o uso delas para desenvolvimento requer cautela adicional. Recomendamos tomar as seguintes medidas:
- Conceda acesso apenas a usuários que precisem dele para fins de desenvolvimento.
- Definir um orçamento diário baixo e fixo da conta.
- Use contas de produção para desenvolvimento somente quando não for possível usar contas de teste.
Credenciais de teste
Para minimizar o risco de modificar acidentalmente as 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 a criação de tokens de atualização separados para fins de desenvolvimento.
Um token de atualização é gerado quando um usuário autoriza um app a acessar a Google Ads API em nome dele. Assim, cada token de atualização tem o mesmo acesso que o usuário autorizado. Se todos os tokens de atualização usados para acessar contas de desenvolvimento estiverem associados a usuários que não têm acesso a 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. 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 as contas de teste, desde que o token de atualização seja distinto.
Validação da solicitaçã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 as políticas), use o campo validate_only, que está disponível para solicitações GoogleAdsService.SearchStream e GoogleAdsService.Search, 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
Em testes ad hoc, por exemplo, para validar se uma solicitação produz a saída esperada, usar a API REST costuma ser a opção mais fácil. Consulte os exemplos da REST para saber como usar o cURL ao fazer solicitações à API REST.