rocket
Content API for Shopping의 공식 후속 API인
Merchant API를 만나보세요.
update
새로운 Merchant API 기능, 버그 수정, 업데이트에 관한
최신 소식을 확인하세요.
add_alert
참고: Content API for Shopping은 2026년 8월 18일에 지원이 종료됩니다.
기간
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
판매자 센터 쿼리 언어를 사용하면 맞춤 또는 상대 기간을 사용하여 기간을 지정할 수 있습니다. 측정항목에 대한 모든 요청에는 실적 데이터를 가져올 기간을 나타내는 WHERE 절의 segments.date 조건이 포함되어야 합니다.
맞춤 기간
ISO 8601(YYYY-MM-DD) 형식으로 날짜를 지정할 수 있습니다.
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
또는,
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
작은따옴표 (') 또는 큰따옴표(")로 날짜 문자열을 정의할 수 있습니다. 하지만 일관성을 유지해야 합니다. 예를 들어 "2021-01-01'은 유효한 날짜 문자열이 아닙니다.
상대적 기간
맞춤 기간 외에도 BETWEEN 및 AND 대신 DURING를 사용하여 LAST_30_DAYS 또는 THIS_MONTH와 같은 상대 기간을 지정할 수 있습니다.
WHERE segments.date DURING LAST_30_DAYS
사용 가능한 상대 날짜 범위 목록은 판매자 센터 쿼리 언어 문법을 확인하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-13(UTC)
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eAll Merchant Center Query Language requests for metrics require a \u003ccode\u003esegments.date\u003c/code\u003e condition in the \u003ccode\u003eWHERE\u003c/code\u003e clause to specify the desired time period for performance data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eDate ranges can be specified using custom ISO 8601 formatted dates or relative date ranges like \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e using \u003ccode\u003eDURING\u003c/code\u003e in the \u003ccode\u003eWHERE\u003c/code\u003e clause.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. All requests for performance metrics require a `segments.date` condition in the `WHERE` clause. Dates can be specified in ISO 8601 format within a custom range using `BETWEEN` or `\u003e=` and `\u003c=`. Alternatively, relative date ranges like `LAST_30_DAYS` can be specified with `DURING`. For a list of available date ranges, the grammar documentation should be consulted.\n"],null,["# Date ranges\n\nThe Merchant Center Query Language lets you specify a date range using a custom\nor relative date range. **All requests for metrics must include a condition for\n`segments.date` in the`WHERE` clause** to indicate the time period from which\nyou want to retrieve your performance data.\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(YYYY-MM-DD) format: \n\n segments.date BETWEEN '2021-01-01' AND '2021-01-31'\n\nOR: \n\n segments.date \u003e= '2021-01-01' AND segments.date \u003c= '2021-01-31'\n\nYou can define date strings with either single quotes (`'`) or double quotes\n(`\"`). However, you must be consistent; for example: `\"2021-01-01'` is not a\nvalid date string.\n\nRelative date range\n-------------------\n\nIn addition to custom date ranges, you can specify a relative date range such\nas `LAST_30_DAYS` or `THIS_MONTH` by using `DURING` instead of `BETWEEN` and\n`AND`: \n\n WHERE segments.date DURING LAST_30_DAYS\n\nCheck out the\n[Merchant Center Query Language grammar](/shopping-content/guides/reports/query-language/grammar)\nfor the list of available relative date ranges."]]
