SubscriptionChannel

قناة إشعارات تُستخدَم لرصد التغييرات في الموارد

تمثيل JSON
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
الحقول
id

string

معرّف فريد عالمي (UUID) أو سلسلة فريدة مشابهة تحدد هذه القناة.

token

string

سلسلة عشوائية يتم إرسالها إلى العنوان المستهدف مع كل إشعار يتم إرساله عبر هذه القناة. اختياريّ.

expiration

string (int64 format)

تاريخ ووقت انتهاء صلاحية قناة الإشعار، معبرًا عنه بطابع زمني لنظام التشغيل Unix، بالمللي ثانية اختياريّ.

type

string

نوع آلية إرسال المحتوى المستخدَمة في هذه القناة.

address

string

العنوان الذي يتم إرسال الإشعارات إليه لهذه القناة

payload

boolean

قيمة منطقية للإشارة إلى ما إذا كانت الحمولة مطلوبة. اختياريّ.

params

map (key: string, value: string)

معلَمات إضافية تتحكّم في سلوك قناة التسليم. اختياريّ. على سبيل المثال، يحدّد params.ttl مدة البقاء بالثواني لقناة الإشعارات، حيث تكون القيمة التلقائية ساعتَين والحد الأقصى لمدة البقاء هو يومَين.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

resourceId

string

معرّف مبهم يحدد المورد الذي تتم مشاهدته على هذه القناة. استقرار في إصدارات واجهة برمجة التطبيقات المختلفة

resourceUri

string

معرّف خاص بالإصدار للمورد الذي تمت مشاهدته.

kind

string

يحدّد هذا الحقل على أنّه قناة إشعارات تُستخدَم لرصد التغييرات في أحد الموارد، وهو "api#channel".