Acl: update

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

अनुरोध

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

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

पैरामीटर

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

अनुमति देना

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

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

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

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

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

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

// Retrieve the access rule from the API
AclRule rule = service.acl().get('primary', "ruleId").execute();

// Make a change
rule.setRole("newRole");

// Update the access rule
AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute();
System.out.println(updatedRule.getEtag());

Python

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

rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute()
rule['role'] = 'newRole'

updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute()
print updated_rule['etag']

PHP

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

$rule = $service->acl->get('primary', 'ruleId');
$rule->setRole('newRole');

$updatedRule = $service->acl->update('primary', $rule->getId(), $rule);
echo $updatedRule->getEtag();

Ruby

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

rule = client.get_acl('primary', 'ruleId')
rule.role = 'newRole'
result = client.update_acl('primary', rule.id, rule)
print result.etag

इसे आज़माएं!

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