Acl

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

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

{
  "kind": "calendar#aclRule",
  "etag": etag,
  "id": string,
  "scope": {
    "type": string,
    "value": string
  },
  "role": string
}
שם הנכס ערך תיאור הערות
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.