Method: domains.users.list

تعرض هذه السمة قائمة بالمستخدمين الذين يمكنهم الوصول إلى نطاق معيّن.

طلب HTTP

GET https://gmailpostmastertools.googleapis.com/v2beta/{parent=domains/*}/users

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

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

المعلمات
parent

string

الحقل مطلوب. اسم المورد الأصل الذي سيتم عرض قائمة بالمستخدمين له. التنسيق: domains/{domain}

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

المعلمات
pageSize

integer

اختياريّ. حجم الصفحة المطلوب قد يعرض الخادم عددًا أقل من المستخدمين المطلوبين. إذا لم يتم تحديد قيمة، ستكون القيمة التلقائية لهذا الحقل هي 10. الحدّ الأقصى لقيمة هذا الحقل هو 200.
pageToken

string

اختياريّ. قيمة nextPageToken التي تم إرجاعها من طلب List سابق، إن وُجدت.

نص الطلب

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

نص الاستجابة

رسالة الردّ على طلب users.list.

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

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

object (User)

المستخدمون الذين يمكنهم الوصول إلى النطاق
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج، أو فارغ إذا لم تكن هناك نتائج أخرى في القائمة.

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/postmaster
  • https://www.googleapis.com/auth/postmaster.user

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