Acl: insert

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

בקשה

בקשת HTTP

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

פרמטרים

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

אישור

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

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

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

גוף הבקשה

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

שם הנכס ערך תיאור הערות
מאפייני חובה
role string התפקיד שמוקצה להיקף. הערכים האפשריים הם:
  • ‫none – לא ניתנת גישה.
  • ‫freeBusyReader – מספק גישת קריאה למידע על זמינות.
  • ‫reader – מאפשרת גישת קריאה ליומן. אירועים פרטיים יופיעו למשתמשים עם גישת קריאה, אבל פרטי האירועים יוסתרו.
  • ‫writer – גישת קריאה וכתיבה ליומן. אירועים פרטיים יופיעו למשתמשים עם גישת כתיבה, ופרטי האירוע יהיו גלויים. מספקת גישת קריאה לרשימות בקרת הגישה (ACL) של היומן.
  • ‫owner – מאפשר גישת ניהול ליומן. לתפקיד הזה יש את כל ההרשאות של תפקיד הכותב, בנוסף לאפשרות לשנות את רמות הגישה של משתמשים אחרים.

    .

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

תשובה

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

רוצה לנסות?

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