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
عنوان البريد الإلكتروني الرئيسي المرتبط بإعداد الهوية المشفّرة من جهة العميل التي تمت إزالتها.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]
