REST Resource: channels
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: القناة
قناة إشعارات تُستخدَم لتتبُّع التغييرات في الموارد.
تمثيل JSON |
{
"params": {
string: string,
...
},
"payload": boolean,
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"kind": string
} |
الحقول |
params |
map (key: string, value: string)
مَعلمات إضافية تتحكّم في سلوك قناة التسليم. اختيارية: عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
payload |
boolean
قيمة منطقية تشير إلى ما إذا كان سيتم عرض الحمولة. اختيارية:
|
id |
string
تمثّل هذه السمة معرّفًا فريدًا عالميًا (UUID) أو سلسلة فريدة مشابهة تحدّد هذه القناة.
|
resourceId |
string
معرّف غير شفاف يحدّد المورد الذي تتم مشاهدته على هذه القناة. تكون ثابتة في مختلف إصدارات واجهة برمجة التطبيقات.
|
resourceUri |
string
معرّف خاص بالإصدار للمورد الذي تمت مشاهدته
|
token |
string
سلسلة عشوائية يتم إرسالها إلى العنوان المستهدف مع كل إشعار يتم تسليمه عبر هذه القناة. اختيارية:
|
expiration |
string (int64 format)
تاريخ ووقت انتهاء صلاحية قناة الإشعارات، ويتم التعبير عنهما كطابع زمني لنظام التشغيل Unix، بالمللي ثانية. اختيارية:
|
type |
string
نوع آلية العرض المستخدَمة لهذه القناة القيم الصالحة هي "web_hook" أو "webhook".
|
address |
string
عنوان البريد الإلكتروني الذي يتم إرسال الإشعارات إليه لهذه القناة.
|
kind |
string
تحدّد هذه السمة قناة إشعارات تُستخدَم لتتبُّع التغييرات في أحد الموارد، وهو api#channel .
|
الطُرق |
|
تتوقف عن مشاهدة المراجع من خلال هذه القناة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: channels\n\n- [Resource: Channel](#Channel)\n - [JSON representation](#Channel.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Channel\n-----------------\n\nA notification channel used to watch for resource changes.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"params\": { string: string, ... }, \"payload\": boolean, \"id\": string, \"resourceId\": string, \"resourceUri\": string, \"token\": string, \"expiration\": string, \"type\": string, \"address\": string, \"kind\": string } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `params` | `map (key: string, value: string)` Additional parameters controlling delivery channel behavior. Optional. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `payload` | `boolean` A Boolean value to indicate whether payload is wanted. Optional. |\n| `id` | `string` A UUID or similar unique string that identifies this channel. |\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| `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. Valid values are \"web_hook\" or \"webhook\". |\n| `address` | `string` The address where notifications are delivered for this channel. |\n| `kind` | `string` Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`. |\n\n| Methods ------- ||\n|------------------------------------------------------------------|------------------------------------------------|\n| ### [stop](/workspace/drive/api/reference/rest/v2/channels/stop) | Stops watching resources through this channel. |"]]