Acl: list

Takvimin erişim kontrol listesindeki kuralları döndürür. Hemen deneyin veya bir örneği inceleyin.

İstek

HTTP isteği

GET 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 çağırın. Halihazırda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
İsteğe bağlı sorgu parametreleri
maxResults integer Bir sonuç sayfasında döndürülen maksimum giriş sayısı. Değer varsayılan olarak 100 giriştir. Sayfa boyutu hiçbir zaman 250 girişten büyük olamaz. İsteğe bağlı.
pageToken string Döndürülecek sonuç sayfasını belirten jeton. İsteğe bağlı.
showDeleted boolean Sonuca silinmiş EKL'lerin dahil edilip edilmeyeceğini belirler. Silinen EKL'ler, "none" değerine eşit role olarak temsil edilir. syncToken belirtilirse silinmiş EKL'ler her zaman dahil edilir. İsteğe bağlı. False, varsayılan değerdir.
syncToken string nextSyncToken alanından alınan jeton, önceki liste isteğinden sonuçların son sayfasında döndürülür. Bu işlem, bu liste isteğinin sonucunun yalnızca o tarihten bu yana değişen girişleri içermesini sağlar. Önceki liste isteğinden bu yana silinen tüm girişler sonuç kümesindedir ve showDeleted değerinin False olarak ayarlanmasına izin verilmez.
syncToken süresi dolarsa sunucu 410 GONE yanıt koduyla yanıt verir ve istemci depolama alanını temizlemeli ve syncToken olmadan tam senkronizasyon gerçekleştirmelidir.
Artımlı senkronizasyon hakkında daha fazla bilgi edinin.
İsteğe bağlı. Varsayılan değer tüm girişleri döndürmektir.

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ını inceleyin.

İstek metni

Bu yöntemi içeren bir istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "calendar#acl",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    acl Resource
  ]
}
Mülk adı Değer Açıklama Notlar
kind string Koleksiyonun türü ("calendar#acl").
etag etag Koleksiyonun eTag'i.
nextPageToken string Jeton, bu sonucun sonraki sayfasına erişmek için kullanıldı. Başka sonuç yoksa bu durumda yoksayılır, bu durumda nextSyncToken sağlanır.
items[] list Erişim kontrol listesindeki kuralların listesi.
nextSyncToken string Jeton daha sonra, bu sonucun döndürülmesinden sonra değişen girişleri almak için kullanılır. Daha fazla sonuç varsa yoksayılır, bu durumda nextPageToken sağlanı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.Acl;
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();

// Iterate over a list of access rules
Acl acl = service.acl().list('primary').execute();

for (AclRule rule : acl.getItems()) {
  System.out.println(rule.getId() + ": " + rule.getRole());
}

Python

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

acl = service.acl().list(calendarId='primary').execute()

for rule in acl['items']:
  print '%s: %s' % (rule['id'], rule['role'])

PHP

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

$acl = $service->acl->listAcl('primary');

foreach ($acl->getItems() as $rule) {
  echo $rule->getId() . ': ' . $rule->getRole();
}

Ruby

Ruby istemci kitaplığı kullanır.

result = client.list_acls('primary')
result.items.each do |e|
  print e.id + ": " + e.role + "\n"
end

Deneyin.

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