Mendapatkan detail pesan

Halaman ini menjelaskan cara mengambil detail satu pesan yang dikarantina dengan metode get dari resource customers.quarantinedMessages di Mail Admin Quarantine API. Gunakan untuk memeriksa header, subjek, isi, dan lampiran pesan sebelum Anda memutuskan apakah akan merilis atau menolaknya.

Prasyarat

Mendapatkan pesan yang dikarantina

Untuk mendapatkan pesan yang dikarantina, kirim permintaan GET ke metode get pada nama resource pesan dan pilih jumlah konten yang akan ditampilkan dengan parameter kueri view:

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

Ganti kode berikut:

  • CUSTOMER_ID: ID pelanggan Anda.
  • MESSAGE_OWNER: alamat email pemilik kotak surat, seperti yang ditampilkan di kolom messageOwner.
  • MESSAGE_ID: ID pesan Gmail, seperti yang ditampilkan di kolom messageId.

Untuk menemukan nilai ini, panggil metode list atau search dari resource customers.quarantinedMessages. Anda dapat meneruskan kolom name dari respons list atau search secara langsung sebagai jalur permintaan, misalnya https://mailadminquarantine.googleapis.com/v1/customers/01abc23de/quarantinedMessages/user@example.com:18d3ef45a8b2c1d0.

Tampilan pesan

Parameter kueri view menentukan kolom yang disertakan dalam respons:

Lihat Kolom yang ditampilkan
MESSAGE_VIEW_BASIC (default) Hanya metadata karantina: name, messageId, messageOwner, quarantines, receiveTime, direction, state, retentionExpireTime, dan triggeredRules.
MESSAGE_VIEW_DETAILS name, messageId, messageOwner, dan objek content yang diuraikan dengan subject, body, headers, attachments, labels, dan classificationLabelValues.
MESSAGE_VIEW_RAW name, messageId, messageOwner, dan rawMessage, seluruh pesan dalam format RFC 2822 sebagai string berenkode base64url.

Jika Anda menghilangkan view, API akan menampilkan tampilan dasar. Nilai tampilan yang tidak dikenali akan menampilkan error 400 INVALID_ARGUMENT.

Contoh respons

Respons berikut menggunakan view=MESSAGE_VIEW_DETAILS:

{
  "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"]
  }
}

Tabel berikut menampilkan kolom konten respons:

Kolom Deskripsi
content.subject Subjek pesan.
content.body Isi atau cuplikan teks biasa dari pesan.
content.headers[] Header pesan, dengan nilai yang didekode MIME.
content.attachments[] Nama file, jenis MIME, ukuran dalam byte, dan ID setiap lampiran.
content.labels[] Label Gmail standar yang diterapkan ke pesan.
content.classificationLabelValues[] Label klasifikasi yang diterapkan ke pesan, jika ada.

Mendekode pesan mentah

Dengan view=MESSAGE_VIEW_RAW, kolom rawMessage berisi pesan lengkap dalam format RFC 2822, yang dienkode sebagai string base64url. Dekode pesan untuk menganalisisnya dengan alat email standar, misalnya:

import base64
import email

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

Langkah berikutnya