Method: customers.quarantinedMessages.list

طلبات البحث عن الرسائل المعزولة باستخدام شروط فلترة محدّدة

طلب HTTP

GET https://mailadminquarantine.googleapis.com/v1/{parent=customers/*}/quarantinedMessages

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

الحقل مطلوب. المورد الرئيسي الذي يملك هذه المجموعة من الرسائل التنسيق: customers/{customer_id}

مَعلمات طلب البحث

المعلمات
pageSize

integer

اختيارية: الحد الأقصى لعدد العناصر التي سيتم عرضها.
pageToken

string

اختيارية: قيمة nextPageToken التي تم عرضها من طلب List سابق.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ لـ [quarantinedMessages.list][].

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "quarantinedMessages": [
    {
      object (QuarantinedMessage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
الحقول
quarantinedMessages[]

object (QuarantinedMessage)

قائمة الرسائل المعزولة التي تطابق الطلب
nextPageToken

string

رمز مميّز لاسترداد الصفحة التالية من النتائج
unreachable[]

string

الحسابات التي لم تتمكّن الخدمة من استرداد الرسائل المعزولة لها

نطاقات الأذونات

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/gmail.admin.quarantine
  • https://www.googleapis.com/auth/gmail.admin.quarantine.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.