사용자의 캘린더 목록에 있는 캘린더 컬렉션입니다. 캘린더 및 CalendarList도 참고하세요.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{ "kind": "calendar#calendarListEntry", "etag": etag, "id": string, "summary": string, "description": string, "location": string, "timeZone": string, "summaryOverride": string, "colorId": string, "backgroundColor": string, "foregroundColor": string, "hidden": boolean, "selected": boolean, "accessRole": string, "defaultReminders": [ { "method": string, "minutes": integer } ], "notificationSettings": { "notifications": [ { "type": string, "method": string } ] }, "primary": boolean, "deleted": boolean, "conferenceProperties": { "allowedConferenceSolutionTypes": [ string ] } }
속성 이름 | 값 | 설명 | 참고 |
---|---|---|---|
accessRole |
string |
인증된 사용자가 캘린더에서 갖는 유효한 액세스 역할입니다. 읽기 전용입니다. 가능한 값은 다음과 같습니다.
|
|
backgroundColor |
string |
16진수 형식 "#0088aa "로 된 캘린더의 기본 색상입니다. 이 속성은 색인 기반 colorId 속성을 대체합니다. 이 속성을 설정하거나 변경하려면 insert, update, patch 메서드의 매개변수에서 colorRgbFormat=true 를 지정해야 합니다. 선택사항입니다. |
쓰기 가능 |
colorId |
string |
캘린더의 색상입니다. 색상 정의의 calendar 섹션에 있는 항목을 참조하는 ID입니다 (색상 엔드포인트 참고). 이 속성은 backgroundColor 및 foregroundColor 속성으로 대체되며 이러한 속성을 사용할 때 무시해도 됩니다. 선택사항입니다. |
쓰기 가능 |
conferenceProperties |
nested object |
이 캘린더의 회의 속성(예: 허용되는 회의 유형)입니다. | |
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
이 캘린더에서 지원되는 회의 솔루션 유형입니다. 사용할 수 있는 값은 다음과 같습니다.
|
|
defaultReminders[] |
list |
인증된 사용자가 이 캘린더에 대해 가지고 있는 기본 알림입니다. | 쓰기 가능 |
defaultReminders[].method |
string |
이 알림에서 사용하는 방법입니다. 가능한 값은 다음과 같습니다.
알림을 추가할 때 필요합니다. |
쓰기 가능 |
defaultReminders[].minutes |
integer |
일정이 시작되기 전까지 알림이 트리거되어야 하는 시간(분)입니다. 유효한 값은 0에서 40320 (분 기준 4주) 사이입니다. 알림을 추가할 때 필요합니다. |
쓰기 가능 |
deleted |
boolean |
이 캘린더 목록 항목이 캘린더 목록에서 삭제되었는지 여부입니다. 읽기 전용입니다. 선택사항입니다. 기본값은 False입니다. | |
description |
string |
캘린더에 대한 설명입니다. 선택사항입니다. 읽기 전용입니다. | |
etag |
etag |
리소스의 eETag입니다. | |
foregroundColor |
string |
16진수 형식 '#ffffff '으로 된 캘린더의 전경색입니다. 이 속성은 색인 기반 colorId 속성을 대체합니다. 이 속성을 설정하거나 변경하려면 insert, update, patch 메서드의 매개변수에서 colorRgbFormat=true 를 지정해야 합니다. 선택사항입니다. |
쓰기 가능 |
id |
string |
캘린더의 식별자입니다. | |
kind |
string |
리소스의 유형('calendar#calendarListEntry')입니다. | |
location |
string |
자유 형식 텍스트로 된 캘린더의 지리적 위치입니다. 선택사항입니다. 읽기 전용입니다. | |
notificationSettings |
object |
인증된 사용자가 이 캘린더에 대해 수신하는 알림입니다. | 쓰기 가능 |
notificationSettings.notifications[] |
list |
이 캘린더에 설정된 알림 목록입니다. | |
notificationSettings.notifications[].method |
string |
알림을 전달하는 데 사용되는 메서드입니다. 가능한 값은 다음과 같습니다.
알림을 추가할 때 필요합니다. |
쓰기 가능 |
notificationSettings.notifications[].type |
string |
알림의 유형입니다. 가능한 값은 다음과 같습니다.
알림을 추가할 때 필요합니다. |
쓰기 가능 |
primary |
boolean |
캘린더가 인증된 사용자의 기본 캘린더인지 여부입니다. 읽기 전용입니다. 선택사항입니다. 기본값은 False입니다. | |
selected |
boolean |
캘린더 콘텐츠가 캘린더 UI에 표시되는지 여부입니다. 선택사항입니다. 기본값은 False입니다. | 쓰기 가능 |
summary |
string |
캘린더 제목입니다. 읽기 전용입니다. | |
summaryOverride |
string |
인증된 사용자가 이 캘린더에 설정한 요약입니다. 선택사항입니다. | 쓰기 가능 |
timeZone |
string |
캘린더의 시간대입니다. 선택사항입니다. 읽기 전용입니다. |
메서드
- 삭제
- 사용자의 캘린더 목록에서 캘린더를 삭제합니다.
- get
- 사용자의 캘린더 목록에서 캘린더를 반환합니다.
- insert
- 기존 캘린더를 사용자의 캘린더 목록에 삽입합니다.
- list
- 사용자의 캘린더 목록에 있는 캘린더를 반환합니다.
- patch
- 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다. 이 메소드는 패치 의미 체계를 지원합니다. 각 패치 요청은 세 개의 할당량 단위를 사용합니다.
get
다음에update
를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드(지정된 경우)는 기존 배열을 덮어씁니다. 이전 배열 요소가 모두 삭제됩니다. - 업데이트
- 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다.
- 시계
- CalendarList 리소스의 변경사항을 확인합니다.