REST Resource: users.messages

Zasób: wiadomość

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

Niezmienny identyfikator wiadomości.
threadId

string

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

  1. Żądaną threadId należy określić w 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 zapisu 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, kiedy wiadomość została pierwotnie zaakceptowana przez Google, co jest bardziej niezawodne niż nagłówek Date. W przypadku poczty przeniesionych przez interfejs API klient może ją jednak skonfigurować w oparciu o nagłówek Date.
payload

object (MessagePart)

Analiza struktury e-maili w ich częściach.
sizeEstimate

integer

Szacowany rozmiar wiadomości w bajtach.
raw

string (bytes format)

Cała wiadomość e-mail jest ciągiem sformatowanym w standardzie RFC 2822 i zakodowanym w base64url. Zwracana w odpowiedziach messages.get i drafts.get, gdy podano 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 stanowi załącznik.
headers[]

object (Header)

Lista nagłówków tej części wiadomości. Główna część wiadomości, reprezentująca cały ładunek, zawiera standardowe nagłówki RFC 2822, takie jak To, From i Subject.
body

object (MessagePartBody)

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

object (MessagePart)

Podrzędne części wiadomości MIME tej części. Dotyczy to tylko części wiadomości w standardzie MIME kontenera, 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 wiadomości.

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 przy użyciu standardowego skanowania dostarczania e-maili i klasyfikacji podobnych do odbierania przez SMTP.

insert

 Powoduje bezpośrednie wstawienie wiadomości tylko do skrzynki pocztowej tego użytkownika, podobnie jak w usłudze IMAP APPEND, z pominięciem większości skanowania i klasyfikacji.

list

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

modify

 Modyfikuje etykiety określonej wiadomości.

send

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

trash

 Przenosi określoną wiadomość do kosza.

untrash

 Usuwa z kosza określoną wiadomość.