Method: users.messages.batchModify

Изменяет метки в указанных сообщениях.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
userId

string

Адрес электронной почты пользователя. Специальное значение me может использоваться для обозначения авторизованного пользователя.

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Поля
ids[]

string

Идентификаторы сообщений, которые необходимо изменить. На один запрос допускается не более 1000 идентификаторов.

addLabelIds[]

string

Список идентификаторов меток для добавления к сообщениям.

removeLabelIds[]

string

Список идентификаторов меток, которые следует удалить из сообщений.

Ответный текст

В случае успеха тело ответа будет пустым.

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .