Method: users.settings.cse.keypairs.get

يستردّ هذا الإجراء زوج مفاتيح تشفير حالي من جهة العميل.

بالنسبة إلى المشرفين الذين يديرون هويات ومفاتيح للمستخدمين في مؤسستهم، تتطلّب الطلبات الحصول على إذن باستخدام حساب خدمة لديه إذن تفويض على مستوى النطاق لانتحال هوية المستخدمين باستخدام النطاق https://www.googleapis.com/auth/gmail.settings.basic.

بالنسبة إلى المستخدمين الذين يديرون هوياتهم وأزواج المفاتيح، تتطلّب الطلبات تفعيل تشفير مفتاح الجهاز وإعداده.

طلب HTTP

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

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

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

المعلمات
userId

string

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

string

معرّف مفتاحَي التشفير المطلوب استردادهما.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال CseKeyPair.

نطاقات الأذونات

يجب توفير أحد نطاقات 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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.