Trang này được dịch bởi Cloud Translation API.

Events: watch

Theo dõi các thay đổi đối với tài nguyên Sự kiện.

Yêu cầu

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

Tên thông số	Giá trị	Mô tả
Thông số đường dẫn
`calendarId`	`string`	Giá trị nhận dạng lịch. Để truy xuất mã lịch, hãy gọi phương thức calendarList.list. Nếu bạn muốn truy cập vào lịch chính của người dùng hiện đã đăng nhập, hãy sử dụng từ khoá "`primary`".
Thông số truy vấn không bắt buộc
`eventTypes`	`string`	Loại sự kiện của tài nguyên cần theo dõi. Không bắt buộc. Bạn có thể lặp lại tham số này nhiều lần để theo dõi các tài nguyên thuộc nhiều loại. Nếu không được đặt, sẽ trả về tất cả các loại sự kiện. Các giá trị được chấp nhận là: "`birthday`": Sự kiện đặc biệt kéo dài cả ngày, lặp lại hằng năm. "`default`": Sự kiện định kỳ. "`focusTime`": Sự kiện thời gian tập trung. "`fromGmail`": Sự kiện từ Gmail. "`outOfOffice`": Sự kiện không có mặt tại văn phòng. "`workingLocation`": Sự kiện vị trí làm việc.

Yêu cầu này cho phép uỷ quyền với ít nhất một trong các phạm vi sau:

Phạm vi
`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`

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Trong phần nội dung yêu cầu, hãy cung cấp dữ liệu có cấu trúc sau:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

Tên tài sản	Giá trị	Mô tả
`id`	`string`	UUID hoặc chuỗi duy nhất tương tự giúp xác định kênh này.
`token`	`string`	Một chuỗi tuỳ ý được phân phối đến địa chỉ mục tiêu cùng với mỗi thông báo được phân phối qua kênh này. Không bắt buộc.
`type`	`string`	Loại cơ chế phân phối được dùng cho kênh này. Các giá trị hợp lệ là "`web_hook`" (hoặc "`webhook`"). Cả hai giá trị đều đề cập đến một kênh mà các yêu cầu Http được dùng để phân phối thông báo.
`address`	`string`	Địa chỉ nơi thông báo được gửi cho kênh này.
`params`	`object`	Các tham số bổ sung kiểm soát hành vi của kênh phân phối. Không bắt buộc.
`params.ttl`	`string`	Thời gian tồn tại tính bằng giây cho kênh thông báo. Giá trị mặc định là 604800 giây.

Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

Tên tài sản	Giá trị	Mô tả
`kind`	`string`	Xác định đây là kênh thông báo dùng để theo dõi các thay đổi đối với một tài nguyên, đó là "`api#channel`".
`id`	`string`	UUID hoặc chuỗi duy nhất tương tự giúp xác định kênh này.
`resourceId`	`string`	Mã nhận dạng mờ xác định tài nguyên đang được xem trên kênh này. Ổn định trên nhiều phiên bản API.
`resourceUri`	`string`	Giá trị nhận dạng theo phiên bản cho tài nguyên được theo dõi.
`token`	`string`	Một chuỗi tuỳ ý được phân phối đến địa chỉ mục tiêu cùng với mỗi thông báo được phân phối qua kênh này. Không bắt buộc.
`expiration`	`long`	Ngày và giờ hết hạn của kênh thông báo, được biểu thị dưới dạng dấu thời gian Unix, tính bằng mili giây. Không bắt buộc.