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

لمزيد من المعلومات، راجِع دليل التفويض.