Calendars

包含所有现有日历的集合。另请参阅日历与日历列表。

有关此类资源的方法列表，请参阅本页面的结尾部分。

资源表示法

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
属性名称 值 说明 备注
autoAcceptInvitations boolean 相应日历是否自动接受邀请。仅对资源日历有效。
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 语义。请注意，每个 patch 请求会消耗 3 个配额单位；建议使用 get，然后使用 update。您指定的字段值会替换现有值。您未在请求中指定的字段将保持不变。如果指定了数组字段，则会覆盖现有数组；这会舍弃任何之前的数组元素。
transferOwnership
在 Google Workspace 组织内的用户之间转移辅助日历。需要用户通过管理日历管理员权限进行身份验证，并具有以下授权范围之一：
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
在请求中，将 useAdminAccess 设置为 true。辅助日历必须处于有效状态才能进行转移。不支持转移已停用或已删除的日历。
update
更新日历的元数据。