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' – הרשאת קריאה ביומן. אירועים פרטיים יופיעו למשתמשים עם הרשאת קריאה, אבל פרטי האירועים יוסתרו.
  • 'writer' – הרשאת קריאה וכתיבה ביומן. אירועים פרטיים יופיעו למשתמשים עם הרשאת עריכה, ופרטי האירועים יהיו גלויים. הרשאת קריאה לרשימות ה-ACL של היומן.
  • 'owner' – הבעלות על היומן. לתפקיד הזה יש את כל ההרשאות של תפקיד הכתיבה, עם היכולת הנוספת לבצע פעולות על רשימות ACL.
 לכתיבה
scope.value string כתובת האימייל של משתמש או קבוצה, או שם הדומיין, בהתאם לסוג ההיקף. מושמט לסוג 'default'. לכתיבה

תשובה

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

נסה בעצמך!

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