Events: instances

지정된 반복 일정의 인스턴스를 반환합니다. 지금 사용해 보기

요청

HTTP 요청

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

매개변수

매개변수 이름 값 설명
경로 매개변수
calendarId string 캘린더 식별자입니다. 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출하세요. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary' 키워드를 사용하세요.
eventId string 반복 일정 식별자입니다.
선택 쿼리 매개변수
alwaysIncludeEmail boolean 지원 중단되고 무시됩니다. 실제 이메일 주소가 없더라도 (즉, 생성된 작동하지 않는 값이 제공됨) 주최자, 작성자, 참석자의 email 필드에 항상 값이 반환됩니다.
maxAttendees integer 응답에 포함할 참석자의 최대 수입니다. 지정된 참석자 수보다 많은 참석자가 있는 경우 참가자만 반환됩니다. 선택사항입니다.
maxResults integer 결과 페이지 하나에 반환되는 이벤트의 최대 수입니다. 기본값은 250개의 이벤트입니다. 페이지 크기는 2,500개의 이벤트보다 클 수 없습니다. 선택사항입니다.
originalStart string 결과에 있는 인스턴스의 원래 시작 시간입니다. 선택사항입니다.
pageToken string 반환할 결과 페이지를 지정하는 토큰입니다. 선택사항입니다.
showDeleted boolean 결과에 삭제된 이벤트 (status가 'cancelled'인 이벤트)를 포함할지 여부입니다. singleEvents가 False인 경우 되풀이 일정의 취소된 인스턴스가 계속 포함됩니다. 선택사항입니다. 기본값은 False입니다.
timeMax datetime 필터링할 이벤트 시작 시간의 상한 (제외)입니다. 선택사항입니다. 기본값은 시작 시간으로 필터링하지 않는 것입니다. 시간대 오프셋이 필수인 RFC3339 타임스탬프여야 합니다.
timeMin datetime 필터링할 이벤트 종료 시간의 하한 (포함)입니다. 선택사항입니다. 기본값은 종료 시간으로 필터링하지 않는 것입니다. 시간대 오프셋이 필수인 RFC3339 타임스탬프여야 합니다.
timeZone string 응답에 사용되는 시간대입니다. 선택사항입니다. 기본값은 캘린더의 시간대입니다.

승인

이 요청은 다음 범위 중 하나 이상을 사용하여 승인할 수 있습니다.

범위
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

자세한 내용은 인증 및 승인 페이지를 참고하세요.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "calendar#events",
  "etag": etag,
  "summary": string,
  "description": string,
  "updated": datetime,
  "timeZone": string,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    events Resource
  ]
}
속성 이름 값 설명 참고
kind string 컬렉션 유형('calendar#events')입니다.
etag etag 컬렉션의 ETag입니다.
summary string 캘린더의 제목입니다. 읽기 전용입니다.
description string 캘린더의 설명입니다. 읽기 전용입니다.
updated datetime 캘린더의 마지막 수정 시간 (RFC3339 타임스탬프)입니다. 읽기 전용입니다.
timeZone string 캘린더의 시간대입니다. 읽기 전용입니다.
accessRole string 이 캘린더에 대한 사용자의 액세스 역할입니다. 읽기 전용입니다. 가능한 값은 다음과 같습니다.
  • '"none"' - 사용자에게 액세스 권한이 없습니다.
  • "freeBusyReader" - 사용자에게 일정 정보에 대한 읽기 액세스 권한이 있습니다.
  • "reader" - 사용자에게 캘린더에 대한 읽기 액세스 권한이 있습니다. 비공개 일정은 읽기 액세스 권한이 있는 사용자에게 표시되지만 일정 세부정보는 숨겨집니다.
  • "writerWithoutPrivateAccess" - 사용자에게 캘린더에 대한 읽기 및 쓰기 액세스 권한이 있습니다. 비공개 일정은 writerWithoutPrivateAccess 액세스 권한이 있는 사용자에게 표시되지만 일정 세부정보는 숨겨집니다.
  • "writer" \- 사용자에게 캘린더에 대한 읽기 및 쓰기 액세스 권한이 있습니다. 비공개 일정은 작성자 액세스 권한이 있는 사용자에게 표시되며 일정 세부정보가 표시됩니다.
  • "owner" - 사용자에게 캘린더에 대한 관리자 액세스 권한이 있습니다. 이 역할에는 다른 사용자의 액세스 수준을 보고 수정할 수 있는 추가 기능과 함께 작성자 역할의 모든 권한이 있습니다.

defaultReminders[] list 인증된 사용자의 캘린더에 있는 기본 리마인더입니다. 이러한 리마인더는 명시적으로 재정의하지 않는 (즉, reminders.useDefault가 True로 설정되지 않은) 이 캘린더의 모든 이벤트에 적용됩니다.
defaultReminders[].method string 이 리마인더에서 사용하는 메서드입니다. 가능한 값은 다음과 같습니다.
  • "email" - 리마인더는 이메일을 통해 전송됩니다.
  • "popup" - 리마인더는 UI 팝업을 통해 전송됩니다.

리마인더를 추가할 때 필요합니다.

 쓰기 가능
defaultReminders[].minutes integer 리마인더가 실행되어야 하는 이벤트 시작 전 시간(분)입니다. 유효한 값은 0~40320(4주(분))입니다.

리마인더를 추가할 때 필요합니다.

 쓰기 가능
nextPageToken string 이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. 추가 결과가 없는 경우 생략되며, 이 경우 nextSyncToken이 제공됩니다.
items[] list 캘린더의 이벤트 목록입니다.
nextSyncToken string 이 결과가 반환된 이후 변경된 항목만 가져오기 위해 나중에 사용되는 토큰입니다. 추가 결과가 있는 경우 생략되며, 이 경우 nextPageToken이 제공됩니다.

기능을 사용해 보세요.

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.