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,
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
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 auf dem Message oder Draft.Message angegeben sein, das Sie mit Ihrer Anfrage einreichen.
  2. Die Header References und In-Reply-To müssen gemäß 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 Verlaufsdatensatzes, mit dem diese Nachricht geändert wurde.
internalDate

string (int64 format)

Der interne Zeitstempel für die Erstellung der Nachricht (Epochen-Millisekunden), der die Reihenfolge im Posteingang bestimmt. Bei normalen über SMTP empfangenen E‑Mails wird hier die Zeit angegeben, 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 sie jedoch clientseitig 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 gemäß 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.
classificationLabelValues[]

object (ClassificationLabelValue)

Werte für Klassifizierungslabel in der Nachricht. Verfügbare Schemas für Klassifizierungslabels können mit der Google Drive Labels API abgefragt werden. Jede ID für ein Klassifikationslabel muss eindeutig sein. Wenn doppelte IDs angegeben werden, wird nur eine beibehalten. Die Auswahl erfolgt willkürlich. Wird nur für Google Workspace-Konten verwendet. Pro Anfrage sind maximal 20 Werte für „Classification Label“ zulässig. Wenn die Werte für „Classification Label“ die maximal zulässige Anzahl überschreiten, schlägt die Anfrage fehl.

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. Nur vorhanden, wenn dieser Nachrichtenteil eine Anlage darstellt.
headers[]

object (Header)

Liste der Header für diesen Nachrichtenteil. Für den obersten Nachrichtenteil, 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 Nachrichtenteil 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 MIME-Nachrichtenteile vom Typ „Container“, z. B. multipart/*. Bei MIME-Nachrichtenteiltypen, die keine Container sind, 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.

ClassificationLabelValue

Auf die E‑Mail-Nachricht angewendete Klassifizierungslabel. Klassifizierungslabels unterscheiden sich von Gmail-Posteingangslabels. Wird nur für Google Workspace-Konten verwendet. Weitere Informationen zu Klassifizierungslabels

JSON-Darstellung 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
Felder
labelId

string

Erforderlich. Die kanonische oder rohe alphanumerische ID des Klassifizierungslabels. Entspricht dem Feld „ID“ der Google Drive-Label-Ressource.
fields[]

object (ClassificationLabelFieldValue)

Feldwerte für die angegebene Klassifizierungslabel-ID.

ClassificationLabelFieldValue

Feldwerte für ein Klassifizierungslabel.

JSON-Darstellung 
{
  "fieldId": string,
  "selection": string
}
Felder
fieldId

string

Erforderlich. Die Feld-ID für den Wert des Klassifizierungslabels. Entspricht dem Feld „ID“ des Google Drive-Objekts Label.Field.
selection

string

ID der Auswahloption für die Auswahl. Sollte nur festgelegt werden, wenn der Feldtyp SELECTION im Google Drive-Objekt Label.Field ist. Entspricht dem Feld „id“ der Google Drive-Ressource Label.Field.SelectionOptions.

Methoden

batchDelete

 Löscht viele Nachrichten anhand der Nachrichten-ID.

batchModify

 Ändert die Labels und die Werte für das Klassifizierungslabel für die angegebenen Nachrichten.

delete

 Löscht die angegebene Nachricht sofort und endgültig.

get

 Ruft die angegebene Nachricht ab.

import

 Importiert eine Nachricht nur in das Postfach dieses Nutzers. Die Nachricht wird wie bei einem Empfang über SMTP gescannt und klassifiziert.

insert

 Fügt eine Nachricht direkt in das Postfach dieses Nutzers ein, ähnlich wie IMAP APPEND. Dabei werden die meisten Scan- und Klassifizierungsprozesse umgangen.

list

 Listet die Nachrichten im Postfach des Nutzers auf.

modify

 Ändert die Labels und die Werte für das Klassifizierungslabel für die angegebene 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.