Events: watch

이벤트 리소스의 변경사항을 확인합니다.

요청

HTTP 요청

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch

매개변수

매개변수 이름 설명
경로 매개변수
calendarId string 캘린더 식별자 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary' 키워드를 사용하세요.
선택적 쿼리 매개변수
eventTypes string 모니터링할 리소스의 이벤트 유형입니다. 선택사항입니다. 이 매개변수를 여러 번 반복하여 다양한 유형의 리소스를 볼 수 있습니다. 설정하지 않으면 모든 이벤트 유형이 반환됩니다.

허용되는 값은 다음과 같습니다.
  • 'birthday': 연간 반복되는 특별 종일 일정입니다.
  • 'default': 일반 이벤트입니다.
  • 'focusTime': 방해 금지 시간 일정
  • 'fromGmail': Gmail에 포함된 일정
  • "outOfOffice": 부재중 일정
  • 'workingLocation': 근무 위치 이벤트입니다.

승인

이 요청은 다음 범위 중 하나 이상을 사용한 승인을 허용합니다.

범위
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

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

요청 본문

요청 본문에 다음과 같은 구조의 데이터를 제공합니다.

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
속성 이름 설명 참고
id string 이 채널을 식별하는 UUID 또는 유사한 고유 문자열입니다.
token string 이 채널을 통해 전송되는 각 알림과 함께 대상 주소로 전송되는 임의 문자열입니다. 선택사항입니다.
type string 이 채널에 사용되는 전송 메커니즘 유형입니다. 유효한 값은 'web_hook' (또는 'webhook')입니다. 두 값 모두 메시지를 전송하는 데 Http 요청이 사용되는 채널을 나타냅니다.
address string 이 채널의 알림이 전송되는 주소입니다.
params object 전송 채널 동작을 제어하는 추가 매개변수입니다. 선택사항입니다.
params.ttl string 알림 채널의 수명(초). 기본값은 604,800초입니다.

응답

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

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
속성 이름 설명 참고
kind string 리소스 변경사항을 감시하는 데 사용되는 알림 채널('api#channel')로 식별합니다.
id string 이 채널을 식별하는 UUID 또는 유사한 고유 문자열입니다.
resourceId string 이 채널에서 시청 중인 리소스를 식별하는 불투명한 ID입니다. 다양한 API 버전에서 안정적입니다.
resourceUri string 감시된 리소스의 버전별 식별자입니다.
token string 이 채널을 통해 전송되는 각 알림과 함께 대상 주소로 전송되는 임의의 문자열입니다. 선택사항입니다.
expiration long 알림 채널 만료 날짜 및 시간으로, Unix 타임스탬프로 밀리초 단위로 표시됩니다. 선택사항입니다.