إيقاف زوج مفاتيح التشفير من جهة العميل لن يتمكّن المستخدم الذي تمّت مصادقة هويته من استخدام مفتاحَي التشفير لفك تشفير نصوص الرسائل الواردة المشفَّرة من جهة العميل أو توقيع الرسائل الإلكترونية الصادرة المشفَّرة من جهة العميل.
لاستعادة إمكانية الوصول، استخدِم 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 |
عنوان البريد الإلكتروني الأساسي للمطلوب منه للإشارة إلى المستخدم الذي تمّت مصادقة هويته، يمكنك استخدام القيمة الخاصة |
keyPairId |
معرّف مفتاحَي التشفير المطلوب إيقافهما |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال CseKeyPair.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.