Calendars

אוסף של כל היומנים הקיימים. ראה גם יומנים לעומת 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	סוגי הפתרונות לשיחות ועידה שנתמכים ביומן הזה. הערכים האפשריים הם: "eventHangout" "eventNamedHangout" "hangoutsMeet" אופציונלי.
description	string	תיאור היומן. אפשרות.	ניתן לכתיבה
etag	etag	ETag של המשאב.
id	string	מזהה היומן. כדי לאחזר מזהים, צריך לקרוא לשיטה calendarList.list().
kind	string	סוג המשאב ("calendar#calendar").
location	string	המיקום הגיאוגרפי של היומן כטקסט חופשי. אפשרות.	ניתן לכתיבה
summary	string	שם היומן.	ניתן לכתיבה
timeZone	string	אזור הזמן של היומן. (בפורמט של שם מסד נתונים של אזור זמן IANA, לדוגמה "אירופה/ציריך"). אפשרות.	ניתן לכתיבה

שיטות

ניקוי

היומן הראשי יימחק. פעולה זו מוחקת את כל האירועים המשויכים ליומן הראשי של חשבון מסוים.

מחיקה

מחיקה של יומן משני. יש להשתמש ב-calendar.clear כדי למחוק את כל האירועים ביומנים הראשיים.

מקבלים

מחזירה מטא-נתונים של יומן.

הוספה

יוצר יומן משני.

תיקון

מתבצע עדכון של המטא-נתונים של יומן. שיטה זו תומכת בסמנטיקה של תיקונים. הערה: כל בקשת תיקון צורכת שלוש יחידות מכסה. עדיף להשתמש ב-get ואחריו ב-update. ערכי השדות שתציינו יחליפו את הערכים הקיימים. שדות שלא תציינו בבקשה יישארו ללא שינוי. אם צוינו שדות מערך, הם מחליפים את המערכים הקיימים. הפעולה תגרום למחיקת רכיבי המערך הקודמים.

עדכון

מתבצע עדכון של המטא-נתונים של יומן.