Events: move
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
予定を別のカレンダーに移動します。つまり、予定の主催者を変更します。移動できるのは default
イベントのみです。birthday
、focusTime
、fromGmail
、outOfOffice
、workingLocation
イベントは移動できません。今すぐお試しください。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
パラメータ
パラメータ名 |
値 |
説明 |
パスパラメータ |
calendarId |
string |
イベントが現在存在する移行元のカレンダーのカレンダー ID。
|
eventId |
string |
イベント ID。
|
必須のクエリ パラメータ |
destination |
string |
予定を移動するターゲット カレンダーのカレンダー ID。
|
省略可能なクエリ パラメータ |
sendNotifications |
boolean |
非推奨です。代わりに sendUpdates を使用してください。
イベントの主催者の変更に関する通知を送信するかどうか。値を false に設定しても、一部のメールは送信される場合があります。デフォルトは false です。 |
sendUpdates |
string |
イベントの主催者の変更に関する通知を受け取るゲスト。
有効な値は次のとおりです。
- 「
all 」: すべてのゲストに通知が送信されます。
- 「
externalOnly 」: 通知は Google カレンダー以外のゲストにのみ送信されます。
- 「
none 」: 通知は送信されません。カレンダーの移行タスクの場合は、代わりに Events.import メソッドの使用を検討してください。
|
承認
このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。
範囲 |
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 Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],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."]]