Method: domains.list

تعرض هذه الطريقة قائمة بجميع النطاقات التي سجّلتها، بالإضافة إلى البيانات الوصفية المقابلة لها. ترتيب النطاقات في الرد غير محدّد وغير حتمي. لن تتم بالضرورة إضافة النطاقات المسجّلة حديثًا إلى نهاية هذه القائمة.

طلب HTTP

GET https://gmailpostmastertools.googleapis.com/v2/domains

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

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

المعلمات
pageSize

integer

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

string

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

نص الطلب

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

نص الاستجابة

رسالة الرد على domains.list

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

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

object (Domain)

النطاقات التي سجّلها المستخدم
nextPageToken

string

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

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

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

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

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