Calendars: update
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新日历的元数据。
立即试用。
请求
HTTP 请求
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 |
日历的说明。可选。 |
可写入 |
location |
string |
日历的地理位置(采用自由格式文本)。可选。 |
可写入 |
summary |
string |
日历的标题。 |
可写入 |
timeZone |
string |
日历的时区。(格式为 IANA 时区数据库名称,例如“Europe/Zurich”)。可选。 |
可写入 |
试试看!
使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Calendars: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates metadata for a calendar.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|--------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.app.created` |\n| `https://www.googleapis.com/auth/calendar.calendars` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply a [Calendars resource](/workspace/calendar/api/v3/reference/calendars#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|----------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| `description` | `string` | Description of the calendar. Optional. | writable |\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\nResponse\n--------\n\nIf successful, this method returns a [Calendars resource](/workspace/calendar/api/v3/reference/calendars#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]