Os testes são uma etapa importante na criação de 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
As contas de teste estão disponíveis para fins de desenvolvimento. Com as contas de teste, é possível validar se o código do aplicativo e a configuração 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. Seu projeto do Google Cloud precisa ter pelo menos o nível de acesso do Explorer (Explorer, Basic ou Standard) para chamar uma conta de produção. O acesso ao Explorer ainda restringe alguns serviços, incluindo faturamento (BillingSetupService e AccountBudgetProposalService), planejamento, criação de contas e convites de usuários. Consulte Restrições de recursos do Explorer, que exigem acesso básico ou padrão. A tentativa de chamar uma conta de produção de um
projeto com o nível de acesso "Teste" retorna
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
a partir de v25 ou
AuthorizationError.ACTION_NOT_PERMITTED em v24 e
versões anteriores.
As contas de produção para desenvolvimento diferem das contas de teste das seguintes maneiras:
- Veicule anúncios que possam 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 mais cuidado ao usá-los para desenvolvimento. Recomendamos tomar 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 não for possível usar contas de teste.
Portanto, para fazer testes completos da sua integração, você provavelmente vai precisar de credenciais de teste e de produção.
Credenciais para o 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, siga estas etapas:
- 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. Conceda 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 o aplicativo. O ID e a chave secreta 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. Armazene todas as credenciais e tokens de atualização com segurança e nunca os envie para o controle de origem.
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 políticas, use o campo validate_only, que está disponível para
solicitações GoogleAdsService.Search. Observe que
GoogleAdsService.SearchStream não oferece suporte a
validate_only, e 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, 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.