O criador de consultas do Google Ads é uma ferramenta interativa projetada para ajudar você a criar e validar consultas de forma interativa usando a linguagem de consulta do Google Ads (GAQL, na sigla em inglês). Se você é iniciante na GAQL ou um usuário experiente, o criador de consultas pode simplificar o processo de busca dos dados exatos de que você precisa na API Google Ads.
Benefícios
- 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, ele ajuda a evitar erros de sintaxe e ortografia, 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 validador de consultas 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. O fluxo de trabalho básico é o seguinte:
- 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 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 (que podem ser unidos implicitamente). Você pode marcar as caixas de seleção 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 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ê para combinações de campos válidas, mas também se vincula ao API Explorer para que você possa testar sua consulta em relação aos dados da conta. Há também um [validador de consultas](link to page) 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 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. Uma opção é acessar uma página específica nos documentos de referência de relatórios, e a outra é explorar na página de visão geral do criador de consultas.
Nos documentos 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 Ajude-me 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 do criador de consultas dos documentos de referência de relatórios e selecione o recurso que você quer explorar.
Integração com outras ferramentas
O criador de consultas está integrado a outras ferramentas no kit de ferramentas para desenvolvedores da API Google Ads. Você pode usar 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 sua consulta, clique em Conheça o API Explorer para abrir a consulta no API Explorer. Sua consulta será preenchida automaticamente no corpo da solicitação, e você poderá testá-la executando-a nos dados da conta. Consulte o 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, mas, se você estiver familiarizado com o recurso que está consultando, o validador de consultas vai fornecer 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.