O Criador de consultas do Google Ads é uma ferramenta interativa que ajuda você a criar e validar consultas usando a linguagem de consulta do Google Ads (GAQL, na sigla em inglês). Seja você um usuário novo ou experiente da GAQL, o Criador de consultas pode simplificar o processo de busca dos dados exatos que você precisa na API Google Ads.
Vantagens
- Facilidade de uso: simplifica o processo de criação de consultas GAQL, sem exigir familiaridade com a sintaxe específica e os campos disponíveis.
- Facilidade de descoberta: ajuda a explorar e encontrar recursos, campos, segmentos e métricas disponíveis no modelo de dados da API Google Ads.
- Redução de erros: ao fornecer uma interface estruturada e menus suspensos com opções válidas, ele ajuda a evitar erros de sintaxe e de digitação, garantindo que a consulta gerada seja válida.
- Criação de consultas mais rápida: acelera o processo de desenvolvimento automatizando a geração de strings de consulta.
- Validação: a ferramenta está vinculada ao APIs Explorer e ao validador de consulta para verificar as consultas em relação às regras da API antes da execução.
Como funciona
O Criador de consultas do Google Ads oferece uma interface fácil de usar para criar consultas GAQL de forma visual. Este é o fluxo de trabalho básico:
- Selecione um recurso: comece escolhendo o recurso principal na guia
Referência da versão
que você quer consultar. Esse recurso é colocado na cláusula
FROM. Os recursos representam entidades no Google Ads, comocampaign,ad_groupoukeyword_view. O builder lista todos os recursos disponíveis. - Escolha os campos: depois que um recurso é selecionado, a ferramenta mostra todos os campos selecionáveis, incluindo atributos, segmentos e métricas relacionados a esse recurso e aos recursos atribuídos (implicitamente combináveis). Marque as caixas de seleção para incluir campos na cláusula
SELECT. Conforme você faz seleções, a ferramenta gera dinamicamente a string de consulta GAQL correspondente, exibe erros e filtra combinações de campos incompatíveis. - Aplicar filtros: adicione condições de cláusula
WHEREpara filtrar os resultados. O criador ajuda você a escolher campos, operadores e valores, garantindo a sintaxe correta. - Ordenar resultados: especifique as ordens de classificação usando a cláusula
ORDER BY. - Definir limites: adicione uma cláusula
LIMITpara controlar o número de resultados retornados. - Validar: a ferramenta orienta você de forma inerente para combinações de campos válidas e também se vincula ao API Explorer para que você possa testar sua consulta com os dados da sua conta. Há também um validador de consulta separado, em que é possível colar e verificar consultas da GAQL escritas manualmente.
- Exportar: quando estiver tudo pronto com sua consulta, copie e cole a string da GAQL testada e sintaticamente correta nas solicitações de cliente
GoogleAdsService.SearchouSearchStream.
O criador garante que os campos, segmentos e métricas selecionados sejam compatíveis e possam ser usados juntos em uma única consulta, referenciando os metadados subjacentes da API Google Ads.
Primeiros passos
Há duas maneiras de acessar o Criador de consultas: acessar uma página específica nos documentos de referência de relatórios ou navegar na página de visão geral do Criador de consultas.
Na documentação de referência de relatórios
- Comece com os documentos de referência de relatórios e escolha um recurso específico na lista de todos os recursos. Como alternativa, navegue diretamente até o recurso no painel de navegação à esquerda.
- Clique em Quero ajuda para criar uma consulta, que leva você ao Criador de Consultas desse recurso específico.
Na página de visão geral do Criador de Consultas
Acesse a seção Criador de consultas dos documentos de referência de relatórios e selecione o recurso que você quer analisar.
Integração com outras ferramentas
O Criador de consultas é integrado a outras ferramentas do kit de ferramentas para desenvolvedores da API Google Ads. É possível pegar uma consulta criada no Criador de Consultas e testá-la no APIs Explorer ou validá-la com o Validador de Consultas.
API Explorer
Depois de criar a consulta, clique em Testar no APIs Explorer para abrir a consulta no APIs Explorer. Sua consulta é preenchida automaticamente no corpo da solicitação, e você pode testá-la executando-a nos dados da sua conta. Consulte APIs Explorer para mais informações sobre essa ferramenta.
Validador de consulta
Quando você clica em Inserir ou editar uma consulta, o validador de consulta é aberto. Use o validador de consultas para validar a sintaxe da consulta. Qualquer consulta criada inteiramente pelo Criador de consultas já tem a sintaxe correta, mas se você conhece o recurso que está consultando, o validador de consulta oferece uma maneira rápida de inserir uma consulta e verificar a validade dela. Consulte Validador de consulta para mais informações sobre essa ferramenta.