Method: users.threads.delete
يؤدي هذا الإجراء إلى حذف سلسلة المحادثات المحدّدة فورًا وبشكل دائم. ويتم أيضًا حذف أي رسائل تنتمي إلى سلسلة المحادثات. لا يمكن التراجع عن هذه العملية. أفضّل threads.trash
بدلاً من ذلك.
طلب HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.
|
id |
string
رقم تعريف سلسلة المحادثات المطلوب حذفه.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Permanently deletes a specified thread and all its associated messages, an irreversible action."],["Requires user ID and thread ID as path parameters in the DELETE request."],["Uses Gmail API and needs authorization with the `https://mail.google.com/` scope."],["Request body should be empty, and a successful deletion results in an empty response body."],["Consider using `threads.trash` for a reversible alternative to thread deletion."]]],[]]