Nachrichtendetails abrufen

Auf dieser Seite wird erläutert, wie Sie die Details einer einzelnen Nachricht in Quarantäne mit der Methode get der Ressource customers.quarantinedMessages in der Mail Admin Quarantine API abrufen. Sie können damit die Header, den Betreff, den Text und die Anhänge einer Nachricht prüfen, bevor Sie entscheiden, ob Sie sie freigeben oder ablehnen.

Vorbereitung

  • Sie haben die Schritte unter API einrichten ausgeführt.
  • Ein Zugriffstoken, das einen Administrator mit einer Administratorberechtigung für die Quarantäne imitiert und den Bereich https://www.googleapis.com/auth/gmail.admin.quarantine oder https://www.googleapis.com/auth/gmail.admin.quarantine.readonly enthält. Weitere Informationen finden Sie unter Mit domainweiter Delegierung autorisieren.
  • Der Ressourcenname einer unter Quarantäne gestellten Nachricht, den Sie über Nachrichten in Quarantäne auflisten und suchen abrufen können.

Nachricht in Quarantäne abrufen

Wenn Sie eine Nachricht in Quarantäne abrufen möchten, senden Sie eine GET-Anfrage an die Methode get für den Ressourcennamen der Nachricht und wählen Sie mit dem Suchparameter view aus, wie viele Inhalte zurückgegeben werden sollen:

GET https://mailadminquarantine.googleapis.com/v1/customers/CUSTOMER_ID/quarantinedMessages/MESSAGE_OWNER:MESSAGE_ID?view=MESSAGE_VIEW_DETAILS
Authorization: Bearer ACCESS_TOKEN

Ersetzen Sie Folgendes:

  • CUSTOMER_ID: Ihre Kundennummer.
  • MESSAGE_OWNER: die E-Mail-Adresse des Postfachinhabers, wie im Feld messageOwner zurückgegeben.
  • MESSAGE_ID: die Gmail-Nachrichten-ID, wie im Feld messageId zurückgegeben.

Rufen Sie die Methode list oder search der Ressource customers.quarantinedMessages auf, um diese Werte zu finden. Sie können das Feld name aus einer list- oder search-Antwort direkt als Anfragepfad übergeben, z. B. https://mailadminquarantine.googleapis.com/v1/customers/01abc23de/quarantinedMessages/user@example.com:18d3ef45a8b2c1d0.

Nachrichtenansichten

Der Suchparameter view bestimmt, welche Felder in der Antwort enthalten sind:

Ansehen Zurückgegebene Felder
MESSAGE_VIEW_BASIC (Standard) Nur Quarantäne-Metadaten: name, messageId, messageOwner, quarantines, receiveTime, direction, state, retentionExpireTime und triggeredRules.
MESSAGE_VIEW_DETAILS name, messageId, messageOwner und das geparste content-Objekt mit subject, body, headers, attachments, labels und classificationLabelValues.
MESSAGE_VIEW_RAW name, messageId, messageOwner und rawMessage: die gesamte Nachricht im RFC 2822-Format als base64url-codierter String.

Wenn Sie view weglassen, gibt die API die Basisansicht zurück. Ein nicht erkannter Ansichtswert gibt einen 400 INVALID_ARGUMENT-Fehler zurück.

Beispielantwort

In der folgenden Antwort wird view=MESSAGE_VIEW_DETAILS verwendet:

{
  "name": "customers/01abc23de/quarantinedMessages/user@example.com:18d3ef45a8b2c1d0",
  "messageId": "18d3ef45a8b2c1d0",
  "messageOwner": "user@example.com",
  "content": {
    "subject": "Urgent: Verify your account details",
    "body": "Please click the link below to verify your login credentials...",
    "headers": [
      {"name": "From", "value": "security-alert@external.example.net"},
      {"name": "To", "value": "user@example.com"},
      {"name": "Date", "value": "Tue, 22 Sep 2026 10:15:00 +0000"},
      {"name": "Subject", "value": "Urgent: Verify your account details"}
    ],
    "attachments": [
      {
        "filename": "invoice_update.pdf",
        "mimeType": "application/pdf",
        "sizeBytes": "142857",
        "attachmentId": "att_987654321"
      }
    ],
    "labels": ["^admin_quarantine"]
  }
}

In der folgenden Tabelle sind die Inhaltsfelder einer Antwort aufgeführt:

Feld Beschreibung
content.subject Der Betreff der Nachricht.
content.body Der Nur-Text-Inhalt oder das Snippet der Nachricht.
content.headers[] Die Nachrichtenheader mit MIME-decodierten Werten.
content.attachments[] Der Dateiname, der MIME-Typ, die Größe in Byte und die ID jedes Anhangs.
content.labels[] Gmail-Standardlabels, die der Nachricht zugewiesen sind
content.classificationLabelValues[] Klassifizierungslabels, die auf die Nachricht angewendet wurden, falls vorhanden.

Rohnachricht decodieren

Bei view=MESSAGE_VIEW_RAW enthält das Feld rawMessage die vollständige Nachricht im RFC 2822-Format, codiert als base64url-String. Decodieren Sie sie, um die Nachricht mit Standard-E-Mail-Tools zu analysieren, z. B.:

import base64
import email

raw_message = response.json()['rawMessage']
mime_message = email.message_from_bytes(base64.urlsafe_b64decode(raw_message))
print(mime_message['Subject'])

Nächste Schritte