Acl: insert

ऐक्सेस कंट्रोल का नियम बनाता है. इसे अभी आज़माएं.

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम मान ब्यौरा
पाथ पैरामीटर
calendarId string Calendar आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए हुए उपयोगकर्ता का प्राइमरी कैलेंडर ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.
ज़रूरी नहीं क्वेरी पैरामीटर
sendNotifications boolean कैलेंडर शेयर करने की सेटिंग में हुए बदलाव के बारे में सूचनाएं भेजनी हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है.

अनुमति देना

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

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

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

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

अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ Acl रिसॉर्स दें:

प्रॉपर्टी का नाम मान ब्यौरा नोट
ज़रूरी प्रॉपर्टी
role string स्कोप के लिए असाइन की गई भूमिका. वैल्यू इस तरह की हो सकती हैं:
  • "none" - कोई ऐक्सेस नहीं देता.
  • "freeBusyReader" - इससे, खाली/व्यस्त होने की जानकारी को पढ़ने का ऐक्सेस मिलता है.
  • "reader" - इससे कैलेंडर को पढ़ने का ऐक्सेस मिलता है. निजी इवेंट, रीडर ऐक्सेस वाले उपयोगकर्ताओं को दिखेंगे. हालांकि, इवेंट की जानकारी नहीं दिखेगी.
  • "writer" - इससे कैलेंडर को पढ़ने और उसमें बदलाव करने का ऐक्सेस मिलता है. निजी इवेंट, लेखक के ऐक्सेस वाले उपयोगकर्ताओं को दिखेंगे. साथ ही, इवेंट की जानकारी भी दिखेगी. इससे कैलेंडर के एसीएल को पढ़ने का ऐक्सेस मिलता है.
  • "owner" - इससे कैलेंडर का मालिकाना हक मिलता है. इस भूमिका के पास, लेखक की भूमिका की सभी अनुमतियां होती हैं. साथ ही, एसीएल में बदलाव करने की अतिरिक्त सुविधा भी होती है.
 लिखा जा सकता है
scope object इस ACL नियम के तहत, कैलेंडर का ऐक्सेस कितना दिया गया है.
scope.type string स्कोप का टाइप. वैल्यू इस तरह की हो सकती हैं:
  • "default" - सार्वजनिक दायरा. यह डिफ़ॉल्ट मान है.
  • "user" - इसका दायरा सिर्फ़ एक उपयोगकर्ता तक सीमित होता है.
  • "group" - यह किसी ग्रुप तक सीमित है.
  • "domain" - दायरे को किसी डोमेन तक सीमित करता है.
ध्यान दें: "default" या सार्वजनिक स्कोप के लिए दी गई अनुमतियां, पुष्टि किए गए या नहीं किए गए किसी भी उपयोगकर्ता पर लागू होती हैं.
ज़रूरी नहीं प्रॉपर्टी
scope.value string स्कोप के टाइप के आधार पर, किसी उपयोगकर्ता या ग्रुप का ईमेल पता या डोमेन का नाम. "default" टाइप के लिए शामिल नहीं किया गया. लिखा जा सकता है

जवाब

अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में Acl रिसॉर्स दिखाता है.

इसे आज़माएं!

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