אוסף של כל היומנים הקיימים. ראה גם יומנים לעומת CalendarList.
רשימה של שיטות למשאב הזה מופיעה בסוף הדף.
ייצוגים של משאבים
{ "kind": "calendar#calendar", "etag": etag, "id": string, "summary": string, "description": string, "location": string, "timeZone": string, "conferenceProperties": { "allowedConferenceSolutionTypes": [ string ] } }
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
conferenceProperties |
nested object |
מאפיינים של שיחות ועידה ביומן הזה. לדוגמה, אילו סוגים של שיחות ועידה מותרים. | |
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
סוגי הפתרונות לשיחות ועידה שנתמכים ביומן הזה. הערכים האפשריים הם:
|
|
description |
string |
תיאור היומן. אפשרות. | ניתן לכתיבה |
etag |
etag |
ETag של המשאב. | |
id |
string |
מזהה היומן. כדי לאחזר מזהים, צריך לקרוא לשיטה calendarList.list(). | |
kind |
string |
סוג המשאב ("calendar#calendar "). |
|
location |
string |
המיקום הגיאוגרפי של היומן כטקסט חופשי. אפשרות. | ניתן לכתיבה |
summary |
string |
שם היומן. | ניתן לכתיבה |
timeZone |
string |
אזור הזמן של היומן. (בפורמט של שם מסד נתונים של אזור זמן IANA, לדוגמה "אירופה/ציריך"). אפשרות. | ניתן לכתיבה |
שיטות
- ניקוי
- היומן הראשי יימחק. פעולה זו מוחקת את כל האירועים המשויכים ליומן הראשי של חשבון מסוים.
- מחיקה
- מחיקה של יומן משני. יש להשתמש ב-calendar.clear כדי למחוק את כל האירועים ביומנים הראשיים.
- מקבלים
- מחזירה מטא-נתונים של יומן.
- הוספה
- יוצר יומן משני.
- תיקון
- מתבצע עדכון של המטא-נתונים של יומן. שיטה זו תומכת בסמנטיקה של תיקונים. הערה: כל בקשת תיקון צורכת שלוש יחידות מכסה. עדיף להשתמש ב-
get
ואחריו ב-update
. ערכי השדות שתציינו יחליפו את הערכים הקיימים. שדות שלא תציינו בבקשה יישארו ללא שינוי. אם צוינו שדות מערך, הם מחליפים את המערכים הקיימים. הפעולה תגרום למחיקת רכיבי המערך הקודמים. - עדכון
- מתבצע עדכון של המטא-נתונים של יומן.