इससे, पुष्टि किए गए उपयोगकर्ता की सभी सेटिंग दिखती हैं. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध करें
एचटीटीपी अनुरोध
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 |
ज़्यादा जानकारी के लिए, पुष्टि और अनुमति देना पेज देखें.
अनुरोध का मुख्य भाग
इस तरीके से, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:
{ "kind": "calendar#settings", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ settings Resource ] }
प्रॉपर्टी का नाम | वैल्यू | जानकारी | नोट |
---|---|---|---|
kind |
string |
कलेक्शन का टाइप ("calendar#settings "). |
|
etag |
etag |
संग्रह का इटैग. | |
items[] |
list |
उपयोगकर्ता सेटिंग की सूची. | |
nextPageToken |
string |
इस नतीजे के अगले पेज को ऐक्सेस करने के लिए इस्तेमाल किया गया टोकन. अगर कोई और नतीजा उपलब्ध नहीं होता है, तो इसे छोड़ दिया जाता है. इस स्थिति में nextSyncToken दिया जाता है. |
|
nextSyncToken |
string |
टोकन को बाद में कभी-कभी इस्तेमाल किया जाता है, ताकि सिर्फ़ वही एंट्री वापस पाई जा सकें जो इस नतीजे के बाद बदली हैं. अगर आगे के नतीजे उपलब्ध होते हैं, तो इसे छोड़ दिया जाता है. ऐसे में nextPageToken दिया जाता है. |
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Setting; import com.google.api.services.calendar.model.Settings; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over all user settings Settings settings = service.settings().list().execute(); for (Setting setting : settings.getItems()) { System.out.println(setting.getId() + ": " + setting.getValue()); }
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
settings = service.settings().list().execute() for setting in settings['items']: print '%s: %s' % (setting['id'], setting['value'])
PHP
PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
$settings = $service->settings->listSettings(); foreach ($settings->getItems() as $setting) { echo $setting->getId() . ': ' . $setting->getValue(); }
Ruby
Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
result = client.list_settings result.items.each do |e| print e.id + ": " + e.value + "\n" end
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.