يحذف زوج مفاتيح التشفير من جهة العميل نهائيًا وعلى الفور. يمكنك فقط حذف أزواج المفاتيح نهائيًا التي تم إيقافها لمدة تزيد عن 30 يومًا. لإيقاف زوج مفاتيح، استخدِم الطريقة keypairs.disable.
لا يمكن لـ Gmail استعادة أو فك تشفير أي رسائل تم تشفيرها باستخدام مفتاح تم إتلافه. لن يتمكّن المستخدمون الذين تم إثبات ملكيتهم ومشرفو Google Workspace من قراءة الرسائل المشفّرة.
بالنسبة إلى المشرفين الذين يديرون هويات ومفاتيح للمستخدمين في مؤسستهم، تتطلّب الطلبات الحصول على إذن باستخدام حساب خدمة لديه إذن تفويض على مستوى النطاق لانتحال هوية المستخدمين باستخدام النطاق https://www.googleapis.com/auth/gmail.settings.basic.
بالنسبة إلى المستخدمين الذين يديرون هوياتهم وأزواج المفاتيح، تتطلّب الطلبات تفعيل تشفير مفتاح الجهاز وإعداده.
طلب HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
userId |
عنوان البريد الإلكتروني الأساسي لصاحب الطلب للإشارة إلى المستخدم الذي تمّت مصادقته، يمكنك استخدام القيمة الخاصة |
keyPairId |
معرّف مفتاحَي التشفير المطلوب إتلافهما. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.
نطاقات الأذونات
يجب توفير أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.