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 Calendar를 사용하지 않는 참석자에게만 알림이 전송됩니다.
- '
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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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."]]
