Calendars: update

캘린더의 메타데이터를 업데이트합니다. 지금 사용해 보기

요청

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') 선택사항입니다. 쓰기 가능
workingHours object 사용자의 근무 시간에 관한 정보를 나타냅니다. Google Workspace 사용자의 기본 캘린더에서만 사용할 수 있습니다. 근무 시간을 업데이트하려면 전체 근무 시간 객체를 전달해야 합니다. 지정하지 않거나 null 또는 빈 객체로 전달하면 기존 근무 시간이 변경되지 않습니다. 근무 시간을 사용 중지하거나 일정을 삭제하려면 workingHoursEnabled를 false로 설정합니다(availableTimes를 생략하거나 빈 목록을 전달). 쓰기 가능
workingHours.availableTimes[] list 근무 시간 각 참석 가능 기간은 하루 동안의 사용자 근무 시간 블록을 나타냅니다. 쓰기 가능
workingHours.availableTimes[].dayOfWeek string 요일입니다. 필수 항목입니다. 가능한 값은 다음과 같습니다.
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
쓰기 가능
workingHours.availableTimes[].periodEnd integer 하루 시작부터 경과한 시간(분)으로 표시되는 기간 종료 시간(해당 값 제외)입니다. 필수 항목입니다. 쓰기 가능
workingHours.availableTimes[].periodStart integer 기간 시작(하루 시작부터의 시간(분), 포함)입니다. 필수 항목입니다. 쓰기 가능
workingHours.workingHoursEnabled boolean 이 캘린더에 근무 시간이 사용 설정되어 있는지 여부입니다. availableTimes가 비어 있으면 true로 설정할 수 없습니다. 쓰기 가능

응답

성공하면 이 메서드는 응답 본문에 캘린더 리소스를 반환합니다.

기능을 사용해 보세요.

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.