Method: users.settings.cse.identities.list

يسرد الهويات المشفَّرة من جهة العميل لمستخدم تمت مصادقته.

طلب HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

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

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

المعلمات
userId

string

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

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

المعلمات
pageToken

string

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

integer

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

نص الطلب

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

نص الاستجابة

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

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

object (CseIdentity)

صفحة واحدة لقائمة هويات التشفير من جهة العميل التي تم ضبطها للمستخدم.
nextPageToken

string

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

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

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