इस पेज का अनुवाद Cloud Translation API से किया गया है.

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` दिया जाता है.

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

JavaPythonPHPRuby

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 क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

settings = service.settings().list().execute()

for setting in settings['items']:
  print '%s: %s' % (setting['id'], setting['value'])

PHP क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

$settings = $service->settings->listSettings();

foreach ($settings->getItems() as $setting) {
  echo $setting->getId() . ': ' . $setting->getValue();
}

Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.

result = client.list_settings
result.items.each do |e|
  print e.id + ": " + e.value + "\n"
end