이벤트 리소스의 변경사항을 확인합니다.
요청
HTTP 요청
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
경로 매개변수 | ||
calendarId |
string |
캘린더 식별자 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary ' 키워드를 사용하세요.
|
선택적 쿼리 매개변수 | ||
eventTypes |
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 |
자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
요청 본문에 다음과 같은 구조의 데이터를 제공합니다.
{ "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 타임스탬프로 밀리초 단위로 표시됩니다. 선택사항입니다. |