Method: users.threads.trash
نقل سلسلة المحادثات المحددة إلى المهملات ويتم أيضًا نقل أي رسائل تنتمي إلى سلسلة المحادثات إلى المهملات.
طلب HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/trash
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
userId |
string
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.
|
id |
string
رقم تعريف سلسلة المحادثات إلى المهملات.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Thread.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Moves a specified thread and its associated messages to the trash."],["Requires the user's email address (`userId`) and the thread ID (`id`) as path parameters."],["Uses an empty request body and returns a `Thread` object upon successful completion."],["Needs authorization with either `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify` scope."]]],["This document outlines the process for moving a Gmail thread to the trash via an API. The `POST` request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/trash` requires two path parameters: `userId` (user's email, or \"me\") and `id` (thread ID). The request body must be empty. Upon success, the response contains thread details. Authorization requires either `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify` OAuth scope.\n"]]
