Calendars
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源表示法
{
"kind": "calendar#calendar",
"etag": etag,
"id": string,
"summary": string,
"description": string,
"location": string,
"timeZone": string,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
}
}
屬性名稱 |
值 |
說明 |
附註 |
conferenceProperties |
nested object |
這份日曆的會議屬性,例如允許哪些會議類型。 |
|
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
適用於這個日曆的會議解決方案類型。 可能的值包括: "eventHangout" "eventNamedHangout" "hangoutsMeet" 選填。 |
|
description |
string |
日曆的說明。選填。 |
可寫入
|
etag |
etag |
資源的 ETag。 |
|
id |
string |
日曆的 ID。如要擷取 ID,請呼叫 calendarList.list() 方法。 |
|
kind |
string |
資源類型 (「calendar#calendar 」)。 |
|
location |
string |
日曆的地理位置,以任意形式顯示。選填。 |
可寫入
|
summary |
string |
日曆的標題。 |
可寫入
|
timeZone |
string |
日曆的時區。(格式為 IANA 時區資料庫名稱,例如「歐洲/蘇黎世」)。選填。 |
可寫入
|
方法
- 更清楚
- 清除主要日曆。這項作業會刪除與帳戶主要日曆相關的所有活動,
- 刪除
- 刪除次要日曆。使用 calendar.clear 可清除主日曆上的所有活動。
- 取得
- 傳回日曆的中繼資料。
- 插入
- 建立次要日曆。
- 修補程式
- 更新日曆的中繼資料。這個方法支援 patch 語意。請注意,每個修補要求都會耗用三個配額單位;偏好使用
get
,後面加上 update
。您指定的欄位值會取代現有的值。未指定要求中的欄位會維持不變。陣列欄位 (如有指定) 會覆寫現有陣列;就會捨棄先前的所有陣列元素。
- 更新
- 更新日曆的中繼資料。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Calendars\n\nA collection of all existing calendars. See also [Calendars vs CalendarList](/workspace/calendar/api/concepts/events-calendars#calendar_and_calendar_list).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"calendar#calendar\",\n \"etag\": etag,\n \"id\": string,\n \"summary\": string,\n \"description\": string,\n \"location\": string,\n \"timeZone\": string,\n \"conferenceProperties\": {\n \"allowedConferenceSolutionTypes\": [\n string\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `conferenceProperties` | `nested object` | Conferencing properties for this calendar, for example what types of conferences are allowed. | |\n| conferenceProperties.`allowedConferenceSolutionTypes[]` | `list` | The types of conference solutions that are supported for this calendar. The possible values are: - `\"eventHangout\"` - `\"eventNamedHangout\"` - `\"hangoutsMeet\"` Optional. \u003cbr /\u003e | |\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the calendar. To retrieve IDs call the [calendarList.list()](/calendar/v3/reference/calendarList/list) method. | |\n| `kind` | `string` | Type of the resource (\"`calendar#calendar`\"). | |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nMethods\n-------\n\n[clear](/workspace/calendar/api/v3/reference/calendars/clear)\n: Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n\n[delete](/workspace/calendar/api/v3/reference/calendars/delete)\n: Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n\n[get](/workspace/calendar/api/v3/reference/calendars/get)\n: Returns metadata for a calendar.\n\n[insert](/workspace/calendar/api/v3/reference/calendars/insert)\n: Creates a secondary calendar.\n\n[patch](/workspace/calendar/api/v3/reference/calendars/patch)\n: Updates metadata for a calendar. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/calendars/update)\n: Updates metadata for a calendar."]]