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" - इससे कैलेंडर को पढ़ने का ऐक्सेस मिलता है. निजी इवेंट, रीडर ऐक्सेस वाले उपयोगकर्ताओं को दिखेंगे. हालांकि, इवेंट की जानकारी छिपी रहेगी.
  • "writerWithoutPrivateAccess" - इससे कैलेंडर को पढ़ने और उसमें बदलाव करने का ऐक्सेस मिलता है. निजी इवेंट, writerWithoutPrivateAccess ऐक्सेस वाले उपयोगकर्ताओं को दिखेंगे. हालांकि, इवेंट की जानकारी छिपी रहेगी.
  • "writer" - इससे कैलेंडर को पढ़ने और उसमें बदलाव करने का ऐक्सेस मिलता है. निजी इवेंट, लेखक के तौर पर ऐक्सेस रखने वाले उपयोगकर्ताओं को दिखेंगे. साथ ही, उन्हें इवेंट की जानकारी भी दिखेगी. इससे कैलेंडर की एसीएल को पढ़ने का ऐक्सेस मिलता है.
  • "owner" - इससे कैलेंडर का ऐक्सेस मैनेजर को मिलता है. इस भूमिका में, लेखक की भूमिका वाली सभी अनुमतियां होती हैं. साथ ही, इसमें अन्य उपयोगकर्ताओं के ऐक्सेस लेवल में बदलाव करने की अतिरिक्त सुविधा भी होती है.

    वाले कई उपयोगकर्ता हो सकते हैं.

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

जवाब

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

इसे आज़माएं!

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