الإشعارات

يمكن لواجهة برمجة التطبيقات الخاصة بـ "مركز التنبيه" إرسال إشعارات عند تعديل التنبيهات. لتلقّي الإشعارات، يجب ضبط إعدادات الإشعارات.

إشعارات Pub/Sub

يمكن لواجهة Alert Center API نشر الإشعارات في موضوع Pub/Sub. بعد إنشاء موضوع ومنح إذن النشر [e-mail]، استخدِم واجهة برمجة التطبيقات update settings API في "مركز التنبيهات" لضبط هذا الموضوع كوجهة للإشعارات. بعد ضبط واجهة برمجة التطبيقات، تنشر واجهة Alert Center API رسالة إلى هذا الموضوع لكل تعديل، مثل عند وصول تنبيه جديد.

سمات رسائل Pub/Sub

توضّح الأقسام التالية السمات المضمّنة في رسائل Pub/Sub.

السمات الشائعة

• ‫alertcenter_resource_type: تشير إلى نوع المورد. القيمة المسموح بها هي "ALERT".
• ‫alertcenter_resource_status: تشير إلى حالة المورد. القيم المسموح بها هي "CREATED" و"DELETED" و"UNDELETED" و"MODIFIED".
• ‫alertcenter_payload_format: تمثّل هذه السمة تنسيق الحمولة. القيمة المسموح بها هي "JSON".

سمات التنبيه

• alertcenter_start_time: الوقت الذي بدأ فيه الحدث الذي تسبّب في ظهور هذا التنبيه أو تم رصده.
• alertcenter_end_time: الوقت الذي توقّف فيه الحدث الذي تسبّب في هذا التنبيه عن النشاط.
• ‫alertcenter_type: تمثّل هذه السمة نوع التنبيه. للاطّلاع على قائمة بأنواع التنبيهات المتاحة، يُرجى الانتقال إلى أنواع تنبيهات Google Workspace.
• ‫alertcenter_source: معرّف فريد للنظام الذي أبلغ عن التنبيه.
• alertcenter_create_time: الوقت الذي تم فيه إنشاء هذا التنبيه.
• ‫alertcenter_update_time: آخر مرة تم فيها تعديل هذا التنبيه.

حمولة الرسالة

يعتمد حمولة الرسالة على alertcenter_resource_type. عندما يكون نوع المورد "ALERT"، تكون الحمولة أحد أنواع التنبيهات في Alert Center API. يعتمد تنسيق الحمولة على alertcenter_payload_format. عندما يكون التنسيق "JSON"، يكون الحمولة عبارة عن عنصر JSON مترمّز بنظام base64.