SubscriptionChannel
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Một kênh thông báo dùng để theo dõi các thay đổi về tài nguyên.
Biểu diễn dưới dạng JSON |
{
"id": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"payload": boolean,
"params": {
string: string,
...
},
"resourceId": string,
"resourceUri": string,
"kind": string
} |
Trường |
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.
|
expiration |
string (int64 format)
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.
|
type |
string
Loại cơ chế phân phối được dùng cho kênh này.
|
address |
string
Địa chỉ nơi thông báo được gửi cho kênh này.
|
payload |
boolean
Giá trị Boolean cho biết liệu có muốn tải trọng hay không. Không bắt buộc.
|
params |
map (key: string, value: string)
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. Ví dụ: params.ttl chỉ định thời gian tồn tại tính bằng giây cho kênh thông báo, trong đó giá trị mặc định là 2 giờ và TTL tối đa là 2 ngày. Một đối tượng chứa danh sách các cặp "key": value . Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
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.
|
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 .
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-24 UTC."],[],[],null,["# SubscriptionChannel\n\nAn notification channel used to watch for resource changes.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"token\": string, \"expiration\": string, \"type\": string, \"address\": string, \"payload\": boolean, \"params\": { string: string, ... }, \"resourceId\": string, \"resourceUri\": string, \"kind\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` A UUID or similar unique string that identifies this channel. |\n| `token` | `string` An arbitrary string delivered to the target address with each notification delivered over this channel. Optional. |\n| `expiration` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional. |\n| `type` | `string` The type of delivery mechanism used for this channel. |\n| `address` | `string` The address where notifications are delivered for this channel. |\n| `payload` | `boolean` A Boolean value to indicate whether payload is wanted. Optional. |\n| `params` | `map (key: string, value: string)` Additional parameters controlling delivery channel behavior. Optional. For example, `params.ttl` specifies the time-to-live in seconds for the notification channel, where the default is 2 hours and the maximum TTL is 2 days. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `resourceId` | `string` An opaque ID that identifies the resource being watched on this channel. Stable across different API versions. |\n| `resourceUri` | `string` A version-specific identifier for the watched resource. |\n| `kind` | `string` Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`. |"]]