O Criador de consultas do Google Ads é uma ferramenta interativa criada para ajudar você a criar e validar consultas de forma interativa usando a linguagem de consulta do Google Ads (GAQL). 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 da API Google Ads.
Vantagens
- Facilidade de uso:simplifica o processo de gravação de consultas GAQL sem exigir familiaridade com a sintaxe específica e os campos disponíveis.
- Capacidade 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 de opções válidas, ela ajuda a evitar erros de sintaxe e 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 API Explorer e ao Query Validator 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 montar consultas GAQL visualmente. 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 estará na cláusula
FROM. Os recursos representam entidades no Google Ads, comocampaign,ad_groupoukeyword_view. O criador de builds lista todos os recursos disponíveis. - Escolher 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). Você pode marcar as caixas para incluir campos na cláusula
SELECT. À medida que você faz seleções, a ferramenta gera dinamicamente a string de consulta GAQL correspondente, mostra erros e filtra combinações de campos incompatíveis. - Aplicar filtros:é possível adicionar condições de cláusula
WHEREpara filtrar os resultados. O builder 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ê para combinações de campos válidas, mas também vincula ao API Explorer para que você possa testar sua consulta com os dados da conta. Há também um validador de consultas separado em que você pode colar e verificar consultas GAQL escritas manualmente.
- Exportar:quando estiver tudo pronto com sua consulta, copie e cole a string GAQL testada e sintaticamente correta nas solicitações do 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 da API Google Ads.
Primeiros passos
Há duas maneiras de acessar o criador de consultas. Uma opção é acessar uma página específica nos documentos de referência de relatórios, e a outra é explorar a 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. Outra opção é navegar diretamente até o recurso no painel de navegação à esquerda.
- Clique em Me ajude a criar uma consulta, que leva você ao Criador de consultas para esse 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 no kit de ferramentas para desenvolvedores da API Google Ads. É possível pegar uma consulta criada no Criador de consultas e testá-la no API 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 será preenchida automaticamente no corpo da solicitação. Depois, você poderá testá-la executando-a nos dados da sua conta. Consulte a API Explorer para mais informações sobre essa ferramenta.
Validador de consultas
Quando você clica em Inserir ou editar uma consulta, o validador de consultas é aberto. Use o validador de consultas para validar a sintaxe da consulta. Qualquer consulta criada inteiramente pelo Criador de consultas já terá a sintaxe correta. No entanto, se você conhece o recurso que está consultando, o Validador de consultas oferece uma maneira rápida de inserir uma consulta e verificar a validade dela. Consulte o Validador de consultas para mais informações sobre essa ferramenta.