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
}
속성 이름 설명 참고
autoAcceptInvitations boolean 이 캘린더에서 초대를 자동으로 수락하는지 여부입니다. 리소스 캘린더에만 유효합니다.
conferenceProperties nested object 이 캘린더의 회의 속성입니다(예: 허용되는 회의 유형).
conferenceProperties.allowedConferenceSolutionTypes[] list 이 캘린더에 지원되는 회의 솔루션의 유형입니다.

사용할 수 있는 값은 다음과 같습니다.

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
선택사항입니다.

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')) 선택사항입니다. 쓰기 가능

메서드

clear
기본 캘린더를 삭제합니다. 이 작업은 계정의 기본 캘린더와 연결된 모든 일정을 삭제합니다.
삭제
보조 캘린더를 삭제합니다. 기본 캘린더의 모든 일정을 삭제하려면 calendars.clear를 사용하세요.
get
캘린더의 메타데이터를 반환합니다.
insert
보조 캘린더를 만듭니다.

요청에 대해 인증된 사용자가 새 캘린더의 데이터 소유자가 됩니다.

patch
캘린더의 메타데이터를 업데이트합니다. 이 메소드는 패치 의미 체계를 지원합니다. 각 패치 요청은 할당량 단위 3개를 사용합니다. get 다음에 update을 사용하는 것이 좋습니다. 지정한 필드 값은 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드를 지정하면 기존 배열이 덮어쓰여 이전 배열 요소가 삭제됩니다.
transferOwnership
Google Workspace 조직 내 사용자 간에 보조 캘린더를 전송합니다. 캘린더 관리 관리자 권한으로 사용자 인증이 필요하며 다음 승인 범위 중 하나가 필요합니다.
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
요청에서 useAdminAccesstrue로 설정합니다. 보조 캘린더를 전송하려면 활성 상태여야 합니다. 사용 중지되거나 삭제된 캘린더는 이전할 수 없습니다.
업데이트
캘린더의 메타데이터를 업데이트합니다.