עדכון כלל בקרת גישה. השיטה הזו תומכת בסמנטיקה של תיקונים. חשוב לזכור שכל בקשת תיקון צורכת שלוש יחידות מכסה; עדיף להשתמש ב-get ואחריו update. ערכי השדות שמציינים מחליפים את הערכים הקיימים. שדות שלא תציינו בבקשה יישארו ללא שינוי. אם צוינו שדות מערך, הם יחליפו את המערכים הקיימים. הפעולה הזו מוחקת את כל רכיבי המערך הקודמים.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
PATCH 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 |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים את החלקים הרלוונטיים של משאב Acl, בהתאם לכללי הסמנטיקה של התיקון.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Acl בגוף התגובה.
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.