REST Resource: users.messages

Zasób: wiadomość

e-maila,

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, muszą być spełnione te kryteria:

  1. Wymagany threadId musi być określony w Message lub Draft.Message, które przesyłasz wraz z prośbą.
  2. Nagłówki References i In-Reply-To muszą być skonfigurowane 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ótki fragment tekstu wiadomości.
historyId

string

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

string (int64 format)

Wewnętrzny sygnatura czasowa utworzenia wiadomości (epoka ms), która określa kolejność w skrzynce odbiorczej. W przypadku zwykłego e-maila otrzymanego przez SMTP jest to czas, w którym wiadomość została pierwotnie zaakceptowana przez Google. Jest to bardziej wiarygodna wartość niż nagłówek Date. W przypadku poczty przeniesionej za pomocą interfejsu API może ona być jednak skonfigurowana przez klienta na podstawie nagłówka Date.
payload

object (MessagePart)

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

integer

Szacunkowy rozmiar wiadomości w bajtach.
raw

string (bytes format)

Cała wiadomość e-mail w formacie RFC 2822 i z kodowaniem base64url. Zwracane w odpowiedziach messages.get i drafts.get, gdy podany jest parametr format=RAW.

Ciąg znaków 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

Niezmienny identyfikator części wiadomości.
mimeType

string

Typ MIME części wiadomości.
filename

string

Nazwa pliku załącznika. Jest widoczny tylko wtedy, gdy ta część wiadomości reprezentuje załącznik.
headers[]

object (Header)

Lista nagłówków w tej części wiadomości. Część wiadomości na najwyższym poziomie, która reprezentuje całą treść wiadomości, będzie zawierać standardowe nagłówki e-maila RFC 2822, takie jak To, From i Subject.
body

object (MessagePartBody)

Treść części wiadomości dla 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 tego elementu. Dotyczy to tylko części wiadomości 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

 Zmienia etykiety wybranych wiadomości.

delete

 natychmiast i trwało usuwa określoną wiadomość.

get

 Pobiera określoną wiadomość.

import

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

insert

 Wstawia wiadomość bezpośrednio do skrzynki pocztowej tego użytkownika, podobnie jak w przypadku IMAP APPEND, pomijając większość 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 odbiorców w nagłówkach To, Cc i Bcc.

trash

 Przenosi wybraną wiadomość do kosza.

untrash

 Usuwa wybraną wiadomość z kosza.