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
رقم تعريف سلسلة المحادثات المطلوب حذفها.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة هو عنصر JSON فارغ.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-14 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],["This document outlines how to permanently delete a Gmail thread and its associated messages via an HTTP DELETE request. The request requires specifying the `userId` (user's email, or \"me\") and the `id` of the thread. The URL follows gRPC Transcoding syntax. The request body must be empty, and a successful deletion returns an empty response. This action is irreversible. Authorization needs the `https://mail.google.com/` OAuth scope. Prefer trashing a thread over deleting it.\n"]]
