Method: users.settings.cse.identities.list

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

بالنسبة إلى المشرفين الذين يديرون هويات ومفاتيح للمستخدمين في مؤسستهم، تتطلّب الطلبات الحصول على إذن باستخدام حساب خدمة لديه إذن تفويض على مستوى النطاق لانتحال هوية المستخدمين باستخدام النطاق https://www.googleapis.com/auth/gmail.settings.basic.

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

طلب 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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.