REST Resource: users.messages

Ressource: Nachricht

Eine E-Mail-Nachricht

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

string

Die unveränderliche ID der Nachricht.
threadId

string

Die ID des Threads, zu dem die Nachricht gehört. Wenn Sie einer Unterhaltung eine Nachricht oder einen Entwurf hinzufügen möchten, müssen die folgenden Kriterien erfüllt sein:

  1. Die angefragte threadId muss in der Message oder Draft.Message angegeben werden, die du mit deiner Anfrage angibst.
  2. Die Header References und In-Reply-To müssen dem Standard RFC 2822 entsprechen.
  3. Die Subject-Header müssen übereinstimmen.
labelIds[]

string

Liste der IDs von Labels, die auf diese Nachricht angewendet wurden.
snippet

string

Ein kurzer Teil des Nachrichtentexts.
historyId

string

Die ID des letzten Verlaufs, der diese Nachricht geändert hat.
internalDate

string (int64 format)

Der Zeitstempel für die interne Nachrichtenerstellung (Epoche ms), der die Reihenfolge im Posteingang bestimmt. Bei normalen SMTP-E-Mails entspricht dieser Wert dem Zeitpunkt, zu dem die Nachricht ursprünglich von Google akzeptiert wurde. Der Wert ist zuverlässiger als der Date-Header. Für per API migrierte E-Mails kann sie jedoch vom Client so konfiguriert werden, dass sie auf dem Date-Header basiert.
payload

object (MessagePart)

Die geparste E-Mail-Struktur in den Nachrichtenteilen.
sizeEstimate

integer

Geschätzte Größe der Nachricht in Byte.
raw

string (bytes format)

Die gesamte E-Mail-Nachricht in einem RFC 2822-formatierten und base64url-codierten String. Wird in den Antworten messages.get und drafts.get zurückgegeben, wenn der Parameter format=RAW angegeben wird.

Ein base64-codierter String.

MessagePart

Ein einzelner MIME-Nachrichtenteil.

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

string

Die unveränderliche ID des Nachrichtenteils.
mimeType

string

Der MIME-Typ des Nachrichtenteils.
filename

string

Dateiname des Anhangs. Nur vorhanden, wenn dieser Nachrichtenteil einen Anhang darstellt.
headers[]

object (Header)

Liste der Header in diesem Nachrichtenteil. Für den obersten Teil der Nachricht, der die gesamte Nachrichtennutzlast darstellt, enthält er die standardmäßigen RFC 2822-E-Mail-Header wie To, From und Subject.
body

object (MessagePartBody)

Der Textteil der Nachricht für diesen Teil, der für Container-MIME-Nachrichtenteile leer sein kann.
parts[]

object (MessagePart)

Die untergeordneten MIME-Nachrichtenteile dieses Teils. Dies gilt nur für Container-MIME-Nachrichtenteile, z. B. multipart/*. Bei MIME-Nachrichtenteiltypen ohne Container, z. B. text/plain, ist dieses Feld leer. Weitere Informationen finden Sie unter RFC 1521.
JSON-Darstellung 
{
  "name": string,
  "value": string
}
Felder
name

string

Der Name des Headers vor dem Trennzeichen :. Beispiel: To.
value

string

Der Wert des Headers nach dem :-Trennzeichen. Beispiel: someuser@example.com.

Methoden

batchDelete

 Löscht viele Nachrichten anhand der Nachrichten-ID.

batchModify

 Ändert die Labels der angegebenen Nachrichten.

delete

 Die angegebene Nachricht wird sofort und endgültig gelöscht.

get

 Ruft die angegebene Nachricht ab.

import

 Importiert eine Nachricht nur in das Postfach dieses Nutzers, wobei die E-Mail-Zustellung standardmäßig überprüft und klassifiziert wird, ähnlich wie beim Empfang über SMTP.

insert

 Fügt eine Nachricht direkt in das Postfach dieses Nutzers ein, ähnlich wie IMAP APPEND, wodurch die meisten Scans und Klassifizierungen umgangen werden.

list

 Listet die Nachrichten im Postfach des Nutzers auf.

modify

 Ändert die Labels der angegebenen Nachricht.

send

 Sendet die angegebene Nachricht an die Empfänger in den Headern To, Cc und Bcc.

trash

 Die angegebene Nachricht wird in den Papierkorb verschoben.

untrash

 Die angegebene Nachricht wird aus dem Papierkorb entfernt.