Method: users.threads.modify

تعديل التصنيفات المطبّقة على سلسلة المحادثات ينطبق ذلك على جميع الرسائل في سلسلة المحادثات.

طلب HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
userId

string

عنوان البريد الإلكتروني للمستخدِم. يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمّت مصادقته.
id

string

رقم تعريف سلسلة المحادثات المطلوب تعديلها.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
الحقول
addLabelIds[]

string

قائمة بمعرّفات التصنيفات المطلوب إضافتها إلى سلسلة المحادثات هذه. يمكنك إضافة ما يصل إلى 100 تصنيف مع كل تحديث.
removeLabelIds[]

string

قائمة بمعرّفات التصنيفات المطلوب إزالتها من سلسلة المحادثات هذه. يمكنك إزالة ما يصل إلى 100 تصنيف مع كل تعديل.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Thread.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.