Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Calendars: update

更新日历的元数据。立即尝试。

请求

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

参数名称	值	说明
路径参数
`calendarId`	`string`	日历标识符。如需检索日历 ID，请调用 calendarList.list 方法。如果您想访问当前登录用户的主日历，请使用“`primary`”关键字。

此请求需要获得以下至少一个范围的授权：

范围
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.app.created`
`https://www.googleapis.com/auth/calendar.calendars`

如需了解详情，请参阅身份验证和授权页面。

在请求正文中，提供具有以下属性的 Calendars 资源：

属性名称	值	说明	备注
可选属性
`description`	`string`	日历的说明。可选。	可写入
`labelProperties`	`nested object`	在此日历上定义的标签属性。如果指定，则会覆盖现有标签属性。如果未指定，标签属性将保持不变。	可写入
`labelProperties.eventLabels[]`	`list`	在此日历上定义的活动标签。如果在更新日历时存在此属性，它将替换现有的活动标签。展开列表以添加新的活动标签，并从列表中移除实体以从日历中删除标签。每个日历最多可以有 200 个标签。	可写入
`labelProperties.eventLabels[].backgroundColor`	`string`	标签的背景颜色，采用十六进制格式，例如 `"#039be5"`。带有此标签的活动将以这种颜色显示。必填。	可写入
`labelProperties.eventLabels[].id`	`string`	标签的 ID。插入新标签时可选。如果未提供，系统将生成唯一 ID。更新标签时必填。如果提供，ID 在日历中必须是唯一的，并且遵循 UUID 格式。	可写入
`labelProperties.eventLabels[].name`	`string`	标签的名称。可选。如果提供，则长度不得超过 50 个字符。	可写入
`location`	`string`	日历的地理位置（自由格式文本）。可选。	可写入
`summary`	`string`	日历的标题。	可写入
`timeZone`	`string`	日历的时区。（格式采用 IANA 时区数据库名称，例如“Europe/Zurich”。）可选。	可写入

如果成功，此方法将在响应正文中返回 Calendars 资源。

使用下面的 API Explorer 对实际数据调用此方法，然后查看响应。