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

threadId

string

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

  1. threadId yang diminta harus ditentukan dalam Message atau Draft.Message yang Anda berikan bersama permintaan Anda.
  2. Header References dan In-Reply-To harus disetel 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 catatan 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, ini menunjukkan waktu saat pesan awalnya diterima oleh Google, yang lebih andal daripada header Date. Namun, untuk email yang dimigrasikan API, email 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 berformat RFC 2822 dan berenkode base64url. Ditampilkan dalam respons messages.get dan drafts.get saat parameter format=RAW diberikan.

String berenkode base64.

MessagePart

Bagian pesan MIME tunggal.

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 ada 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, 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. Ini hanya berlaku untuk bagian pesan MIME penampung, misalnya multipart/*. Untuk jenis bagian pesan MIME non-penampung, 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

Menghapus pesan tertentu 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

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

list

Mencantumkan pesan di kotak surat pengguna.

modify

Mengubah label pada pesan tertentu.

send

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

trash

Memindahkan pesan tertentu ke sampah.

untrash

Menghapus pesan tertentu dari sampah.