Method: users.messages.batchModify

Sửa đổi nhãn trên các thư được chỉ định.

Yêu cầu HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
userId

string

Địa chỉ email của người dùng. Bạn có thể sử dụng giá trị đặc biệt me để cho biết người dùng đã xác thực.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Các trường
ids[]

string

Mã nhận dạng của các tin nhắn cần sửa đổi. Mỗi yêu cầu có giới hạn là 1.000 mã nhận dạng.
addLabelIds[]

string

Danh sách mã nhận dạng nhãn để thêm vào thư.
removeLabelIds[]

string

Danh sách mã nhận dạng nhãn cần xoá khỏi thư.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.