Validador de consultas do Google Ads

O validador de consultas do Google Ads é uma ferramenta interativa criada para ajudar os desenvolvedores a criar e verificar consultas da linguagem de consulta do Google Ads (GAQL) antes de integrá-las aos aplicativos. Ele permite inserir uma string de consulta GAQL e receber 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.

Benefícios

  • Prevenção de erros:detecta consultas inválidas no início, antes que elas sejam integradas aos aplicativos, reduzindo erros de execução e falhas de chamadas 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.
  • Entendimento das 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.
  • Consultas de depuração:fornece mensagens de erro específicas quando uma consulta é inválida, geralmente mais detalhadas do que um erro genérico de API, e às vezes sugere alternativas válidas.
  • Eficiência de recursos:evita chamadas de API desnecessárias com consultas que vão falhar.

Como funciona

O validador de consultas 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 no GoogleAdsFieldService, para realizar verificações, incluindo:

  1. Sintaxe e estrutura:garante que a consulta siga a gramática GAQL correta, incluindo o uso e a ordem adequados de cláusulas como SELECT, FROM, WHERE, ORDER BY e LIMIT.
  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 segmento e métrica: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 a exigência de que determinados campos usados nas cláusulas WHERE ou ORDER BY 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, ela vai fornecer mensagens de erro criadas para ajudar a identificar o problema, às vezes oferecendo sugestões de correções, como recursos compatíveis para uma determinada métrica.

Primeiros passos

Para usar o validador de consultas do Google Ads:

  1. Acesse o validador de consultas.
  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 consultas. Uma mensagem de confirmação 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 validação da GAQL, consulte também os guias em vídeo da GAQL.