Method: users.messages.modify

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

Yêu cầu HTTP

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

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

Tham số đường dẫn

Thông số
userId

string

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

string

Mã của tin nhắn cần sửa đổi.

Nội dung yêu cầu

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

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

string

Danh sách mã nhận dạng của các nhãn cần thêm vào thư này. Bạn có thể thêm tối đa 100 nhãn cho mỗi lần cập nhật.
removeLabelIds[]

string

Danh sách mã nhận dạng của các nhãn cần xoá khỏi thư này. Bạn có thể xoá tối đa 100 nhãn trong mỗi lần cập nhật.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Message.

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 OAuth 2.0 Overview.