Method: users.threads.modify

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
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

لمزيد من المعلومات، اطّلِع على دليل التفويض.