API Reference

이 API 참조는 리소스 유형을 기준으로 구성되어 있습니다. 각 리소스 유형은 하나 이상의 데이터 표현 및 하나 이상의 메소드를 갖습니다.

리소스 유형

  1. ACL
  2. CalendarList
  3. 캘린더
  4. 채널
  5. 색상
  6. 이벤트
  7. 한가함/바쁨
  8. 설정

Acl

Acl 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
삭제 DELETE  /calendars/calendarId/acl/ruleId 액세스 제어 규칙을 삭제합니다.
get GET  /calendars/calendarId/acl/ruleId 액세스 제어 규칙을 반환합니다.
insert POST  /calendars/calendarId/acl 액세스 제어 규칙을 만듭니다.
list GET  /calendars/calendarId/acl 캘린더의 액세스 제어 목록에 있는 규칙을 반환합니다.
patch PATCH  /calendars/calendarId/acl/ruleId 액세스 제어 규칙을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 할당량 단위를 3개 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전 배열 요소는 삭제됩니다.
업데이트 PUT  /calendars/calendarId/acl/ruleId 액세스 제어 규칙을 업데이트합니다.
손목시계 POST  /calendars/calendarId/acl/watch ACL 리소스의 변경사항을 확인합니다.

CalendarList

CalendarList 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
삭제 DELETE  /users/me/calendarList/calendarId 사용자의 캘린더 목록에서 캘린더를 삭제합니다.
get GET  /users/me/calendarList/calendarId 사용자의 캘린더 목록에서 캘린더를 반환합니다.
insert POST  /users/me/calendarList 기존 캘린더를 사용자의 캘린더 목록에 삽입합니다.
list GET  /users/me/calendarList 사용자의 캘린더 목록에 있는 캘린더를 반환합니다.
patch PATCH  /users/me/calendarList/calendarId 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 할당량 단위를 3개 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전 배열 요소는 삭제됩니다.
업데이트 PUT  /users/me/calendarList/calendarId 사용자의 캘린더 목록에 있는 기존 캘린더를 업데이트합니다.
손목시계 POST  /users/me/calendarList/watch CalendarList 리소스의 변경사항을 확인합니다.

캘린더

Calendar 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
삭제 POST  /calendars/calendarId/clear 기본 캘린더를 삭제합니다. 이 작업을 수행하면 계정의 기본 캘린더와 연결된 모든 일정이 삭제됩니다.
삭제 DELETE  /calendars/calendarId 보조 캘린더를 삭제합니다. 기본 캘린더의 모든 일정을 삭제하려면 calendar.clear를 사용합니다.
get GET  /calendars/calendarId 캘린더의 메타데이터를 반환합니다.
insert POST  /calendars 보조 캘린더를 만듭니다.
patch PATCH  /calendars/calendarId 캘린더의 메타데이터를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 할당량 단위를 3개 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전 배열 요소는 삭제됩니다.
업데이트 PUT  /calendars/calendarId 캘린더의 메타데이터를 업데이트합니다.

채널

Channel 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
중지 POST  /channels/stop 이 채널을 통한 리소스 시청을 중지합니다.

색상

Colors 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
get GET  /colors 캘린더 및 일정의 색상 정의를 반환합니다.

이벤트

Events 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
삭제 DELETE  /calendars/calendarId/events/eventId 이벤트를 삭제합니다.
get GET  /calendars/calendarId/events/eventId Google Calendar ID를 기준으로 이벤트를 반환합니다. iCalendar ID를 사용하여 이벤트를 검색하려면 iCalUID 매개변수를 사용하여 events.list 메서드를 호출합니다.
import POST  /calendars/calendarId/events/import 이벤트를 가져옵니다. 이 작업은 기존 일정의 비공개 사본을 캘린더에 추가하는 데 사용됩니다. eventType가 default인 이벤트만 가져올 수 있습니다.

지원 중단된 동작: default가 아닌 이벤트를 가져오면 이벤트 유형이 default로 변경되고 이벤트 유형에 따른 속성은 삭제됩니다.
insert POST  /calendars/calendarId/events 이벤트를 만듭니다.
인스턴스 GET  /calendars/calendarId/events/eventId/instances 지정된 반복 이벤트의 인스턴스를 반환합니다.
list GET  /calendars/calendarId/events 지정된 캘린더의 이벤트를 반환합니다.
이동 POST  /calendars/calendarId/events/eventId/move 일정을 다른 캘린더로 이동합니다(예: 일정의 주최자를 변경). default 이벤트만 이동할 수 있습니다. outOfOffice, focusTime, workingLocation, fromGmail 이벤트는 이동할 수 없습니다.

필수 쿼리 매개변수: destination

patch PATCH  /calendars/calendarId/events/eventId 일정을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 할당량 단위를 3개 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에서 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전 배열 요소는 삭제됩니다.
quickAdd POST  /calendars/calendarId/events/quickAdd 간단한 텍스트 문자열을 기반으로 이벤트를 만듭니다.

필수 쿼리 매개변수: text

업데이트 PUT  /calendars/calendarId/events/eventId 일정을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원하지 않으며 항상 전체 이벤트 리소스를 업데이트합니다. 부분 업데이트를 수행하려면 원자성을 보장하기 위해 etag를 사용하여 get를 실행하고 이어서 update를 실행합니다.
손목시계 POST  /calendars/calendarId/events/watch 이벤트 리소스 변경사항을 확인합니다.

한가함/바쁨

한가함/바쁨 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
query POST  /freeBusy 캘린더 집합의 한가함/바쁨 정보를 반환합니다.

설정

Settings 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
별도의 명시가 없는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
get GET  /users/me/settings/setting 단일 사용자 설정을 반환합니다.
list GET  /users/me/settings 인증된 사용자의 모든 사용자 설정을 반환합니다.
손목시계 POST  /users/me/settings/watch 설정 리소스의 변경사항을 확인합니다.