Method: users.settings.cse.keypairs.list

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

طلب HTTP

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

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

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

المعلمات
userId

string

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

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

المعلمات
pageToken

string

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

integer

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

نص الطلب

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

نص الاستجابة

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

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

object (CseKeyPair)

صفحة واحدة لقائمة أزواج مفاتيح التشفير من جهة العميل المثبَّتة للمستخدم.
nextPageToken

string

يجب تمرير الرمز المميّز للتقسيم على صفحات إلى طلب keypairs.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

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