Method: users.settings.cse.keypairs.disable

توقِف هذه الطريقة زوج مفاتيح التشفير من جهة العميل. لن يتمكّن المستخدم الذي تمّت مصادقته من استخدام زوج المفاتيح لفك تشفير نصوص رسائل "التشفير من جهة العميل" الواردة أو توقيع رسائل "التشفير من جهة العميل" الصادرة.

لاستعادة إمكانية الوصول، استخدِم keypairs.enable لتفعيل زوج المفاتيح.

بعد 30 يومًا، يمكنك حذف زوج المفاتيح نهائيًا باستخدام الطريقة keypairs.obliterate.

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

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

طلب HTTP

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

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

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

المعلمات
userId

string

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

keyPairId

string

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

نص الطلب

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

نص الاستجابة

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

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

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