REST Resource: users.messages

Ресурс: Сообщение

Сообщение электронной почты.

JSON-представление
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Поля
id

string

Неизменяемый идентификатор сообщения.

threadId

string

Идентификатор потока, которому принадлежит сообщение. Чтобы добавить сообщение или черновик в ветку, должны быть выполнены следующие критерии:

  1. Запрошенный threadId должен быть указан в Message или Draft.Message которое вы предоставляете вместе с вашим запросом.
  2. Заголовки References и In-Reply-To должны быть установлены в соответствии со стандартом RFC 2822 .
  3. Заголовки Subject должны совпадать.

labelIds[]

string

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

snippet

string

Краткая часть текста сообщения.

historyId

string

Идентификатор последней записи истории, которая изменила это сообщение.

internalDate

string ( int64 format)

Временная метка создания внутреннего сообщения (эпоха мс), определяющая порядок во входящих сообщениях. Для обычной электронной почты, полученной по SMTP, это время, когда сообщение было первоначально принято Google, что более надежно, чем заголовок Date . Однако для почты, перенесенной через API, клиент может настроить ее на основе заголовка Date .

payload

object ( MessagePart )

Разобранная структура письма в частях сообщения.

sizeEstimate

integer

Предполагаемый размер сообщения в байтах.

raw

string ( bytes format)

Полное сообщение электронной почты в строке в формате RFC 2822 и кодировке Base64url. Возвращается в ответах messages.get и drafts.get , если указан параметр format=RAW .

Строка в кодировке Base64.

Часть сообщения

Одна часть сообщения MIME.

JSON-представление
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Поля
partId

string

Неизменяемый идентификатор части сообщения.

mimeType

string

MIME-тип части сообщения.

filename

string

Имя файла вложения. Присутствует только в том случае, если эта часть сообщения представляет собой вложение.

headers[]

object ( Header )

Список заголовков этой части сообщения. Часть сообщения верхнего уровня, представляющая всю полезную нагрузку сообщения, будет содержать стандартные заголовки электронной почты RFC 2822, такие как To , From и Subject .

body

object ( MessagePartBody )

Тело части сообщения для этой части, которое может быть пустым для частей сообщения контейнера MIME.

parts[]

object ( MessagePart )

Дочерние части сообщения MIME этой части. Это применимо только к частям сообщения MIME контейнера, например multipart/* . Для типов частей сообщения MIME, не являющихся контейнерами, таких как text/plain , это поле пусто. Дополнительную информацию см. в RFC 1521 .

JSON-представление
{
  "name": string,
  "value": string
}
Поля
name

string

Имя заголовка перед разделителем : . Например, To .

value

string

Значение заголовка после разделителя : . Например, someuser@example.com .

Методы

batchDelete

 Удаляет множество сообщений по идентификатору сообщения.

batchModify

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

delete

 Немедленно и навсегда удаляет указанное сообщение.

get

 Получает указанное сообщение.

import

 Импортирует сообщение только в почтовый ящик этого пользователя со стандартным сканированием и классификацией доставки электронной почты, аналогичным получению через SMTP.

insert

 Непосредственно вставляет сообщение только в почтовый ящик этого пользователя, аналогично IMAP APPEND , минуя большую часть сканирования и классификации.

list

 Перечисляет сообщения в почтовом ящике пользователя.

modify

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

send

 Отправляет указанное сообщение получателям в заголовках To , Cc и Bcc .

trash

 Перемещает указанное сообщение в корзину.

untrash

 Удаляет указанное сообщение из корзины.