Testando

Os testes são uma etapa importante para criar uma integração bem-sucedida da Google Ads API, não importa se você está começando, mantendo um aplicativo no momento ou adicionando novos recursos a uma integração existente. Neste guia, apresentamos 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. Embora nem todos os recursos possam ser testados em uma conta de teste, ela ainda é uma ferramenta útil para validar se o código e a configuração do seu 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 integração, use uma conta de produção para desenvolvimento. As contas de produção para desenvolvimento diferem das contas de teste dos seguintes modos:

  • Veicular anúncios que podem ser vistos pelos usuários
  • Exigir URLs válidos
  • Precisa estar em conformidade com as políticas de publicidade

Como as contas de produção veiculam anúncios, elas geram métricas para você testar relatórios de desempenho e desbloquear todos os outros recursos da API Google Ads.

Ao mesmo tempo, seu uso para o desenvolvimento exige cuidado adicional. Recomendamos que você tome as seguintes medidas:

  • Conceda acesso apenas a usuários que precisem 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 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 aplicativo 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 as 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 diferentes dos 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ó 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, 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 um determinado método.

API REST

Em testes ad hoc, por exemplo, para validar se uma solicitação gera 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.