Acl: list

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

कैलेंडर के लिए, ऐक्सेस कंट्रोल सूची में मौजूद नियम दिखाता है. इसे अभी आज़माएं या उदाहरण देखें.

अनुरोध

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

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

पैरामीटर

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

अनुमति देना

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

स्कोप
https://www.googleapis.com/auth/calendar

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

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

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

जवाब

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

{
  "kind": "calendar#acl",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    acl Resource
  ]
}

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

उदाहरण

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

Java

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

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Acl;
import com.google.api.services.calendar.model.AclRule;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Iterate over a list of access rules
Acl acl = service.acl().list('primary').execute();

for (AclRule rule : acl.getItems()) {
  System.out.println(rule.getId() + ": " + rule.getRole());
}

Python

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

acl = service.acl().list(calendarId='primary').execute()

for rule in acl['items']:
  print '%s: %s' % (rule['id'], rule['role'])

PHP

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

$acl = $service->acl->listAcl('primary');

foreach ($acl->getItems() as $rule) {
  echo $rule->getId() . ': ' . $rule->getRole();
}

Ruby

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

result = client.list_acls('primary')
result.items.each do |e|
  print e.id + ": " + e.role + "\n"
end

इसे आज़माएं!

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