Settings: list

यह पुष्टि किए गए उपयोगकर्ता के लिए, उपयोगकर्ता की सभी सेटिंग दिखाता है. इसे अभी आज़माएं.

अनुरोध

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

GET https://www.googleapis.com/calendar/v3/users/me/settings

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
वैकल्पिक क्वेरी पैरामीटर
maxResults integer नतीजों के एक पेज पर ज़्यादा से ज़्यादा कितनी एंट्री दिखाई जा सकती हैं. डिफ़ॉल्ट रूप से, यह वैल्यू 100 एंट्री होती है. पेज का साइज़, 250 एंट्री से ज़्यादा नहीं हो सकता. ज़रूरी नहीं.
pageToken string यह टोकन बताता है कि नतीजों का कौनसा पेज दिखाना है. ज़रूरी नहीं.
syncToken string यह टोकन, पिछली सूची के अनुरोध के नतीजों के आखिरी पेज पर दिखाए गए nextSyncToken फ़ील्ड से मिला है. इससे, सूची के अनुरोध के नतीजे में सिर्फ़ वे एंट्री शामिल होती हैं जिनमें उस समय के बाद से बदलाव हुआ है.
अगर syncToken की समयसीमा खत्म हो जाती है, तो सर्वर 410 GONE रिस्पॉन्स कोड के साथ जवाब देगा. साथ ही, क्लाइंट को अपना स्टोरेज खाली करना चाहिए और बिना किसी syncToken के पूरी तरह से सिंक करना चाहिए.
इंक्रीमेंटल सिंक्रनाइज़ेशन के बारे में ज़्यादा जानें.
ज़रूरी नहीं. डिफ़ॉल्ट रूप से, सभी एंट्री दिखती हैं.

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है:

दायरा
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly
https://www.googleapis.com/auth/calendar.settings

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

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

इस तरीके के साथ अनुरोध का मुख्य हिस्सा न भेजें.

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर शामिल होता है:

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा नोट
kind string कलेक्शन का टाइप ("calendar#settings").
etag etag कलेक्शन का Etag.
items[] list उपयोगकर्ता सेटिंग की सूची.
nextPageToken string इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया गया टोकन. अगर कोई और नतीजा उपलब्ध नहीं है, तो इसे शामिल नहीं किया जाता. ऐसे में, nextSyncToken दिया जाता है.
nextSyncToken string इस टोकन का इस्तेमाल बाद में सिर्फ़ उन एंट्री को वापस पाने के लिए किया जाता है जिनमें इस नतीजे के मिलने के बाद बदलाव हुआ है. अगर ज़्यादा नतीजे उपलब्ध हैं, तो इसे शामिल नहीं किया जाता. ऐसे में, nextPageToken दिया जाता है.

इसे आज़माएं!

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