الإشعارات

يمكن لـ Alert Center API إرسال إشعارات عند تعديل التنبيهات. لتلقّي الإشعارات، يجب ضبط إعدادات الإشعارات.

إشعارات Pub/Sub

يمكن لواجهة برمجة التطبيقات Alert Center API نشر إشعارات في موضوع Pub/Sub. بعد إنشاء موضوع ومنح alerts-api-push-notifications@system.gserviceaccount.com إذن النشر، استخدِم واجهة برمجة التطبيقات Alert Center API 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.