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" - कैलेंडर का मालिकाना हक देता है. इस भूमिका में, लेखक की भूमिका के लिए सभी अनुमतियां मिलती हैं. साथ ही, एसीएल को देखने और उनमें बदलाव करने की अतिरिक्त सुविधाएं भी मिलती हैं.
 लिखा जा सकता है
scope object इस एसीएल नियम के मुताबिक, कैलेंडर का ऐक्सेस किस हद तक दिया जाता है.
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

इसे आज़माएं!

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