Estrutura da consulta

Consultas para campos de métrica e segmento podem ser enviadas ao reports.search . Para criar uma consulta na Linguagem de consulta do Merchant Center, você precisa primeiro escrever o da consulta usando a gramática do idioma. Uma consulta é composta por uma série de cláusulas:

• SELECT
• FROM
• WHERE
• ORDER BY
• LIMIT

As cláusulas usam nomes de campos, nomes de tabelas, operadores, condições e orderings para ajudar você a selecionar os dados desejados. Depois de combinados em um único uma solicitação poderá ser feita usando a Google Content API for Shopping. Vamos conferir como cada pode ser usada.

Cláusulas

SELECT

A cláusula SELECT especifica um conjunto de campos a serem buscados na solicitação. SELECT usa uma lista separada por vírgulas de campos e métricas de segmento, retornando os valores na resposta. A cláusula SELECT é obrigatória em uma consulta.

Aqui está um exemplo de consulta que seleciona métricas de clique de uma determinada tabela:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Também é possível consultar diferentes tipos de campo em uma única solicitação:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

• Segmentar campos

  • segments.date
  • segments.program

• Métricas

  • metrics.impressions
  • metrics.clicks

Alguns campos não são permitidos na cláusula SELECT devido ao seguinte: restrição:

• Consultar campos de segmento sem pelo menos um campo de métrica.

Informações relacionadas à condição acima podem ser encontradas em nossos documentos de referência.

FROM

A cláusula FROM especifica a tabela em que os dados serão buscados na solicitação. A na cláusula FROM define quais campos podem ser usados por todos os outros para a consulta em questão. Só é possível especificar uma tabela no cláusula FROM. No momento, somente a tabela MerchantPerformanceView é compatível. A cláusula FROM é obrigatória em uma consulta ao método search na serviço reports.

WHERE

A cláusula WHERE especifica as condições a serem aplicadas ao filtrar dados para os solicitação. Ao usar a cláusula WHERE, é possível especificar uma ou mais condições usando AND para separá-los. Cada condição deve seguir o padrão field_name Operator value: Qualquer campo de segmentos pode ser usado no WHERE cláusula, mas os campos de métricas precisam ser especificados na cláusula SELECT para serem usada na cláusula WHERE. A cláusula WHERE é obrigatória em uma consulta, porque você sempre deve especificar o período de quando deseja que seus dados de desempenho retornados.

Este é um exemplo de como usar WHERE para retornar métricas de um determinado período período:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

É possível combinar várias condições para filtrar os dados. Esse exemplo retornará o número de cliques por oferta para o programa SHOPPING_ADS em que os cliques > 100 no período de 30 dias fornecido.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

Na consulta a seguir, você vai notar que segments.date foi selecionado. Independentemente de você selecionar segments.date, um período finito na A cláusula WHERE sempre precisa ser fornecida para recuperar dados de desempenho.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Ao filtrar, é importante ter em mente a diferenciação entre maiúsculas e minúsculas do operador em mente.

Para uma lista completa de operadores, consulte o gramática do idioma.

ORDER BY

A cláusula ORDER BY especifica a ordem em que os resultados serão retornados. Assim, você pode organizar os dados em ordem crescente ou decrescente. com base em um nome de campo. Cada ordenação é especificada como uma field_name seguida por ASC ou DESC. Se ASC e DESC não forem especificados, a ordem será padronizada para ASC. Somente os campos especificados na cláusula SELECT podem ser usados no cláusula ORDER BY. A cláusula ORDER BY é opcional em uma consulta.

A consulta a seguir ordena as linhas retornadas pelo número de cliques, do maior para o mais baixa:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

É possível especificar vários campos na cláusula ORDER BY usando uma string separada por vírgulas lista. A ordenação ocorrerá na mesma sequência especificada na consulta. Por exemplo, nesta consulta, os resultados serão classificados em ordem crescente por offer_id. Em seguida, em ordem decrescente pelo número de impressões, e então em ordem decrescente por número de cliques:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

A cláusula LIMIT permite especificar o número de resultados a serem retornados. Isso é útil se você estiver interessado apenas em um resumo.

Por exemplo, LIMIT pode ser usado para restringir o número total de resultados para o seguinte consulta:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50