Validador de consultas do Google Ads

O validador de consulta do Google Ads é uma ferramenta interativa criada para ajudar os desenvolvedores a criar e verificar consultas da linguagem de consulta do Google Ads (GAQL, na sigla em inglês) antes de integrá-las aos aplicativos. Ele permite que você insira uma string de consulta da GAQL e receba feedback imediato sobre a validade dela, ajudando a detectar erros de sintaxe, incompatibilidades de campo e outros problemas no início do processo de desenvolvimento.

Vantagens

  • Prevenção de erros: detecta consultas inválidas antes que elas sejam integradas aos aplicativos, reduzindo erros de tempo de execução e falhas de chamada de API.
  • Desenvolvimento mais rápido: permite testes e depuração rápidos de instruções GAQL sem a sobrecarga de ciclos completos de solicitação de API e resposta.
  • Noções básicas sobre as restrições da GAQL: ajuda os desenvolvedores a aprender as regras complexas sobre quais campos são compatíveis e como os recursos se relacionam entre si.
  • Depuração de consultas: fornece mensagens de erro específicas quando uma consulta é inválida, geralmente mais detalhadas do que um erro genérico da API, e às vezes sugere alternativas válidas.
  • Eficiência de recursos: evita chamadas de API desnecessárias com consultas que estão destinadas a falhar.

Como funciona

O validador de consulta analisa sua consulta GAQL em relação ao esquema da API Google Ads e às regras definidas na Linguagem de consulta do Google Ads. Ele usa metadados, muitos dos quais são acessíveis em GoogleAdsFieldService, para realizar verificações, incluindo:

  1. Sintaxe e estrutura: garante que a consulta siga a gramática correta da GAQL, incluindo o uso e a ordem adequados de cláusulas como SELECT, FROM, WHERE, ORDER BY, LIMIT e PARAMETERS.
  2. Validade do campo: verifica se todos os campos especificados (recursos, segmentos, métricas) existem e estão escritos corretamente.
  3. Compatibilidade de recursos: verifica se os campos selecionados na cláusula SELECT são compatíveis com o recurso principal especificado na cláusula FROM.
  4. Compatibilidade de segmentos e métricas: garante que os segmentos e as métricas usados juntos na mesma consulta sejam compatíveis entre si e com o recurso na cláusula FROM.
  5. Requisitos de cláusula: valida regras como o requisito de que os campos usados em cláusulas ORDER BY e determinados campos usados em cláusulas WHERE (como segmentos) também estejam presentes na cláusula SELECT.
  6. Uso do operador: verifica o uso correto de operadores nas condições da cláusula WHERE.

Se a consulta for válida, a ferramenta vai confirmar. Se forem encontrados problemas, ele vai fornecer mensagens de erro projetadas para ajudar a identificar o problema, às vezes oferecendo sugestões de correções, como recursos compatíveis com uma determinada métrica.

Primeiros passos

Para usar o validador de consultas do Google Ads:

  1. Acesse o Validador de consulta.
  2. Insira sua consulta GAQL.
  3. Clique no botão Validar consulta.
  4. Analise a mensagem de validação que aparece abaixo do widget do validador de consulta. Uma mensagem de sucesso indica que a consulta é válida. Caso contrário, uma mensagem de erro descrevendo o problema será exibida. As mensagens de erro orientam você a corrigir a consulta. Por exemplo, um erro de incompatibilidade de campo pode listar recursos alternativos que são compatíveis com a métrica ou o segmento que você está tentando consultar.

Para explicações mais detalhadas sobre os conceitos e a sintaxe da GAQL, consulte o guia da linguagem de consulta do Google Ads. Para criar e testar consultas GAQL de forma interativa, use o Criador de consultas e o APIs Explorer.