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

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

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

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

जवाब

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

{
  "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

इसे आज़माएं!

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