Acl: update

עדכון של כלל בקרת גישה. רוצים לנסות?

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים של נתיבים
calendarId string מזהה היומן. כדי לאחזר מזהי יומנים, קוראים לשיטה calendarList.list. אם רוצים לגשת ליומן הראשי של המשתמש שמחובר כרגע, משתמשים במילת המפתח primary.
ruleId string מזהה של כלל ACL.
פרמטרים אופציונליים של שאילתה
sendNotifications boolean האם לשלוח התראות על השינוי בשיתוף היומן. חשוב לדעת: לא נשלחות התראות על הסרת גישה. אופציונלי. ברירת המחדל היא True.

אישור

כדי לבצע את הבקשה הזו, צריך להעניק הרשאה עם אחת מההיקפים הבאים:

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

למידע נוסף, ראו את הדף אימות והרשאה.

גוף הבקשה

בגוף הבקשה, מספקים משאב ACL עם המאפיינים הבאים:

שם הנכס ערך תיאור הערות
מאפייני חובה
scope object היקף הגישה ליומן שמוענקת על ידי כלל ה-ACL הזה.
scope.type string סוג ההיקף. הערכים האפשריים הם:
  • ‫default – היקף הגישה הציבורי. זהו ערך ברירת המחדל.
  • ‫user – מגביל את ההיקף למשתמש יחיד.
  • ‫"group" – מגביל את ההיקף לקבוצה.
  • ‫"domain" – מגביל את ההיקף לדומיין.
הערה: ההרשאות שניתנות להיקף 'default' (ציבורי) חלות על כל משתמש, מאומת או לא.
מאפיינים אופציונליים
role string התפקיד שהוקצה להיקף. הערכים האפשריים הם:
  • ‫none – לא ניתנת גישה.
  • ‫freeBusyReader – מספק גישת קריאה למידע על זמינות.
  • ‫reader – מאפשר גישת קריאה ליומן. אירועים פרטיים יופיעו למשתמשים עם גישת קריאה, אבל פרטי האירועים יוסתרו.
  • ‫writerWithoutPrivateAccess – גישת קריאה וכתיבה ליומן. אירועים פרטיים יופיעו למשתמשים עם גישת writerWithoutPrivateAccess, אבל פרטי האירועים יוסתרו.
  • ‫writer – גישת קריאה וכתיבה ליומן. אירועים פרטיים יופיעו למשתמשים עם הרשאת כתיבה, ופרטי האירוע יהיו גלויים. מספקת גישת קריאה לרשימות בקרת הגישה (ACL) של היומן.
  • ‫owner – מאפשר גישת מנהל ליומן. לתפקיד הזה יש את כל ההרשאות של תפקיד הכותב, עם היכולת הנוספת לשנות את רמות הגישה של משתמשים אחרים.

    .

 ניתן לכתיבה
scope.value string כתובת האימייל של משתמש או קבוצה, או שם של דומיין, בהתאם לסוג ההיקף. הושמט עבור הסוג 'default'. ניתן לכתיבה

תשובה

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

רוצה לנסות?

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