API Reference

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

리소스 유형

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

Acl

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

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
delete 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 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.

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

채널

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

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

색상

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

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
가져오기 GET  /colors 캘린더 및 일정의 색상 정의를 반환합니다.

이벤트

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

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
delete DELETE  /calendars/calendarId/events/eventId 이벤트를 삭제합니다.
가져오기 GET  /calendars/calendarId/events/eventId Google Calendar ID를 기반으로 일정을 반환합니다. iCalendar ID를 사용하여 일정을 검색하려면 iCalUID 매개변수를 사용하여 events.list 메서드를 호출합니다.
가져오기 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 일정을 다른 캘린더로 이동합니다(예: 일정 주최자 변경).

필수 쿼리 매개변수: destination

패치 PATCH  /calendars/calendarId/events/eventId 일정을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 3개의 할당량 단위를 사용합니다. get 다음에 update를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전의 배열 요소는 삭제됩니다.
빠른 추가 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 캘린더 집합의 한가함/바쁨 정보를 반환합니다.

설정

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

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/calendar/v3의 상대 URI입니다.
가져오기 GET  /users/me/settings/setting 단일 사용자 설정을 반환합니다.
list GET  /users/me/settings 인증된 사용자의 모든 사용자 설정을 반환합니다.
시계 POST  /users/me/settings/watch 설정 리소스의 변경사항을 확인하세요.