Events: move
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将活动移至其他日历,即更改活动的组织者。请注意,只有 default
事件可以移动;birthday
、focusTime
、fromGmail
、outOfOffice
和 workingLocation
事件无法移动。
立即试用。
请求
HTTP 请求
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
参数
参数名称 |
值 |
说明 |
路径参数 |
calendarId |
string |
事件当前所在的来源日历的日历标识符。
|
eventId |
string |
事件标识符。
|
必需的查询参数 |
destination |
string |
要将活动移到的目标日历的日历标识符。
|
可选的查询参数 |
sendNotifications |
boolean |
已弃用。请改用 sendUpdates。
是否发送有关活动组织者更改的通知。请注意,即使您将该值设为 false ,系统可能仍会发送某些电子邮件。默认值为 false 。
|
sendUpdates |
string |
应收到活动组织者更改通知的邀请对象。
可接受的值包括:
- “
all ”:系统会向所有访客发送通知。
- “
externalOnly ”:仅向非 Google 日历邀请对象发送通知。
- “
none ”:不发送任何通知。对于日历迁移任务,不妨改用 Events.import 方法。
|
授权
此请求需要获得以下至少一个范围的授权:
范围 |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.events.owned |
如需了解详情,请参阅身份验证和授权页面。
请求正文
使用此方法时请勿提供请求正文。
试试看!
使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Events: move\n\n| **Note:** Requires [authorization](#auth).\n\nMoves an event to another calendar, i.e. changes an event's organizer. Note that only `default` events can be moved; `birthday`, `focusTime`, `fromGmail`, `outOfOffice` and `workingLocation` events cannot be moved.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier of the source calendar where the event currently is on. |\n| `eventId` | `string` | Event identifier. |\n| **Required query parameters** |||\n| `destination` | `string` | Calendar identifier of the target calendar where the event is to be moved to. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Deprecated. Please use [sendUpdates](/workspace/calendar/api/v3/reference/events/move#sendUpdates) instead. Whether to send notifications about the change of the event's organizer. Note that some emails might still be sent even if you set the value to `false`. The default is `false`. |\n| `sendUpdates` | `string` | Guests who should receive notifications about the change of the event's organizer. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\": Notifications are sent to all guests. - \"`externalOnly`\": Notifications are sent to non-Google Calendar guests only. - \"`none`\": No notifications are sent. For calendar migration tasks, consider using the [Events.import](/workspace/calendar/api/v3/reference/events/import) method instead. |\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.events` |\n| `https://www.googleapis.com/auth/calendar.events.owned` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an [Events resource](/workspace/calendar/api/v3/reference/events#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."]]