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，请调用 calendarList.list() 方法。
kind	string	资源的类型 ("calendar#calendar")。
location	string	日历的地理位置（自由格式的文本）。可选。	可写入
summary	string	日历的名称。	可写入
timeZone	string	日历的时区。（格式为 IANA 时区数据库名称，例如“Europe/Zurich”。）可选。	可写入

方法

clear

清除主日历。此操作会删除与账号的主日历关联的所有活动。

delete

删除辅助日历。使用 calendars.clear 清除主日历中的所有活动。

get

返回日历的元数据。

insert

创建辅助日历。

发出请求的经过身份验证的用户将成为新日历的数据所有者。

注意：建议以日历的预期数据所有者身份进行身份验证。您可以使用全网域授权来允许应用代表特定用户执行操作。请勿使用服务账号进行身份验证。如果您使用服务账号进行身份验证，则服务账号是数据所有者，这可能会导致意外行为。例如，如果服务账号是数据所有者，则无法转移数据所有权。

patch

更新日历的元数据。此方法支持修补语义。请注意，每个 patch 请求会消耗 3 个配额单位；建议使用 get，然后使用 update。您指定的字段值会替换现有值。您未在请求中指定的字段将保持不变。如果指定了数组字段，则会覆盖现有数组；这会舍弃任何之前的数组元素。

update

更新日历的元数据。