기간 컨트롤
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
데이터를 가져올 때 기간이 필요한 데이터 소스로 작업하는 경우 Looker Studio 기간 기능을 활용할 수 있습니다.
커뮤니티 커넥터의 기간 제어 기능을 사용 설정하려면 getConfig 응답에서 dateRangeRequired을 true로 설정하세요. 그러면 Looker Studio에 커넥터에 전송된 모든 getData 요청에 시작일과 종료일이 포함됩니다.
dateRangeRequired이 true일 때의 getData 동작
getConfig 응답에서 dateRangeRequired이 true로 설정된 경우 각 getData 요청에는 startDate 및 endDate 매개변수가 있는 dateRange 객체가 포함됩니다. 날짜 매개변수는 YYYY-MM-DD 형식입니다. 이러한 값은 타사 서비스에 대한 데이터 가져오기 요청에서 사용할 수 있습니다.
- 기본적으로 제공되는 기간은 오늘을 제외한 최근 28일입니다.
- 사용자가 보고서에 기간 필터를 적용하면 제공된 기간에
사용자가 선택한 기간이 반영됩니다.
- Looker Studio가 시맨틱 유형을 감지하려고 하면
getData 요청에서 sampleExtraction가 true로 설정됩니다. 이러한 요청의 경우 시작일과 종료일이 오늘보다 2일 빠릅니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eWhen fetching data requiring a date range, leverage Looker Studio's date range features by setting \u003ccode\u003edateRangeRequired\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e in your connector's \u003ccode\u003egetConfig\u003c/code\u003e response.\u003c/p\u003e\n"],["\u003cp\u003eThis enables Looker Studio to include start and end dates with every \u003ccode\u003egetData\u003c/code\u003e request, allowing you to filter data from external sources.\u003c/p\u003e\n"],["\u003cp\u003eThe default date range is the last 28 days excluding today, but users can apply custom ranges, and semantic type detection uses a two-day offset.\u003c/p\u003e\n"]]],[],null,["# Date range control\n\nIf you are working with a data source that requires a date range when fetching\ndata, you can take advantage of the [Looker Studio date range features](https://support.google.com/looker-studio/answer/6291067).\n\nTo enable the date range control feature for your Community Connector, set\n`dateRangeRequired` to `true` in your\n[`getConfig`](/looker-studio/connector/reference#getconfig) response. Then,\nLooker Studio will include a start and end date with every\n[`getData`](/looker-studio/connector/reference#getdata) request made to your\nconnector.\n\n`getData` behavior when `dateRangeRequired` is `true`\n-----------------------------------------------------\n\nWhen `dateRangeRequired` is set to `true` in your `getConfig` response, each\n[`getData`](/looker-studio/connector/reference#getdata) request will contain a\n`dateRange` object with `startDate` and `endDate` parameters. The date\nparameters will be in `YYYY-MM-DD` format. You can use these values in data\nfetch requests to third-party services.\n\n- By default, the date range provided will be the last 28 days, excluding today.\n- If a user applies a date range filter for a report then the date range provided will reflect the user selection.\n- When Looker Studio is attempting to detect [semantic types](/looker-studio/connector/semantics), [`sampleExtraction`](/looker-studio/connector/reference#request_3) is set to `true` in `getData` requests. For these requests, the date provided for the start and the end date is two days earlier than today."]]
