Acl: insert

Erişim denetimi kuralı oluşturur. Şimdi deneyin veya bir örneğe göz atın.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
calendarId string Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini kullanın. Şu anda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" bağlantısını kullanın. anahtar kelime.
İsteğe bağlı sorgu parametreleri
sendNotifications boolean Takvim paylaşımı değişikliğiyle ilgili bildirim gönderilip gönderilmeyeceğini belirler. İsteğe bağlı. Varsayılan değer, Doğru'dur.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/calendar

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir Acl kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
role string Kapsama atanan rol. Olası değerler:
  • "none" - Erişim sağlamaz.
  • "freeBusyReader" - Uygun/meşgul bilgilerine okuma erişimi sağlar.
  • "reader" - Takvime okuma erişimi sağlar. Gizli etkinlikler, okuyucu erişimi olan kullanıcılara gösterilir ancak etkinlik ayrıntıları gizlenir.
  • "writer" - Takvime okuma ve yazma erişimi sağlar. Gizli etkinlikler, yazma erişimi olan kullanıcılara gösterilir ve etkinlik ayrıntıları gösterilir.
  • "owner" - Takvimin sahipliğini verir. Bu rol, yazar rolünün tüm izinlerine ek olarak EKL'leri görüntüleyip değiştirme yetkisinin yanı sıra vardır.
yazılabilir
scope object Bu EKL kuralının takvim erişimini hangi ölçüde vereceğini belirtir.
scope.type string Kapsamın türü. Olası değerler:
  • "default" - Kamu kapsamı. Bu, varsayılan değerdir.
  • "user" - Kapsamı tek bir kullanıcıyla sınırlar.
  • "group" - Kapsamı bir grupla sınırlar.
  • "domain" - Kapsamı bir alanla sınırlar.
Not: "default" veya herkese açık kapsama verilen izinler, kimliği doğrulanmış olsun veya olmasın tüm kullanıcılar için geçerlidir.
İsteğe Bağlı Özellikler
scope.value string Kapsam türüne bağlı olarak bir kullanıcının veya grubun e-posta adresi ya da alan adı. "default" türü için hariç tutulur. yazılabilir

Yanıt

Başarılı olursa bu yöntem yanıt gövdesinde bir Acl kaynağı döndürür.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığını kullanır.

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 istemci kitaplığını kullanır.

rule = {
    'scope': {
        'type': 'scopeType',
        'value': 'scopeEmail',
    },
    'role': 'role'
}

created_rule = service.acl().insert(calendarId='primary', body=rule).execute()

print created_rule['id']

PHP

PHP istemci kitaplığını kullanır.

$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 istemci kitaplığını kullanır.

rule = Google::Apis::CalendarV3::AclRule.new(
  scope: {
    type: 'scopeType',
    value: 'scopeEmail',
  },
  role: 'role'
)
result = client.insert_acl('primary', rule)
print result.id

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.