REST Resource: users.messages

Resource: Message

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 pesan yang tidak dapat diubah.

threadId

string

ID rangkaian pesan tempat pesan berada. Untuk menambahkan pesan atau draf ke rangkaian pesan, kriteria berikut harus terpenuhi:

  1. threadId yang diminta harus ditentukan di Message atau Draft.Message yang Anda berikan dengan permintaan.
  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 ke pesan ini.

snippet

string

Bagian singkat dari teks pesan.

historyId

string

ID data histori terakhir yang mengubah pesan ini.

internalDate

string (int64 format)

Stempel waktu pembuatan pesan internal (epoch ms), yang menentukan pengurutan di kotak masuk. Untuk email yang diterima SMTP normal, kolom ini menunjukkan waktu pesan awalnya diterima oleh Google, yang lebih andal daripada header Date. Namun, untuk email yang dimigrasikan API, email tersebut dapat dikonfigurasi oleh klien agar didasarkan pada header Date.

payload

object (MessagePart)

Struktur email yang diuraikan di bagian pesan.

sizeEstimate

integer

Perkiraan ukuran pesan dalam byte.

raw

string (bytes format)

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

String berenkode base64.

MessagePart

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 bagian pesan yang tidak dapat diubah.

mimeType

string

Jenis MIME bagian pesan.

filename

string

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

headers[]

object (Header)

Daftar header di bagian pesan ini. Untuk bagian pesan tingkat teratas, yang mewakili seluruh payload pesan, bagian ini 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. Hal ini hanya berlaku untuk bagian pesan MIME penampung, misalnya multipart/*. Untuk jenis bagian pesan MIME non-penampung, seperti text/plain, kolom ini kosong. Untuk mengetahui 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

Mengubah label pada pesan yang ditentukan.

delete

Menghapus pesan yang ditentukan secara langsung dan permanen.

get

Mendapatkan pesan yang ditentukan.

import

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

insert

Menyisipkan pesan secara langsung hanya ke kotak surat pengguna ini, mirip dengan IMAP APPEND, yang mengabaikan sebagian besar pemindaian dan klasifikasi.

list

Mencantumkan pesan di kotak surat pengguna.

modify

Mengubah label pada pesan yang ditentukan.

send

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

trash

Memindahkan pesan yang ditentukan ke sampah.

untrash

Menghapus pesan yang ditentukan dari sampah.