Method: users.settings.cse.identities.delete

لحذف هوية تشفير من جهة العميل ل�� يتمكّن المستخدم الذي تمّت المصادقة عليه من استخدام الهوية لإرسال رسائل مشفّرة.

لا يمكنك استعادة الهوية بعد حذفها. بدلاً من ذلك، استخدِم طريقة identities.create لإنشاء هوية أخرى بالإعدادات نفسها.

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

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

طلب HTTP

DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}

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

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

المعلمات
userId

string

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

string

عنوان البريد الإلكتروني الأساسي المرتبط بإعدادات هوية التشفير من جهة العميل التي تمت إزالتها.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة عنصر JSON فارغًا.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.