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

इसे आज़माएं!

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