이 API 참조는 리소스 유형을 기준으로 구성되어 있습니다. 각 리소스 유형은 하나 이상의 데이터 표현 및 하나 이상의 메소드를 갖습니다.
리소스 유형
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
|
일정을 다른 캘린더로 이동합니다(예: 일정 주최자 변경).
필수 쿼리 매개변수:
|
패치 |
PATCH /calendars/calendarId/events/eventId
|
일정을 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다. 각 패치 요청은 3개의 할당량 단위를 사용합니다. get 다음에 update 를 사용하는 것이 좋습니다. 지정한 필드 값이 기존 값을 대체합니다. 요청에 지정하지 않은 필드는 변경되지 않습니다. 배열 필드가 지정된 경우 기존 배열을 덮어씁니다. 이전의 배열 요소는 삭제됩니다.
|
빠른 추가 |
POST /calendars/calendarId/events/quickAdd
|
간단한 텍스트 문자열을 기반으로 이벤트를 만듭니다.
필수 쿼리 매개변수:
|
업데이트 |
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
|
설정 리소스의 변경사항을 확인하세요. |