يعرض هذا العمود الهويات المشفَّرة من جهة العميل لمستخدم تمت مصادقته.
طلب HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
userId |
عنوان البريد الإلكتروني الرئيسي لمقدّم الطلب. للإشارة إلى المستخدم الذي تمت مصادقته، يمكنك استخدام القيمة الخاصة |
معلمات طلب البحث
المَعلمات | |
---|---|
pageToken |
رمز مميز للتقسيم على صفحات يشير إلى صفحة الهويات المطلوب عرضها إذا لم يتم تقديم الرمز المميز، ستعرض واجهة برمجة التطبيقات الصفحة الأولى من النتائج. |
pageSize |
عدد الهويات المطلوب عرضها. وفي حال عدم توفيرها، سيتم ضبط حجم الصفحة تلقائيًا على 20 إدخالاً. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"cseIdentities": [
{
object ( |
الحقول | |
---|---|
cseIdentities[] |
صفحة واحدة من قائمة هويات ميزة "التشفير من جهة العميل" التي تم ضبطها للمستخدم. |
nextPageToken |
يتم تمرير الرمز المميز للتقسيم على صفحات إلى استدعاء 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
لمزيد من المعلومات، راجِع دليل التفويض.