모든 기존 캘린더의 컬렉션입니다. Calendars와 CalendarList 비교도 참고하세요.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{
"kind": "calendar#calendar",
"etag": etag,
"id": string,
"summary": string,
"description": string,
"location": string,
"timeZone": string,
"dataOwner": string,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
},
"labelProperties": {
"eventLabels": [
{
"id": string,
"backgroundColor": string,
"name": string
}
]
},
"autoAcceptInvitations": boolean,
"workingHours": {
"workingHoursEnabled": boolean,
"availableTimes": [
{
"dayOfWeek": string,
"periodStart": integer,
"periodEnd": integer
}
]
}
}| 속성 이름 | 값 | 설명 | 참고 |
|---|---|---|---|
autoAcceptInvitations |
boolean |
이 캘린더에서 초대를 자동으로 수락하는지 여부입니다. 리소스 캘린더에만 유효합니다. | |
conferenceProperties |
nested object |
이 캘린더의 회의 속성입니다(예: 허용되는 회의 유형). | |
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
이 캘린더에서 지원되는 회의 솔루션 유형입니다. 사용할 수 있는 값은 다음과 같습니다.
|
|
dataOwner |
string |
캘린더 소유자의 이메일입니다. 보조 캘린더에만 설정됩니다. 읽기 전용입니다. | |
description |
string |
캘린더에 대한 설명입니다. 선택사항입니다. | 쓰기 가능 |
etag |
etag |
리소스의 ETag입니다. | |
id |
string |
캘린더의 식별자입니다. ID를 가져오려면 calendarList.list() 메서드를 호출합니다. | |
kind |
string |
리소스 유형("calendar#calendar")입니다. |
|
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 |
요일입니다. 필수 항목입니다. 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
workingHours.availableTimes[].periodEnd |
integer |
하루 시작부터 경과한 시간(분)으로 표시되는 기간 종료 시간(해당 값 제외)입니다. 필수 항목입니다. | 쓰기 가능 |
workingHours.availableTimes[].periodStart |
integer |
기간 시작(하루 시작부터의 시간(분), 포함)입니다. 필수 항목입니다. | 쓰기 가능 |
workingHours.workingHoursEnabled |
boolean |
이 캘린더에 근무 시간이 사용 설정되어 있는지 여부입니다. availableTimes가 비어 있으면 true로 설정할 수 없습니다. |
쓰기 가능 |
메서드
- clear
- 기본 캘린더를 지웁니다. 이 작업은 계정의 기본 캘린더와 연결된 모든 일정을 삭제합니다.
- 삭제
- 보조 캘린더를 삭제합니다. 기본 캘린더의 모든 일정을 지우려면 calendars.clear를 사용하세요.
- get
- 캘린더의 메타데이터를 반환합니다.
- insert
- 보조 캘린더를 만듭니다.
요청에 대해 인증된 사용자가 새 캘린더의 데이터 소유자가 됩니다.
- patch
- 캘린더의 메타데이터를 업데이트합니다. 이 메소드는 패치 의미 체계를 지원합니다. 각 패치 요청은 할당량 단위 3개를 사용합니다.
get다음에update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드를 지정하면 기존 배열을 덮어쓰며, 이 경우 이전 배열 요소가 삭제됩니다. - transferOwnership
- Google Workspace 조직 내 사용자 간에 보조 캘린더를 이전합니다. 캘린더 관리 관리자 권한이 있는 사용자 인증과 다음 승인 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.calendars
useAdminAccess를true로 설정합니다. 보조 캘린더를 이전하려면 활성 상태여야 합니다. 사용 중지되거나 삭제된 캘린더는 이전할 수 없습니다. - update
- 캘린더의 메타데이터를 업데이트합니다.