이벤트를 업데이트합니다. 이 메소드는 패치 의미 체계를 지원합니다. 각 패치 요청은 할당량 단위 3개를 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어쓰고 이전 배열 요소는 삭제됩니다.
지금 사용해 보세요.
요청
HTTP 요청
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
매개변수
| 매개변수 이름 | 값 | 설명 |
|---|---|---|
| 경로 매개변수 | ||
calendarId |
string |
캘린더 식별자입니다. 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출하세요. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary' 키워드를 사용하세요.
|
eventId |
string |
이벤트 식별자입니다. |
| 선택적 쿼리 매개변수 | ||
alwaysIncludeEmail |
boolean |
지원 중단되고 무시됩니다. 실제 이메일 주소가 없더라도 (즉, 생성된 작동하지 않는 값이 제공됨) 주최자, 작성자, 참석자의 email 필드에 항상 값이 반환됩니다.
|
conferenceDataVersion |
integer |
API 클라이언트에서 지원하는 회의 데이터의 버전 번호입니다. 버전 0은 회의 데이터 지원이 없다고 가정하고 이벤트 본문의 회의 데이터를 무시합니다. 버전 1은 ConferenceData 복사 지원과 conferenceData의 createRequest 필드를 사용하여 새 회의를 만드는 지원을 사용 설정합니다. 기본값은 0입니다.
사용 가능한 값: 0~1
|
eventLabelVersion |
integer |
API 클라이언트에서 지원하는 이벤트 라벨 기능의 버전 번호입니다. 버전 0은 이벤트 라벨 지원이 없다고 가정하고 colorId 필드를 색상 관리를 위해 처리합니다. 버전 1은 이벤트 라벨 지원을 사용 설정하고 이벤트 본문의 eventLabelId을 처리합니다. 이 경우 colorId 필드는 무시됩니다. 기본값은 0입니다.
사용 가능한 값: 0~1
|
maxAttendees |
integer |
응답에 포함할 최대 참석자 수입니다. 지정된 참석자 수보다 많은 참석자가 있는 경우 참가자만 반환됩니다. 선택사항입니다. |
sendNotifications |
boolean |
지원 중단되었습니다. sendUpdates를 대신 사용하세요. 이벤트 업데이트 (예: 설명 변경 등)에 관한 알림을 전송할지 여부입니다. 값을 false로 설정하더라도 일부 이메일이 전송될 수 있습니다. 기본값은 false입니다.
|
sendUpdates |
string |
이벤트 업데이트 (예: 제목 변경 등)에 관한 알림을 수신해야 하는 참석자입니다.
사용 가능한 값은 다음과 같습니다.
|
supportsAttachments |
boolean |
작업을 실행하는 API 클라이언트가 이벤트 첨부파일을 지원하는지 여부입니다. 선택사항입니다. 기본값은 False입니다. |
승인
이 요청에는 다음 범위 중 하나 이상의 승인이 필요합니다.
| 범위 |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
요청 본문에서는 패치 시맨틱스의 규칙에 따라 Events 리소스의 관련 부분을 제공합니다.
응답
이 메서드는 요청에 성공하면 응답 본문에서 Events 리소스를 반환합니다.
사용해 보세요.
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.