Method: users.threads.modify

برچسب های اعمال شده روی نخ را اصلاح می کند. این برای همه پیام های موجود در تاپیک صدق می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.