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