Method: users.settings.cse.identities.delete
لحذف هوية "التشفير من جهة العميل" لن يتمكّن المستخدم الذي تمّت المصادقة عليه من استخدام الهوية لإرسال رسائل مشفّرة.
لا يمكنك استعادة الهوية بعد حذفها. بدلاً من ذلك، استخدِم طريقة identities.create لإنشاء هوية أخرى بالإعدادات نفسها.
طلب 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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Permanently deletes a client-side encryption identity, preventing the authenticated user from sending encrypted messages with it."],["Requires providing the user's primary email address and the email address associated with the identity to be deleted in the request URL."],["The request body should be empty, and a successful deletion results in an empty response body."],["Proper authorization with specific OAuth scopes (`gmail.settings.basic` or `gmail.settings.sharing`) is necessary to perform this action."],["Once deleted, the identity cannot be restored; a new one with the same configuration must be created if needed."]]],["This document outlines how to delete a client-side encryption identity in Gmail. A `DELETE` HTTP request is sent to a specific URL, using `userId` (or \"me\") and `cseEmailAddress` as path parameters. The request body must be empty. A successful deletion results in an empty response body. Deleting an identity is permanent, requiring the creation of a new one. The action needs one of two specified OAuth scopes for authorization.\n"]]
