Acl: insert

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

अनुरोध

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

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

इसे आज़माएं!

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