이 페이지는 Cloud Translation API를 통해 번역되었습니다.

쿼리 구조

측정항목 및 세그먼트 필드에 대한 쿼리를 reports.search로 보낼 수 있습니다. 메서드를 사용하여 축소하도록 요청합니다. 판매자 센터 쿼리 언어에서 쿼리를 작성하려면 먼저 언어 문법을 사용하여 검색해 보세요. 쿼리는 다음과 같은 여러 절로 구성됩니다.

SELECT
FROM
WHERE
ORDER BY
LIMIT

절에서는 필드 이름, 테이블 이름, 연산자, 조건, 정렬을 살펴보면 원하는 데이터를 선택하는 데 도움이 됩니다. 이 작업은 Google Content API for Shopping을 사용하여 요청할 수 있습니다. 각 포드가 절을 사용할 수 있습니다.

조항

SELECT

SELECT 절은 요청에서 가져올 필드 집합을 지정합니다. SELECT 는 세그먼트 필드 및 측정항목으로 쉼표로 구분된 목록을 받아 값을 반환합니다. 을 입력합니다. SELECT 절은 쿼리에 필수입니다.

다음은 지정된 표에서 클릭 측정항목을 선택하는 샘플 쿼리입니다.

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

단일 요청에서 다양한 필드 유형을 쿼리할 수도 있습니다.

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

세그먼트 필드
- segments.date
- segments.program
측정항목
- metrics.impressions
- metrics.clicks

다음과 같은 이유로 일부 필드는 SELECT 절에서 허용되지 않습니다. 제한:

측정항목 필드가 하나 이상 없는 세그먼트 필드를 쿼리합니다.

위 상태와 관련된 정보는 참조 문서에서 확인할 수 있습니다.

FROM

FROM 절은 요청에서 데이터를 가져올 테이블을 지정합니다. 이 FROM 절의 테이블은 다른 모든에서 사용할 수 있는 필드를 정의합니다. 절을 반환합니다. 에서 단일 테이블만 지정할 수 있습니다. FROM 절. 현재는 MerchantPerformanceView 표만 지원됩니다. FROM 절은 search 메서드에 대한 쿼리에서 필수입니다. reports 서비스입니다.

WHERE

WHERE 절은 합니다. WHERE 절을 사용하면 조건을 하나 이상 지정할 수 있습니다. AND를 사용하여 구분합니다. 각 조건은 패턴을 따라야 합니다. field_name Operator value 모든 세그먼트 필드는 WHERE에서 사용할 수 있습니다. 절을 사용할 수 있지만 측정항목 필드는 SELECT 절에 지정해야 합니다. WHERE 절에서 사용됩니다. WHERE 절은 쿼리에 필수입니다. 왜냐하면 광고가 게재되도록 하려면 항상 반환합니다.

다음은 WHERE를 사용하여 지정된 시간의 측정항목을 반환하는 예입니다. 기간:

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

여러 조건을 결합하여 데이터를 필터링할 수 있습니다. 이 예는 클릭수가 >인 SHOPPING_ADS 프로그램의 제품당 클릭수 주어진 30일 동안 100회

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’;

다음 쿼리에서 segments.date가 선택된 것을 확인할 수 있습니다. segments.date 선택 여부와 관계없이 성능 데이터를 검색하려면 항상 WHERE 절을 제공해야 합니다.

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

필터링할 때 연산자의 대소문자 구분이 중요합니다. 생각해야 합니다.

운영자의 전체 목록은 언어 문법.

ORDER BY

ORDER BY 절은 결과가 나오는 순서를 지정합니다. 반환합니다. 이렇게 하면 데이터를 오름차순 또는 내림차순으로 정렬할 수 있습니다. 필드 이름을 기반으로 합니다 각 순서 지정은 field_name 뒤에 오는 ASC 또는 DESC입니다. ASC와 DESC 중 어느 것도 지정하지 않으면 순서가 기본값으로 설정됩니다. ASC님에게 전송됩니다. SELECT 절에 지정된 필드만 다음에서 사용할 수 있습니다. ORDER BY 절. 쿼리에서 ORDER BY 절은 선택사항입니다.

다음 쿼리는 반환된 행을 클릭수 순으로 정렬합니다. 최저:

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

쉼표로 구분된 다음 행을 사용하여 ORDER BY 절에 여러 필드를 지정할 수 있습니다. 목록. 순서는 쿼리에 지정된 것과 동일한 순서로 발생합니다. 예를 들어 이 쿼리에서는 결과가 offer_id 다음 노출수 기준 내림차순으로 정렬, 이후 내림차순 클릭수를 기준으로 내림차순으로 정렬:

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

LIMIT 절을 사용하면 반환할 결과의 수를 지정할 수 있습니다. 이 기능은 요약에만 관심이 있는 경우에 유용합니다.

예를 들어 LIMIT를 사용하면 다음 쿼리를 실행합니다.

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

쿼리 문법

기간