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

Events: watch

Theo dõi những thay đổi đối với tài nguyên về 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ả
Tham 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 lịch chính của người dùng hiện đang đăng nhập, hãy sử dụng "`primary`" từ khoá.
Tham số truy vấn không bắt buộc
`eventTypes`	`string`	Các loại tài nguyên để xem của sự kiện. Không bắt buộc. Bạn có thể lặp lại tham số này nhiều lần để xem các tài nguyên thuộc nhiều loại. Nếu bạn không đặt chính sách này thì hệ thống sẽ trả về tất cả các loại sự kiện. Các giá trị được chấp nhận là: "`default`": Sự kiện định kỳ. "`focusTime`": Sự kiện thời gian cần 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 tại địa điểm 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`

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

Trong nội dung yêu cầu, hãy cung cấp dữ liệu theo 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`	Mã nhận dạng duy nhất (UUID) hoặc chuỗi duy nhất tương tự nhận dạng kênh này.
`token`	`string`	Một chuỗi tuỳ ý được gửi tới địa chỉ đích, trong đó mỗi thông báo được gửi qua kênh này. Không bắt buộc.
`type`	`string`	Loại cơ chế phân phối được sử dụng cho kênh này. Các giá trị hợp lệ là "`web_hook`" (hoặc "`webhook`"). Cả hai giá trị này đều đề cập đến một kênh trong đó các yêu cầu HTTP được dùng để phân phối thông báo.
`address`	`string`	Địa chỉ nhận thông báo 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. Mặc định là 604800 giây.

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như 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à một kênh thông báo dùng để theo dõi các thay đổi đối với một tài nguyên, tức là "`api#channel`".
`id`	`string`	Mã nhận dạng duy nhất (UUID) hoặc chuỗi duy nhất tương tự nhận dạng kênh này.
`resourceId`	`string`	ID 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 cụ thể của tài nguyên được xem.
`token`	`string`	Một chuỗi tuỳ ý được gửi tới địa chỉ đích, trong đó mỗi thông báo được gửi qua kênh này. Không bắt buộc.
`expiration`	`long`	Ngày và thời gian hết hạn kênh thông báo, được biểu thị bằng dấu thời gian Unix, tính bằng mili giây. Không bắt buộc.