예

다음은 지난 30일 동안의 계정 실적을 program 및 offer_id로 분류하여 반환하는 MerchantPerformanceView에 대한 샘플 쿼리입니다. 이 간단한 예를 통해 Reports 서비스를 알아볼 수 있습니다.

이 보고서를 검색하려면 보고 관리자 역할이 필요합니다.

요청하려면 다음 판매자 센터 쿼리 언어 문을 reports.search 메서드에 전달합니다.

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

참고: 이 가이드에서는 기본 HTTP 요청을 교육용 도구로 보여주지만 클라이언트 라이브러리 중 하나를 사용하여 요청을 제출하는 것이 좋습니다.

HTTP 요청 URL

요청은 다음 URL에서 Content API for Shopping 서버에 대한 HTTP POST로 구성됩니다.

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

전체 HTTP 요청 샘플

다음은 HTTP POST 요청에 포함된 위의 보고서 정의를 보여주는 전체 예입니다.

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}