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

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