REST Resource: users.messages

Resource: Pesan

Pesan email.

Representasi JSON
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Kolom
id

string

ID yang tidak dapat diubah dari pesan.

threadId

string

ID thread yang berisi pesan tersebut. Untuk menambahkan pesan atau draf ke rangkaian pesan, kriteria berikut harus dipenuhi:

  1. threadId yang diminta harus ditentukan pada Message atau Draft.Message yang Anda sediakan dengan permintaan Anda.
  2. Header References dan In-Reply-To harus ditetapkan sesuai dengan standar RFC 2822.
  3. Header Subject harus cocok.

labelIds[]

string

Daftar ID label yang diterapkan pada pesan ini.

snippet

string

Bagian singkat dari teks pesan.

historyId

string

ID catatan histori terakhir yang mengubah pesan ini.

internalDate

string (int64 format)

Stempel waktu pembuatan pesan internal (epoch ms), yang menentukan urutan di kotak masuk. Untuk email normal yang diterima SMTP, hal ini menunjukkan waktu saat pesan pertama kali diterima oleh Google, yang lebih andal dibandingkan header Date. Namun, untuk email yang dimigrasikan API, konfigurasi tersebut dapat dikonfigurasi oleh klien agar didasarkan pada header Date.

payload

object (MessagePart)

Struktur email yang diuraikan di bagian pesan.

sizeEstimate

integer

Perkiraan ukuran dalam byte pesan.

raw

string (bytes format)

Seluruh pesan email dalam string berenkode RFC 2822 dan berenkode base64url. Ditampilkan di respons messages.get dan drafts.get saat parameter format=RAW disediakan.

String berenkode base64.

Bagian Pesan

Satu bagian pesan MIME.

Representasi JSON
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Kolom
partId

string

ID yang tidak dapat diubah dari bagian pesan.

mimeType

string

Jenis MIME dari bagian pesan.

filename

string

Nama file lampiran. Hanya muncul jika bagian pesan ini mewakili lampiran.

headers[]

object (Header)

Daftar header di bagian pesan ini. Untuk bagian pesan tingkat atas, yang mewakili seluruh payload pesan, pesan akan berisi header email RFC 2822 standar seperti To, From, dan Subject.

body

object (MessagePartBody)

Isi bagian pesan untuk bagian ini, yang mungkin kosong untuk bagian pesan MIME penampung.

parts[]

object (MessagePart)

Bagian pesan MIME turunan dari bagian ini. Ini hanya berlaku untuk bagian pesan MIME penampung, misalnya multipart/*. Untuk jenis bagian pesan MIME non-container, seperti text/plain, kolom ini kosong. Untuk informasi selengkapnya, lihat RFC 1521.

Representasi JSON
{
  "name": string,
  "value": string
}
Kolom
name

string

Nama header sebelum pemisah :. Misalnya To.

value

string

Nilai header setelah pemisah :. Misalnya someuser@example.com.

Metode

batchDelete

Menghapus banyak pesan berdasarkan ID pesan.

batchModify

Memodifikasi label pada pesan yang ditentukan.

delete

Segera dan secara permanen menghapus pesan yang ditentukan.

get

Mendapatkan pesan yang ditentukan.

import

Mengimpor pesan hanya ke kotak surat pengguna ini, dengan pemindaian dan klasifikasi pengiriman email standar yang serupa dengan yang diterima melalui SMTP.

insert

Langsung menyisipkan pesan ke dalam kotak surat pengguna ini yang mirip dengan IMAP APPEND, tanpa mengabaikan sebagian besar pemindaian dan klasifikasi.

list

Mencantumkan pesan di kotak surat pengguna.

modify

Memodifikasi label pada pesan yang ditentukan.

send

Mengirim pesan yang ditentukan kepada penerima di header To, Cc, dan Bcc.

trash

Memindahkan pesan yang ditentukan ke sampah.

untrash

Menghapus pesan tertentu dari sampah.