यह ऐक्सेस कंट्रोल के नियम बनाता है. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl
पैरामीटर
पैरामीटर का नाम | वैल्यू | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
calendarId |
string |
कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी फिर से पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको इस समय लॉग इन किए हुए उपयोगकर्ता के प्राथमिक कैलेंडर को ऐक्सेस करना है, तो "primary " कीवर्ड का इस्तेमाल करें.
|
वैकल्पिक क्वेरी पैरामीटर | ||
sendNotifications |
boolean |
कैलेंडर शेयर करने की सेटिंग में होने वाले बदलाव के बारे में सूचनाएं भेजी जाएं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह 'सही' पर सेट होती है. |
अनुमति देना
इस अनुरोध के लिए, इस तरह के अनुरोध को अनुमति देना ज़रूरी है:
स्कोप |
---|
https://www.googleapis.com/auth/calendar |
ज़्यादा जानकारी के लिए, पुष्टि करना और अनुमति देना पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ Acl संसाधन दें:
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | ज़रूरी जानकारी |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
role |
string |
दायरे को असाइन की गई भूमिका. आपको ये वैल्यू दिख सकती हैं:
|
लिखने योग्य |
scope |
object |
वह सीमा जहां इस ACL नियम के तहत कैलेंडर ऐक्सेस दिया जाता है. | |
scope.type |
string |
दायरे का टाइप. आपको ये वैल्यू दिख सकती हैं:
default " को मिली अनुमतियां या सार्वजनिक दायरे की अनुमतियां, ऐसे सभी उपयोगकर्ता पर लागू होती हैं जिनकी पुष्टि की गई हो या नहीं. |
|
वैकल्पिक प्रॉपर्टी | |||
scope.value |
string |
स्कोप टाइप के आधार पर, किसी उपयोगकर्ता या ग्रुप का ईमेल पता या डोमेन का नाम. "default " टाइप के लिए हटा दिया गया है. |
लिखने योग्य |
जवाब
कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य भाग में Acl संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
import com.google.api.services.calendar.Calendar; 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(); // Create access rule with associated scope AclRule rule = new AclRule(); Scope scope = new Scope(); scope.setType("scopeType").setValue("scopeValue"); rule.setScope(scope).setRole("role"); // Insert new access rule AclRule createdRule = service.acl().insert('primary', rule).execute(); System.out.println(createdRule.getId());
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
rule = { 'scope': { 'type': 'scopeType', 'value': 'scopeEmail', }, 'role': 'role' } created_rule = service.acl().insert(calendarId='primary', body=rule).execute() print created_rule['id']
PHP
PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
$rule = new Google_Service_Calendar_AclRule(); $scope = new Google_Service_Calendar_AclRuleScope(); $scope->setType("scopeType"); $scope->setValue("scopeValue"); $rule->setScope($scope); $rule->setRole("role"); $createdRule = $service->acl->insert('primary', $rule); echo $createdRule->getId();
Ruby
Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
rule = Google::Apis::CalendarV3::AclRule.new( scope: { type: 'scopeType', value: 'scopeEmail', }, role: 'role' ) result = client.insert_acl('primary', rule) print result.id
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.