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

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