Acl: update

Erişim denetimi kuralını günceller. Hemen deneyin veya örneke göz atın.

İstek

HTTP isteği

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

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 çağırın. Şu anda oturum açmış kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
ruleId string ACL kural tanımlayıcısı.
İsteğe bağlı sorgu parametreleri
sendNotifications boolean Takvim paylaşımı değişikliğiyle ilgili bildirim gönderilip gönderilmeyeceği. Erişimin kaldırılmasıyla ilgili bildirim gönderilmez. İsteğe bağlı. Varsayılan değer True'dur.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir:

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

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.

İstek içeriği

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

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
scope object Bu ACL kuralı tarafından takvim erişiminin ne ölçüde verildiği.
scope.type string Kapsamın türü. Olası değerler:
  • "default": Herkese açık kapsam. Bu, varsayılan değerdir.
  • "user": Kapsamı tek bir kullanıcıyla sınırlar.
  • "group": Kapsamı bir grupla sınırlandırır.
  • "domain": Kapsamı bir alanla sınırlandırır.
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
role string Kapsama alanına atanan rol. Olası değerler:
  • "none": Erişim sağlamaz.
  • "freeBusyReader": Boş/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, yazar erişimi olan kullanıcılara gösterilir ve etkinlik ayrıntıları görünür.
  • "owner": Takvim sahibi olmanızı sağlar. Bu rol, ACL'leri görme ve değiştirme özelliğinin yanı sıra yazar rolünün tüm izinlerine sahiptir.
 yazılabilir
scope.value string Kapsam türüne bağlı olarak bir kullanıcının veya grubun e-posta adresi ya da alanın adı. "default" türü için atlandı. yazabilir

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();

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

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

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

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

Ruby

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

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

Deneyin!

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