REST Resource: users.messages

Ressource: Nachricht

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. Damit Sie einem Thread eine Nachricht oder einen Entwurf hinzufügen können, müssen die folgenden Kriterien erfüllt sein:

  1. Die angeforderte threadId muss in der Message oder Draft.Message angegeben sein, die Sie in Ihrer Anfrage angeben.
  2. Die Header References und In-Reply-To müssen dem Standard RFC 2822 entsprechen.
  3. Die Subject-Überschriften müssen übereinstimmen.
labelIds[]

string

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

string

Ein kurzer Teil des Nachrichtentexts.
historyId

string

Die ID des letzten Verlaufsdatensatzes, durch den diese Nachricht geändert wurde.
internalDate

string (int64 format)

Der interne Zeitstempel für die Nachrichtenerstellung (Epoche in ms), der die Reihenfolge im Posteingang bestimmt. Bei normalen per SMTP empfangenen E-Mails entspricht dies der Uhrzeit, zu der die Nachricht ursprünglich von Google akzeptiert wurde. Das ist zuverlässiger als der Date-Header. Bei per API migrierten E-Mails kann die Zustellung 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 messages.get- und drafts.get-Antworten zurückgegeben, wenn der Parameter format=RAW angegeben ist.

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

Der Dateiname des Anhangs. Ist nur vorhanden, wenn dieser Nachrichtenteil einen Anhang darstellt.
headers[]

object (Header)

Liste der Header in diesem Nachrichtenteil. Der Nachrichtenteil der obersten Ebene, der die gesamte Nachrichtennutzlast darstellt, enthält die standardmäßigen RFC 2822-E-Mail-Header wie To, From und Subject.
body

object (MessagePartBody)

Der Textkörper des Nachrichtenteils für diesen Teil, der bei Container-MIME-Nachrichtenteilen leer sein kann.
parts[]

object (MessagePart)

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

string

Der Name der Kopfzeile vor dem Trennzeichen :. Beispiel: To.
value

string

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

Methoden

batchDelete

 Viele Nachrichten werden anhand der Nachrichten-ID gelöscht.

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

 Eine Nachricht wird nur in den Posteingang dieses Nutzers importiert. Dabei werden die Nachrichten gescannt und klassifiziert, ähnlich wie beim Empfang über SMTP.

insert

 Eine Nachricht wird ähnlich wie bei IMAP APPEND direkt in das Postfach dieses Nutzers eingefügt, wobei die meisten Scan- und Klassifizierungsschritte übersprungen werden.

list

 Listet die Nachrichten im Postfach des Nutzers auf.

modify

 Ändert die Labels der angegebenen Nachricht.

send

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

trash

 Die angegebene Nachricht wird in den Papierkorb verschoben.

untrash

 Entfernt die angegebene Nachricht aus dem Papierkorb.