Validador de consultas do Google Ads

O validador de consultas do Google Ads é uma ferramenta interativa criada para ajudar 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 da 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.

Vantagens

  • Prevenção de erros:detecta consultas inválidas no início, antes que 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.
  • Entender 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.
  • Consultas de depuração:fornecem mensagens de erro específicas quando uma consulta é inválida, geralmente mais detalhadas do que um erro genérico da API, e às vezes sugerem alternativas válidas.
  • Eficiência de recursos:evita chamadas de API desnecessárias com consultas destinadas a falhar.

Como funciona

O Query Validator 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 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 em cláusulas WHERE ou ORDER BY também estejam presentes na cláusula SELECT.
  6. Uso de operadores: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, o recurso vai fornecer mensagens de erro projetadas para ajudar a identificar o problema e, às vezes, oferecer 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 "Validador de consultas". 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 conceitos e validação da GAQL, consulte os vídeos de instruções da GAQL.