Acl: list

הערה: לשם כך נדרשת הרשאה.

מחזירה את הכללים ברשימת בקרת הגישה של היומן. אפשר לנסות עכשיו או לראות דוגמה.

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר	Value	התיאור
פרמטרים של נתיב
calendarId	string	מזהה היומן. כדי לאחזר מזהי יומנים, צריך לקרוא לשיטה calendarList.list. כדי לגשת ליומן הראשי של המשתמש שמחובר כרגע, צריך להשתמש במילת המפתח "primary".
פרמטרים אופציונליים של שאילתה
maxResults	integer	מספר הרשומות המרבי שהוחזר בדף תוצאות אחד. כברירת מחדל, הערך הוא 100 רשומות. גודל הדף לא יכול להיות ארוך מ-250 רשומות. אפשרות.
pageToken	string	אסימון שמציין איזה דף תוצאות להחזיר. אפשרות.
showDeleted	boolean	האם לכלול בתוצאה רשימות ACL שנמחקו. רשימות ACL שנמחקו מיוצגות על ידי role השווה ל-"none". רשימות ACL שנמחקו ייכללו תמיד אם צוין syncToken. אפשרות. ברירת המחדל היא False.
syncToken	string	אסימון שהתקבל מהשדה nextSyncToken שהוחזר בדף התוצאות האחרון מבקשת הרשימה הקודמת. התוצאה של בקשת הרשימה הזו כוללת רק ערכים שהשתנו מאז. כל הרשומות שנמחקו כי בקשת הרשימה הקודמת תמיד יהיו בקבוצת התוצאות ואסור להגדיר את showDeleted כ-False. אם התוקף של syncToken פג, השרת יגיב עם קוד תגובה מסוג 410 GONE והלקוח יצטרך לנקות את האחסון ולבצע סנכרון מלא ללא syncToken. מידע נוסף על סנכרון מצטבר. אופציונלי. ברירת המחדל היא החזרת כל הפריטים.

הרשאות

בקשה זו מחייבת הרשאה בהיקף הבא:

היקף
https://www.googleapis.com/auth/calendar

מידע נוסף זמין בדף אימות והרשאה.

גוף הבקשה

אל תספקו גוף הבקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה במבנה הבא:

{
  "kind": "calendar#acl",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    acl Resource
  ]
}

שם הנכס	Value	התיאור	הערות
kind	string	סוג האוסף ("calendar#acl").
etag	etag	ETag של האוסף.
nextPageToken	string	האסימון משמש לגישה לדף הבא בתוצאה הזו. יושמט אם אין תוצאות נוספות זמינות, ובמקרה כזה nextSyncToken מסופק.
items[]	list	רשימת הכללים ברשימה של בקרת הגישה.
nextSyncToken	string	אסימון שבו נעשה שימוש בשלב מאוחר יותר כדי לאחזר רק את הרשומות שהשתנו מאז שהתוצאה הזו הוחזרה. יושמט אם יש תוצאות נוספות, ובמקרה כזה nextPageToken מסופק.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

Java

משתמש בספריית הלקוח של Java.

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.

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

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

PHP

נעשה שימוש בספריית הלקוח של PHP.

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

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

Ruby

נעשה שימוש בספריית הלקוח של Ruby.

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

רוצה לנסות?

ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.