REST Resource: channels
منبع: کانال
یک کانال اطلاع رسانی که برای مشاهده تغییرات منابع استفاده می شود.
نمایندگی JSON |
---|
{
"payload": boolean,
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"params": {
string: string,
...
},
"kind": string
} |
فیلدها |
---|
payload | boolean یک مقدار Boolean برای نشان دادن اینکه آیا محموله مورد نظر است یا خیر. اختیاری. |
id | string یک UUID یا یک رشته منحصر به فرد مشابه که این کانال را شناسایی می کند. |
resourceId | string یک شناسه غیر شفاف که منبع در حال تماشا را در این کانال مشخص می کند. در نسخه های مختلف API پایدار است. |
resourceUri | string یک شناسه مخصوص نسخه برای منبع تماشا شده. |
token | string یک رشته دلخواه با هر اعلان از طریق این کانال به آدرس مورد نظر تحویل داده می شود. اختیاری. |
expiration | string ( int64 format) تاریخ و زمان انقضای کانال اعلان، به صورت مهر زمانی یونیکس، در میلی ثانیه بیان می شود. اختیاری. |
type | string نوع مکانیزم تحویل مورد استفاده برای این کانال. مقادیر معتبر "web_hook" یا "webhook" هستند. |
address | string آدرسی که اعلانهای این کانال در آن ارسال میشود. |
params | map (key: string, value: string) پارامترهای اضافی کنترل کننده رفتار کانال تحویل اختیاری. یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
kind | string این را به عنوان یک کانال اعلان شناسایی می کند که برای مشاهده تغییرات در یک منبع، که api#channel است، استفاده می شود. |
روش ها |
---|
| تماشای منابع از طریق این کانال را متوقف می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-13 بهوقت ساعت هماهنگ جهانی."],[[["A Channel is a notification mechanism used to monitor resource changes in Google Drive."],["It delivers notifications to a specified address (webhook) with details about the changes."],["Users can customize the channel by defining payload inclusion, notification token, and delivery parameters."],["The `stop` method allows users to cease resource monitoring through the established Channel."]]],["A notification channel (`Channel`) monitors resource changes. It's represented in JSON with fields like `id` (unique identifier), `resourceId` (resource's opaque ID), `resourceUri` (version-specific resource identifier), `type` (delivery mechanism, e.g., \"webhook\"), and `address` (notification destination). Optional fields include `payload` (indicates payload inclusion), `token` (arbitrary string), `expiration` (Unix timestamp), and `params` (key-value pairs for behavior control). The `stop` method ends the channel's monitoring.\n"]]