Acl

רשימה של שיטות למשאב הזה מופיעה בסוף הדף.

ייצוגים של משאבים

{
  "kind": "calendar#aclRule",
  "etag": etag,
  "id": string,
  "scope": {
    "type": string,
    "value": string
  },
  "role": string
}
שם הנכס Value התיאור הערות
etag etag ETag של המשאב.
id string מזהה הכלל של רשימת בקרת גישה (ACL). רוצים לדעת איך משתפים יומנים?
kind string סוג המשאב ("calendar#aclRule").
role string התפקיד שהוקצה להיקף. הערכים האפשריים הם:
  • 'none' – לא מספק גישה.
  • 'freeBusyReader' – מספקת גישת קריאה למידע פנוי/לא פנוי.
  • 'reader' – נותנת הרשאת קריאה ליומן. אירועים פרטיים יוצגו למשתמשים עם גישת קריאה, אבל פרטי האירועים יוסתרו.
  • 'writer' – מספקת גישת קריאה וכתיבה ליומן. אירועים פרטיים יוצגו למשתמשים עם גישת כתיבה ופרטי האירועים יהיו גלויים.
  • "owner" – הזנת בעלות על היומן. לתפקיד הזה יש את כל ההרשאות של תפקיד הכותב, וגם יכולת להציג רשימות ACL ולשנות אותן.
ניתן לכתיבה
scope object המידה שבה כלל ACL זה מעניק גישה ליומן.
scope.type string סוג ההיקף. הערכים האפשריים הם:
  • "default" - ההיקף הציבורי. זהו ערך ברירת המחדל.
  • 'user' - הגבלת ההיקף למשתמש יחיד.
  • "group" - הגבלת ההיקף לקבוצה.
  • 'domain' - מגביל את ההיקף לדומיין.
הערה: ההרשאות שמוענקות להיקף "default", או ציבורי, חלות על כל משתמש, מאומת או לא.
scope.value string כתובת האימייל של משתמש או קבוצה או שם הדומיין, בהתאם לסוג ההיקף. הוסר בסוג "default". ניתן לכתיבה

שיטות

מחיקה
מחיקת כלל של בקרת גישה.
מקבלים
מחזיר כלל של בקרת גישה.
הוספה
יצירת כלל של בקרת גישה.
list
מחזירה את הכללים שברשימת בקרת הגישה של היומן.
תיקון
מתעדכן כלל של בקרת גישה. שיטה זו תומכת בסמנטיקה של תיקונים. הערה: כל בקשת תיקון צורכת שלוש יחידות מכסה. עדיף להשתמש ב-get ואחריו ב-update. ערכי השדות שתציינו יחליפו את הערכים הקיימים. שדות שלא תציינו בבקשה יישארו ללא שינוי. אם צוינו שדות מערך, הם מחליפים את המערכים הקיימים. הפעולה תגרום למחיקת רכיבי המערך הקודמים.
עדכון
מתעדכן כלל של בקרת גישה.
שעון
חשוב לשים לב לשינויים במשאבי ה-ACL.