نظرة عامة على Mail Admin Quarantine API

تتيح واجهة Mail Admin Quarantine API لمشرفي حسابات Google Workspace إدارة الرسائل الإلكترونية التي يحتفظ بها Gmail في وحدة عزل المشرف آليًا. تصل الرسائل إلى وحدة العزل عندما تتطابق مع قواعد الامتثال أو منع فقدان البيانات (DLP) أو قواعد الأمان التي تضبطها في "وحدة تحكّم المشرف في Google".

استخدِم واجهة برمجة التطبيقات لإنشاء عمليات تشغيل آلي للأمان والامتثال، مثل:

  • استرداد الرسائل المعزولة إلى منصة SIEM أو SOAR لفرزها
  • مراجعة رؤوس الرسائل ومقتطفات النص والمرفقات قبل تحديد كيفية التعامل مع الرسالة
  • تحرير الرسائل الآمنة ورفض الرسائل غير الآمنة، بشكل فردي أو في دفعات تصل إلى 500 رسالة

المصادر الرئيسية

تعرض واجهة Admin Quarantine API الموارد التالية ضمن العميل:

المورد اسم المورد الوصف
العميل customers/CUSTOMER_ID حسابك على Google Workspace لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة العثور على رقم تعريف العميل.
customers.quarantinedMessages customers/CUSTOMER_ID/quarantinedMessages/MESSAGE_OWNER:MESSAGE_ID رسالة إلكترونية محجوزة في وحدة عزل ‫MESSAGE_OWNER هو عنوان البريد الإلكتروني لمالك صندوق البريد وMESSAGE_ID هو معرّف رسالة Gmail غير القابل للتغيير.
customers.quarantines customers/CUSTOMER_ID/quarantines/QUARANTINE_ID عزل ضبطته في "وحدة تحكّم المشرف"
customers.operations customers/CUSTOMER_ID/operations/OPERATION_ID عملية طويلة الأمد تتتبّع طلب إصدار أو رفض مجمّع

يحتوي QuarantinedMessage على أحد عناصر State التالية:

ولاية الوصف
PENDING_TRIAGE يتم احتجاز الرسالة في وحدة عزل بانتظار قرار المشرف.
RELEASED أطلق أحد المشرفين الرسالة وسلّمها Gmail.
DENIED رفض أحد المشرفين الرسالة وتجاهلها Gmail.

الطُرق

تستهدف جميع الطلبات https://mailadminquarantine.googleapis.com/v1.

الطريقة طلب HTTP الوصف
customers.quarantinedMessages.list GET /customers/*/quarantinedMessages تعرض هذه الصفحة الرسائل المعزولة من آخر 30 يومًا.
customers.quarantinedMessages.search POST /customers/*/quarantinedMessages:search للبحث في الرسائل المعزولة باستخدام فلتر أو طلب بحث في Gmail
customers.quarantinedMessages.get GET /customers/*/quarantinedMessages/* تتيح هذه الطريقة الحصول على البيانات الوصفية أو المحتوى الذي تم تحليله أو رسالة RFC 2822 الأولية.
customers.quarantinedMessages.release POST /customers/*/quarantinedMessages/*:release لإصدار رسالة واحدة للتسليم.
customers.quarantinedMessages.deny POST /customers/*/quarantinedMessages/*:deny لرفض رسالة واحدة
customers.quarantinedMessages.batchRelease POST /customers/*/quarantinedMessages:batchRelease يتم إصدار ما يصل إلى 500 رسالة بشكل غير متزامن.
customers.quarantinedMessages.batchDeny POST /customers/*/quarantinedMessages:batchDeny يتم رفض ما يصل إلى 500 رسالة بشكل غير متزامن.
customers.operations.get GET /customers/*/operations/* تتيح هذه الطريقة الحصول على حالة عملية مجمّعة ونتائجها.
customers.quarantines.list GET /customers/*/quarantines تعرض هذه الطريقة قائمة بوحدات العزل التي تم ضبطها للعميل.
customers.quarantines.get GET /customers/*/quarantines/* للحصول على الاسم المعروض للعزل ووصفه

خطوات التنفيذ العالي المستوى

  1. إعداد واجهة برمجة التطبيقات: انضم إلى برنامج معاينة المطور، وفعِّل واجهة برمجة التطبيقات في مشروعك على Google Cloud، وابحث عن رقم تعريف العميل، وامنح امتيازات المشرف المطلوبة.
  2. التفويض باستخدام التفويض على مستوى النطاق: يمكنك إنشاء حساب خدمة وضبط التفويض على مستوى النطاق باستخدام نطاقات Admin Quarantine API والحصول على رمز دخول ينتحل هوية مشرف.
  3. فرز الرسائل:
    1. عرض الرسائل المعزولة والبحث عنها
    2. الحصول على تفاصيل الرسالة
    3. الموافقة على رسالة أو رفضها أو الموافقة على الرسائل أو رفضها بشكل مجمّع
  4. الالتزام بحصص الاستخدام

تسجيل التدقيق

يتم تسجيل كل طلب بيانات من واجهة برمجة التطبيقات يقرأ الرسائل المعزولة أو يغيّرها في سجلات التدقيق والتحقيق في "وحدة تحكّم المشرف"، ويتم نسبه إلى المشرف الذي يتم تنفيذ الطلب باسمه.

الخطوات التالية