사용자의 캘린더 목록에 있는 캘린더 컬렉션. Calendar와 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~40,320 (분, 4주)입니다. 알림을 추가할 때 필요합니다. |
쓰기 가능 |
deleted |
boolean |
이 캘린더 목록 항목이 캘린더 목록에서 삭제되었는지 여부 읽기 전용입니다. 선택사항. 기본값은 False입니다. | |
description |
string |
캘린더 설명입니다. 선택사항. 읽기 전용입니다. | |
etag |
etag |
리소스의 ETag입니다. | |
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 |
캘린더의 시간대입니다. 선택사항. 읽기 전용입니다. |
방법
- delete
- 사용자의 캘린더 목록에서 캘린더를 삭제합니다.
- 가져오기
- 사용자의 캘린더 목록에서 캘린더를 반환합니다.
- 삽입
- 기존 캘린더를 사용자의 캘린더 목록에 삽입합니다.
- list
- 사용자의 캘린더 목록에 있는 캘린더를 반환합니다.
- 패치
- 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 3개의 할당량 단위를 사용합니다.
get
다음에update
를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전의 배열 요소는 삭제됩니다. - 업데이트
- 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다.
- 시계
- CalendarList 리소스에 변경사항이 있는지 살펴보세요.