المرجع: مشاهدة
ساعة عن الأحداث لنموذج عند وقوع الحدث المحدّد، سيتم نشر إشعار إلى الهدف المحدّد. ستتضمّن سمات الإشعار مفتاح formId
يحمل رقم تعريف النموذج الذي تمت مشاهدته ومفتاح eventType
يحتوي على النوع من السلسلة.
يتم إرسال الرسائل في مرة واحدة على الأقل للتسليم ولا يتم تجاهلها إلا في ظروف استثنائية. يتم عادةً تسليم جميع الإشعارات بشكل موثوق في غضون بضع ثوانٍ. ولكن في بعض الحالات، قد تتأخر الإشعارات.
تنتهي صلاحية الساعة بعد سبعة أيام من إنشائها ما لم يتم تجديدها باستخدام watches.renew
.
تمثيل JSON |
---|
{ "id": string, "target": { object ( |
الحقول | |
---|---|
id |
النتائج فقط. رقم تعريف هذه الساعة. الاطّلاع على الملاحظات على |
target |
مطلوب. مكان إرسال الإشعار |
eventType |
مطلوب. نوع الحدث الذي يجب مراقبته |
createTime |
النتائج فقط. الطابع الزمني لوقت إنشاء هذه الملاحظة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
expireTime |
النتائج فقط. طابع زمني لوقت انتهاء صلاحية هذا الإذن كل مكالمة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
errorType |
النتائج فقط. أحدث نوع خطأ لعملية تسليم تمت محاولة إجرائها. لبدء مشاهدة النموذج مرة أخرى، يمكن إجراء مكالمة مع الرقم |
state |
النتائج فقط. الحالة الحالية للساعة يمكنك الحصول على تفاصيل إضافية عن الساعات المعلّقة من خلال التحقّق من |
WatchTarget
الهدف من إرسال الإشعارات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد target . مطلوب. الهدف من إرسال الإشعارات. يمكن أن يكون target واحدًا فقط مما يلي: |
|
topic |
موضوع النشر/الاشتراك لتلقّي الإشعارات، يجب أن يمنح الموضوع امتيازات النشر إلى حساب خدمة "نماذج Google" يجب مراعاة ضمانات إرسال الإعلانات من خلال النشر/الاشتراك. |
CloudPubsubTopic
موضوع النشر/الاشتراك
تمثيل JSON |
---|
{ "topicName": string } |
الحقول | |
---|---|
topicName |
مطلوب. اسم موضوع نشر/اشتراك مؤهل بالكامل لنشر الفعاليات إليه. يجب أن يكون هذا الموضوع ملكًا لمشروع الاتصال وأن يكون متوفّرًا في نشرة/اشتراك. |
EventType
أنواع الأحداث المحتملة التي يمكن مشاهدتها.
عمليات التعداد | |
---|---|
EVENT_TYPE_UNSPECIFIED |
نوع حدث غير محدَّد يجب عدم استخدام هذه القيمة. |
SCHEMA |
نوع حدث المخطط سيتم إرسال إشعار إلى ساعة من هذا النوع من الأحداث بشأن التغييرات التي تطرأ على محتوى النموذج والإعدادات. |
RESPONSES |
نوع حدث الردود سيتم إشعار ساعة من هذا النوع من الأحداث عند إرسال الردود على النموذج. |
ErrorType
أنواع الأخطاء المحتملة.
عمليات التعداد | |
---|---|
ERROR_TYPE_UNSPECIFIED |
نوع خطأ غير محدَّد |
PROJECT_NOT_AUTHORIZED |
لا يمكن للمشروع على السحابة الإلكترونية الوصول إلى النموذج الذي تتم مشاهدته. يحدث ذلك في حال إبطال المستخدم لتفويض مشروعك بالوصول إلى نماذجه. ولن تتم إعادة محاولة الساعات التي يظهر فيها هذا الخطأ. لبدء مشاهدة النموذج من جديد، يمكن إجراء مكالمة على الرقم watches.renew . |
NO_USER_ACCESS |
لم يعد بإمكان المستخدم الذي منح إمكانية الوصول الوصول إلى النموذج الذي تتم مشاهدته. ولن تتم إعادة محاولة الساعات التي يظهر فيها هذا الخطأ. لبدء مشاهدة النموذج من جديد، يمكن إجراء مكالمة على الرقم watches.renew . |
OTHER_ERRORS |
حدث نوع آخر من الأخطاء. ويعتمد استمرار الإشعارات على "state " للساعة. |
الحالة
حالات المشاهدة المحتمَلة
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
حالة غير محدَّدة. |
ACTIVE |
الساعة نشطة. |
SUSPENDED |
تم تعليق الساعة بسبب خطأ قد يتم إصلاحه. ستظل الساعة متوفّرة إلى أن تنتهي صلاحيتها. لمحاولة إعادة تفعيل الساعة، يمكن إجراء مكالمة مع "watches.renew ". |
الطُرق |
|
---|---|
|
إنشاء ساعة جديدة |
|
حذف ساعة |
|
إرجاع قائمة بالساعات التي يملكها مشروع الاستدعاء |
|
جدِّد ساعة حالية لمدة سبعة أيام. |