التحكّم في النطاق الزمني
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إذا كنت تعمل على مصدر بيانات يتطلب نطاقًا زمنيًا عند جلب البيانات، يمكنك الاستفادة من ميزات النطاق الزمني في Looker Studio.
لتفعيل ميزة التحكم في النطاق الزمني لـ "موصِّل المنتدى"، يجب ضبط
dateRangeRequired على true في ردّ
getConfig. بعد ذلك، ستتضمّن
Looker Studio تاريخَي البدء والانتهاء مع كل طلب
getData يتم إرساله إلى
موصِّلك.
سلوك getData عندما تكون قيمة dateRangeRequired هي true.
عند ضبط dateRangeRequired على true في استجابة getConfig، سيحتوي كل طلب
getData على عنصر
dateRange مع مَعلمتَي startDate وendDate. ستكون معلمات التاريخ
بتنسيق YYYY-MM-DD. يمكنك استخدام هذه القيم في طلبات جلب البيانات إلى خدمات الجهات الخارجية.
- وفقًا للإعدادات التلقائية، يكون النطاق الزمني المقدّم هو آخر 28 يومًا، باستثناء
اليوم.
- في حال تطبيق المستخدم فلتر نطاق زمني لتقرير ما، سيعكس النطاق الزمني المقدّم اختيار المستخدم.
- عندما تحاول أداة Looker Studio رصد
الأنواع الدلالية،
يتم ضبط
sampleExtraction على
true في طلبات getData. بالنسبة لهذه الطلبات، يكون تاريخ البدء وتاريخ الانتهاء قبل يومين من اليوم.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
