캘린더의 메타데이터를 업데이트합니다. 지금 사용해 보기
요청
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 |
캘린더에 대한 설명입니다. 선택사항입니다. | 쓰기 가능 |
labelProperties |
nested object |
이 캘린더에 정의된 라벨 속성입니다. 지정된 경우 기존 라벨 속성을 덮어씁니다. 지정하지 않으면 라벨 속성이 변경되지 않습니다. | 쓰기 가능 |
labelProperties.eventLabels[] |
list |
이 캘린더에 정의된 이벤트 라벨입니다. 캘린더를 업데이트할 때 이 라벨이 있으면 기존 이벤트 라벨을 대체합니다. 목록을 확장하여 새 이벤트 라벨을 추가하고 목록에서 항목을 삭제하여 캘린더에서 라벨을 삭제합니다. 각 캘린더에는 최대 200개의 라벨이 있을 수 있습니다. |
쓰기 가능 |
labelProperties.eventLabels[].backgroundColor |
string |
16진수 형식의 라벨 배경 색상입니다(예: "#039be5"). 이 라벨이 있는 이벤트는 이 색상으로 표시됩니다. 필수 항목입니다. |
쓰기 가능 |
labelProperties.eventLabels[].id |
string |
라벨의 ID입니다. 새 라벨을 삽입할 때 선택사항입니다. 제공되지 않으면 고유 ID가 생성됩니다. 라벨을 업데이트할 때 필요합니다. 제공된 경우 ID는 캘린더 내에서 고유해야 하며 UUID 형식을 따라야 합니다. |
쓰기 가능 |
labelProperties.eventLabels[].name |
string |
라벨의 이름입니다. 선택사항입니다. 제공된 경우 최대 50자(영문 기준)여야 합니다. |
쓰기 가능 |
location |
string |
자유 형식 텍스트로 된 캘린더의 지리적 위치입니다. 선택사항입니다. | 쓰기 가능 |
summary |
string |
캘린더의 제목입니다. | 쓰기 가능 |
timeZone |
string |
캘린더의 시간대입니다. (IANA 시간대 데이터베이스 이름으로 형식이 지정됩니다(예: 'Europe/Zurich').) 선택사항입니다. | 쓰기 가능 |
응답
이 메서드는 요청에 성공하면 응답 본문에서 Calendars 리소스를 반환합니다.
기능을 사용해 보세요.
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.