Freebusy: query

ध्यान दें: अनुमति देना ज़रूरी नहीं है.

कैलेंडर के किसी सेट के लिए खाली/व्यस्त जानकारी देता है. इसे अभी आज़माएं.

अनुरोध करें

एचटीटीपी अनुरोध

POST https://www.googleapis.com/calendar/v3/freeBusy

अनुमति देना

यह अनुरोध इनमें से कम से कम एक दायरे की अनुमति देता है:

अनुमति देने का
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar

ज़्यादा जानकारी के लिए, पुष्टि और अनुमति देना पेज देखें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर में डेटा की जानकारी दें:

{
  "timeMin": datetime,
  "timeMax": datetime,
  "timeZone": string,
  "groupExpansionMax": integer,
  "calendarExpansionMax": integer,
  "items": [
    {
      "id": string
    }
  ]
}

प्रॉपर्टी का नाम	वैल्यू	जानकारी	नोट
timeMin	datetime	आरएफ़सी3339 के मुताबिक फ़ॉर्मैट की गई क्वेरी के लिए इंटरवल की शुरुआत.
timeMax	datetime	आरएफ़सी3339 के मुताबिक फ़ॉर्मैट की गई क्वेरी के लिए इंटरवल खत्म होता है.
timeZone	string	जवाब में इस्तेमाल किया गया समय क्षेत्र. ज़रूरी नहीं. डिफ़ॉल्ट तौर पर, यूटीसी होता है.
groupExpansionMax	integer	किसी एक ग्रुप के लिए, कैलेंडर आइडेंटिफ़ायर की ज़्यादा से ज़्यादा संख्या उपलब्ध कराई जानी चाहिए. ज़रूरी नहीं. अगर इस ग्रुप से ज़्यादा सदस्य हैं, तो इस वैल्यू से ज़्यादा एक गड़बड़ी मिलेगी. ज़्यादा से ज़्यादा वैल्यू 100 हो सकती है.
calendarExpansionMax	integer	कैलेंडर की ज़्यादा से ज़्यादा संख्या, जिनके लिए FreeBusy जानकारी दी जानी है. ज़रूरी नहीं. ज़्यादा से ज़्यादा वैल्यू 50 है.
items[]	list	क्वेरी के लिए कैलेंडर और/या ग्रुप की सूची.
items[].id	string	किसी कैलेंडर या ग्रुप का आइडेंटिफ़ायर.

जवाब

अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

{
  "kind": "calendar#freeBusy",
  "timeMin": datetime,
  "timeMax": datetime,
  "groups": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "calendars": [
        string
      ]
    }
  },
  "calendars": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "busy": [
        {
          "start": datetime,
          "end": datetime
        }
      ]
    }
  }
}

प्रॉपर्टी का नाम	वैल्यू	जानकारी	नोट
kind	string	संसाधन का प्रकार "calendar#freeBusy".
timeMin	datetime	इंटरवल की शुरुआत.
timeMax	datetime	इंटरवल खत्म.
groups	object	ग्रुप को बड़ा करना.
groups.(key)	nested object	उन कैलेंडर की सूची जो इस ग्रुप के सदस्य हैं.
groups.(key).errors[]	list	वैकल्पिक गड़बड़ी (अगर ग्रुप का हिसाब नहीं लगाया जा सका).
groups.(key).errors[].domain	string	गड़बड़ी वाला डोमेन या ब्रॉड कैटगरी.
groups.(key).errors[].reason	string	गड़बड़ी की खास वजह. आपको ये वैल्यू मिल सकती हैं: "groupTooBig" - अनुरोध किए गए उपयोगकर्ताओं का समूह एक क्वेरी के लिए बहुत बड़ा है. "tooManyCalendarsRequested" - किसी एक क्वेरी के लिए अनुरोध किए गए कैलेंडर की संख्या बहुत ज़्यादा है. "notFound" - अनुरोध किया गया संसाधन नहीं मिला. "internalError" - एपीआई सेवा में कोई अंदरूनी गड़बड़ी हुई. आने वाले समय में, गड़बड़ी के अन्य टाइप जोड़े जा सकते हैं. इसलिए, क्लाइंट को गड़बड़ी से जुड़ी अन्य स्थितियों को भी ठीक से मैनेज करना चाहिए, जो इस सूची में शामिल नहीं हैं.
groups.(key).calendars[]	list	ग्रुप के अंदर मौजूद कैलेंडर के आइडेंटिफ़ायर की सूची.
calendars	object	कैलेंडर के लिए खाली/व्यस्त जानकारी की सूची.
calendars.(key)	nested object	किसी एक कैलेंडर के लिए खाली/व्यस्त एक्सपैंशन.
calendars.(key).errors[]	list	वैकल्पिक गड़बड़ी(गड़बड़ीयां) (अगर कैलेंडर की गिनती नहीं की जा सकी).
calendars.(key).errors[].domain	string	गड़बड़ी वाला डोमेन या ब्रॉड कैटगरी.
calendars.(key).errors[].reason	string	गड़बड़ी की खास वजह. आपको ये वैल्यू मिल सकती हैं: "groupTooBig" - अनुरोध किए गए उपयोगकर्ताओं का समूह एक क्वेरी के लिए बहुत बड़ा है. "tooManyCalendarsRequested" - किसी एक क्वेरी के लिए अनुरोध किए गए कैलेंडर की संख्या बहुत ज़्यादा है. "notFound" - अनुरोध किया गया संसाधन नहीं मिला. "internalError" - एपीआई सेवा में कोई अंदरूनी गड़बड़ी हुई. आने वाले समय में, गड़बड़ी के अन्य टाइप जोड़े जा सकते हैं. इसलिए, क्लाइंट को गड़बड़ी से जुड़ी अन्य स्थितियों को भी ठीक से मैनेज करना चाहिए, जो इस सूची में शामिल नहीं हैं.
calendars.(key).busy[]	list	उन समय सीमाओं की सूची जिनके दौरान इस कैलेंडर को व्यस्त माना जाना चाहिए.
calendars.(key).busy[].start	datetime	समयावधि के शुरू होने की तारीख.
calendars.(key).busy[].end	datetime	इस समयावधि के खत्म होने पर (खास समय).

इसे आज़माएं!

इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.