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 مدة البقاء (بالثواني) لقناة الإشعار، حيث تكون المدة التلقائية ساعتَين والحد الأقصى لمدة البقاء (TTL) يومان.

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

resourceId

string

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

resourceUri

string

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

kind

string

تحدِّد هذه العملية كقناة إشعار يتم استخدامها لمشاهدة التغييرات التي تطرأ على مورد، وهو api#channel.