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 Draft.Message angegeben werden, die du mit deiner Anfrage angibst.
  2. Die Header References und In-Reply-To müssen gemäß dem RFC 2822-Standard 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, über den diese Nachricht geändert wurde.

internalDate

string (int64 format)

Der Zeitstempel der Erstellung einer internen Nachricht (Epoche in ms), der die Reihenfolge im Posteingang bestimmt. Bei normalen E-Mails, die über SMTP empfangen werden, gibt dies den Zeitpunkt an, zu dem die Nachricht ursprünglich von Google akzeptiert wurde. Dieser Wert ist zuverlässiger als der Date-Header. Für 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 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 für diesen Nachrichtenteil. Der Nachrichtenteil der obersten Ebene, der die gesamte Nachrichtennutzlast darstellt, enthält die standardmäßigen E-Mail-Header nach RFC 2822, z. B. To, From und Subject.

body

object (MessagePartBody)

Der Nachrichtenteil für diesen Teil; bei Container-MIME-Nachrichtenteilen kann er leer sein.

parts[]

object (MessagePart)

Die untergeordneten MIME-Nachrichtenteile dieses Teils. Dies gilt nur für Container-MIME-Nachrichtenteile, z. B. multipart/*. Bei 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 das Postfach dieses Nutzers. Dabei werden E-Mails standardmäßig gescannt und klassifiziert, ähnlich wie beim Empfang über SMTP.

insert

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

list

Listet die Nachrichten im Postfach des Nutzers auf.

modify

Damit werden die Labels der angegebenen Nachricht geändert.

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.