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

Дополнительную информацию см. в руководстве по авторизации .