REST Resource: users.messages

Zasób: wiadomość

E-mail.

Zapis JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Pola
id

string

Stały identyfikator wiadomości.
threadId

string

Identyfikator wątku, do którego należy wiadomość. Aby dodać wiadomość lub wersję roboczą do wątku, muszą być spełnione te kryteria:

  1. Żądany threadId musi być określony w dokumencie Message lub Draft.Message przesłanym w żądaniu.
  2. Nagłówki References i In-Reply-To muszą być ustawione zgodnie ze standardem RFC 2822.
  3. Nagłówki Subject muszą być takie same.
labelIds[]

string

Lista identyfikatorów etykiet zastosowanych do tej wiadomości.
snippet

string

Krótka część tekstu wiadomości.
historyId

string

Identyfikator ostatniego rekordu historii, który zmodyfikował tę wiadomość.
internalDate

string (int64 format)

Wewnętrzna sygnatura czasowa utworzenia wiadomości (epoka ms), która określa kolejność wiadomości w skrzynce odbiorczej. W przypadku zwykłych e-maili odbieranych przez SMTP jest to czas, o którym wiadomość została pierwotnie zaakceptowana przez Google. Ten parametr jest bardziej niezawodny niż nagłówek Date. Jednak w przypadku poczty przenoszonej przez interfejs API, klient może skonfigurować ją na podstawie nagłówka Date.
payload

object (MessagePart)

Przeanalizowana struktura e-maila w jego częściach.
sizeEstimate

integer

Szacowany rozmiar wiadomości (w bajtach).
raw

string (bytes format)

Cała wiadomość e-mail w ciągu znaków w formacie RFC 2822 i zakodowanym w base64url. Zwracany w odpowiedziach messages.get i drafts.get, gdy podany jest parametr format=RAW.

Ciąg zakodowany w formacie base64.

MessagePart

Pojedyncza część wiadomości MIME.

Zapis JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Pola
partId

string

Stały identyfikator części wiadomości.
mimeType

string

Typ MIME części wiadomości.
filename

string

Nazwa pliku załącznika. Widoczny tylko wtedy, gdy ta część wiadomości jest załącznikiem.
headers[]

object (Header)

Lista nagłówków w tej części wiadomości. Część wiadomości najwyższego poziomu, która reprezentuje cały ładunek wiadomości, zawiera standardowe nagłówki e-maili zgodne ze standardem RFC 2822, takie jak To, From i Subject.
body

object (MessagePartBody)

Treść części wiadomości tej części, która może być pusta w przypadku części kontenera MIME.
parts[]

object (MessagePart)

Podrzędne części tej części wiadomości MIME. Dotyczy to tylko części wiadomości MIME w kontenerze, np. multipart/*. W przypadku typów części wiadomości MIME, które nie są kontenerami, takich jak text/plain, to pole jest puste. Więcej informacji znajdziesz w dokumencie RFC 1521.
Zapis JSON 
{
  "name": string,
  "value": string
}
Pola
name

string

Nazwa nagłówka przed separatorem :. Na przykład: To.
value

string

Wartość nagłówka po separatorze :. Na przykład: someuser@example.com.

Metody

batchDelete

 Usuwa wiele wiadomości według identyfikatora.

batchModify

 Modyfikuje etykiety określonych wiadomości.

delete

 Natychmiast i trwale usuwa określoną wiadomość.

get

 Pobiera określony komunikat.

import

 Importuje wiadomość tylko do skrzynki pocztowej tego użytkownika, stosując standardowe skanowanie dostarczania poczty e-mail i klasyfikację podobne do odbierania przez SMTP.

insert

 Bezpośrednio wstawia wiadomość tylko do skrzynki pocztowej tego użytkownika (podobna do IMAP APPEND), pomijając większość skanowania i klasyfikacji.

list

 Zawiera listę wiadomości w skrzynce pocztowej użytkownika.

modify

 Modyfikuje etykiety określonej wiadomości.

send

 Wysyła wiadomość określoną w nagłówku To, Cc i Bcc do adresatów.

trash

 Przenosi określoną wiadomość do kosza.

untrash

 Usuwa określoną wiadomość z kosza.