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