O Criador de consultas do Google Ads é uma ferramenta interativa criada para ajudar você a construir 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 na 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 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 da 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 vai 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 (que podem ser unidos implicitamente). 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](link to page) separado em que você pode colar e verificar manualmente consultas GAQL escritas.
- Exportar:quando estiver satisfeito com a 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 para começar na lista de todos os recursos. Ou navegue 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 consulta
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, mas se você conhecer o recurso que está consultando, o Validador de consultas vai oferecer 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.