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
更新日历的元数据。