Calendars

所有現有日曆的集合。另請參閱日曆與 CalendarList 的比較。

如需本資源的方法清單，請見本頁結尾。

資源表示法

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
屬性名稱 值 說明 附註
conferenceProperties nested object 這個日曆的會議屬性，例如允許的會議類型。
conferenceProperties.allowedConferenceSolutionTypes[] list 這個日曆支援的會議解決方案類型。

可能的值包括：

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
選用。
dataOwner string 日曆擁有者的電子郵件地址。僅適用於次要日曆。唯讀。
description string 日曆說明。選用項目。 可寫入
etag etag 資源的 ETag。
id string 日曆的 ID。如要擷取 ID，請呼叫 calendarList.list() 方法。
kind string 資源類型 (「calendar#calendar」)。
location string 日曆的地理位置，以自由格式文字表示。選用項目。 可寫入
summary string 日曆標題。 可寫入
timeZone string 日曆的時區。(格式為 IANA 時區資料庫名稱，例如「Europe/Zurich」)。選用項目。 可寫入

方法

更清楚
清除主要日曆。這項作業會刪除與帳戶主要日曆相關聯的所有活動。
刪除
刪除次要日曆。如要清除主要日曆中的所有活動，請使用 calendars.clear。
get
傳回日曆的中繼資料。
插入
建立次要日曆。

系統會將要求中經過驗證的使用者設為新日曆的資料擁有者。

修補程式
更新日曆的中繼資料。這個方法支援 patch 語意。請注意，每個修補程式要求會耗用三個配額單位，建議使用 get，然後再使用 update。您指定的欄位值會取代現有值。要求中未指定的欄位會維持不變。如果指定陣列欄位，系統會覆寫現有陣列，並捨棄先前的陣列元素。
更新
更新日曆的中繼資料。