يؤدي هذا الإجراء إلى حذف زوج مفاتيح التشفير من جهة العميل نهائيًا وعلى الفور. لا يمكنك حذف أزواج المفاتيح نهائيًا إلا إذا تم إيقافها لأكثر من 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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.