Acl: insert

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

अनुरोध

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

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

पैरामीटर

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

अनुमति देना

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

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

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

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

अनुरोध के मुख्य हिस्से में, Acl संसाधन की जानकारी दें. इसमें ये प्रॉपर्टी शामिल होनी चाहिए:

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

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

जवाब

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

इसे आज़माएं!

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