이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Events: watch

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

요청

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

매개변수 이름	값	설명
경로 매개변수
`calendarId`	`string`	캘린더 식별자입니다. 캘린더 ID를 검색하려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 '`primary`'을(를) 사용하세요. 있습니다.
선택적 쿼리 매개변수
`eventTypes`	`string`	감시할 리소스의 이벤트 유형입니다. 선택사항입니다. 이 매개변수를 여러 번 반복하여 다양한 유형의 리소스를 볼 수 있습니다. 설정하지 않으면 모든 이벤트 유형이 반환됩니다. 사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder"> </ph> '`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`	알림 채널의 TTL(수명)(초)입니다. 기본값은 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 타임스탬프로 표현되는 밀리초 단위입니다. 선택사항입니다.