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. Damit Sie einer Konversation 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 in der Draft.Message angegeben sein, die du mit deiner Anfrage angibst.
  2. Die Header References und In-Reply-To müssen in Übereinstimmung mit dem Standard RFC 2822 festgelegt werden.
  3. Die Subject-Header 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 Verlaufseintrags, der diese Nachricht geändert hat.
internalDate

string (int64 format)

Der Zeitstempel der internen Nachrichtenerstellung (Epoche ms), der die Reihenfolge im Posteingang bestimmt. Bei normalen SMTP-empfangenen E-Mails ist dies der Zeitpunkt, zu dem die Nachricht ursprünglich von Google akzeptiert wurde. Sie ist zuverlässiger als der Date-Header. Für über die API migrierte E-Mails kann sie jedoch vom Client so konfiguriert werden, dass er auf dem Header Date 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 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

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 Nachrichtenteil für diesen Teil, der für Container-MIME-Nachrichtenteile möglicherweise leer ist.
parts[]

object (MessagePart)

Die untergeordneten MIME-Nachrichtenteile dieses Teils. Dies gilt nur für Container-MIME-Nachrichtenteile, z. B. multipart/*. Für Nicht-Container-MIME-Nachrichtenteiltypen 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 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 nach 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 den Posteingang dieses Nutzers. Dabei werden die E-Mails standardmäßig gescannt und klassifiziert. Die E-Mail-Zustellung funktioniert ähnlich wie der Empfang über SMTP.

insert

 Fügt Nachrichten direkt in das Postfach dieses Nutzers ein, ähnlich wie bei IMAP APPEND. Die meisten Scans und Klassifizierungen werden dadurch umgangen.

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

 Verschiebt die angegebene Nachricht in den Papierkorb.

untrash

 Entfernt die angegebene Nachricht aus dem Papierkorb.