Method: users.messages.modify

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

HTTP-запрос

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

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

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

Параметры
userId

string

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

id

string

Идентификатор сообщения, которое необходимо изменить.

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

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

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

string

Список идентификаторов меток, которые можно добавить к этому сообщению. При каждом обновлении можно добавить до 100 меток.

removeLabelIds[]

string

Список идентификаторов меток, которые нужно удалить из этого сообщения. При каждом обновлении можно удалить до 100 меток.

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

В случае успеха тело ответа содержит экземпляр объекта Message .

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

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

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

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