CalendarList: watch

CalendarList 리소스의 변경사항을 확인합니다.

요청

HTTP 요청

POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch

매개변수

매개변수 이름 설명

승인

이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다.

범위
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.calendarlist
https://www.googleapis.com/auth/calendar.calendarlist.readonly

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

요청 본문

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

{
  "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 타임스탬프로 밀리초 단위로 표시됩니다. 선택사항입니다.