API Reference

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

리소스 유형

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

Acl

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

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

CalendarList

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

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

캘린더

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

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

채널

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

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

색상

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

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

이벤트

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

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

필수 쿼리 매개변수: destination

패치 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 요청 설명
별도의 명시가 없는 한 URI는 https://www.googleapis.com/calendar/v3을 기준으로 합니다.
query POST  /freeBusy 여러 캘린더의 한가함/바쁨 정보를 반환합니다.

설정

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

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