עדכון יומן קיים ברשימת היומנים של המשתמש. השיטה הזו תומכת בסמנטיקה של תיקונים. חשוב לזכור שכל בקשת תיקון צורכת שלוש יחידות מכסה; עדיף להשתמש ב-get ואחריו update. ערכי השדות שמציינים מחליפים את הערכים הקיימים. שדות שלא תציינו בבקשה יישארו ללא שינוי. אם צוינו שדות מערך, הם יחליפו את המערכים הקיימים. הפעולה הזו מוחקת את כל רכיבי המערך הקודמים.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
פרמטרים
| שם הפרמטר | ערך | תיאור |
|---|---|---|
| פרמטרים של נתיב | ||
calendarId |
string |
מזהה היומן. כדי לאחזר מזהי יומנים, צריך להפעיל את השיטה calendarList.list. כדי להיכנס ליומן הראשי של המשתמש שמחובר כרגע, אפשר להשתמש באפשרות 'primary' במילת מפתח.
|
| פרמטרים אופציונליים של שאילתה | ||
colorRgbFormat |
boolean |
הגדרה שקובעת אם להשתמש בשדות foregroundColor ו-backgroundColor כדי לכתוב את צבעי היומן (RGB). אם משתמשים בתכונה הזו, השדה colorId שמבוסס על אינדקס יוגדר באופן אוטומטי לאפשרות ההתאמה הטובה ביותר. זה שינוי אופציונלי. ערך ברירת המחדל הוא False.
|
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא:
| היקף |
|---|
https://www.googleapis.com/auth/calendar |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מציינים את החלקים הרלוונטיים ממשאב של CalendarList, בהתאם לכללי סמנטיקה של תיקונים.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב CalendarList בגוף התשובה.
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.