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

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