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

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