Acl: patch

עדכון של כלל בקרת גישה. השיטה הזו תומכת בסמינטיקה של תיקונים. חשוב לזכור שכל בקשת תיקון צורכת שלוש יחידות מכסה. מומלץ להשתמש ב-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
https://www.googleapis.com/auth/calendar.acls

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

גוף הבקשה

בגוף הבקשה, מספקים את החלקים הרלוונטיים של משאב ACL, בהתאם לכללי הסמנטיקה של התיקון.

תשובה

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

נסה בעצמך!

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