REST Resource: users.messages

แหล่งข้อมูล: ข้อความ

ข้อความอีเมล

การแสดง JSON
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
ช่อง
id

string

รหัสที่เปลี่ยนแปลงไม่ได้ของข้อความ

threadId

string

รหัสชุดข้อความของข้อความ วิธีเพิ่มข้อความหรือข้อความร่างไปยังชุดข้อความต้องเป็นไปตามเกณฑ์ต่อไปนี้

  1. ต้องระบุ threadId ที่ขอใน Message หรือ Draft.Message ที่คุณให้ไว้ในคำขอ
  2. ส่วนหัว References และ In-Reply-To ต้องตั้งค่าตามมาตรฐาน RFC 2822
  3. ส่วนหัว Subject ต้องตรงกัน

labelIds[]

string

รายการรหัสของป้ายกำกับที่ใช้กับข้อความนี้

snippet

string

ข้อความส่วนสั้นๆ

historyId

string

รหัสของบันทึกประวัติล่าสุดที่แก้ไขข้อความนี้

internalDate

string (int64 format)

การประทับเวลาการสร้างข้อความภายใน (Epoch ms) ซึ่งเป็นตัวกำหนดลำดับในกล่องจดหมาย สำหรับอีเมลที่ได้รับ SMTP ปกติ ค่านี้จะแสดงเวลาที่ Google ยอมรับข้อความในตอนแรก ซึ่งเชื่อถือได้มากกว่าส่วนหัว Date แต่สำหรับอีเมลที่ย้ายข้อมูล API จะสามารถกำหนดค่าตามส่วนหัว Date ได้

payload

object (MessagePart)

โครงสร้างอีเมลที่แยกวิเคราะห์ในส่วนข้อความ

sizeEstimate

integer

ขนาดโดยประมาณในหน่วยไบต์ของข้อความ

raw

string (bytes format)

ข้อความอีเมลทั้งหมดในสตริงที่เข้ารหัสแบบ RFC 2822 และเข้ารหัส base64url แสดงผลในคำตอบ messages.get และ drafts.get เมื่อมีการระบุพารามิเตอร์ format=RAW

สตริงที่เข้ารหัสฐาน 64

MessagePart

ส่วนข้อความ MIME ส่วนเดียว

การแสดง JSON
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
ช่อง
partId

string

รหัสที่เปลี่ยนแปลงไม่ได้ของส่วนข้อความ

mimeType

string

ประเภท MIME ของส่วนข้อความ

filename

string

ชื่อไฟล์ของไฟล์แนบ แสดงก็ต่อเมื่อส่วนของข้อความนี้แสดงไฟล์แนบ

headers[]

object (Header)

รายการส่วนหัวในส่วนข้อความนี้ สำหรับส่วนของข้อความระดับบนสุด ซึ่งแสดงถึงเพย์โหลดข้อความทั้งหมด จะประกอบด้วยส่วนหัวอีเมล RFC 2822 มาตรฐาน เช่น To, From และ Subject

body

object (MessagePartBody)

เนื้อหาส่วนของข้อความในส่วนนี้ ซึ่งอาจว่างเปล่าสำหรับส่วนข้อความ MIME ของคอนเทนเนอร์

parts[]

object (MessagePart)

ส่วนข้อความ MIME ย่อยของส่วนนี้ การตั้งค่านี้จะมีผลกับส่วนต่างๆ ของข้อความ MIME ของคอนเทนเนอร์เท่านั้น เช่น multipart/* สำหรับประเภทส่วนข้อความ MIME ที่ไม่ใช่คอนเทนเนอร์ เช่น text/plain ฟิลด์นี้จะว่างเปล่า โปรดดูข้อมูลเพิ่มเติมที่ RFC 1521

การแสดง JSON
{
  "name": string,
  "value": string
}
ช่อง
name

string

ชื่อของส่วนหัวก่อนตัวคั่น : เช่น To

value

string

ค่าของส่วนหัวหลังตัวคั่น : เช่น someuser@example.com

เมธอด

batchDelete

ลบข้อความจำนวนมากตามรหัสข้อความ

batchModify

แก้ไขป้ายกำกับของข้อความที่ระบุ

delete

ลบข้อความที่ระบุทันทีและอย่างถาวร

get

รับข้อความที่ระบุ

import

นำเข้าข้อความไปยังกล่องจดหมายของผู้ใช้รายนี้เท่านั้น โดยมีการสแกนและการจัดประเภทอีเมลแบบมาตรฐานคล้ายกับการรับผ่าน SMTP

insert

แทรกข้อความลงในกล่องจดหมายของผู้ใช้ที่คล้ายกับ IMAP APPEND โดยตรงเท่านั้น ทำให้ข้ามการสแกนและการแยกประเภทส่วนใหญ่ได้

list

แสดงข้อความในกล่องจดหมายของผู้ใช้

modify

แก้ไขป้ายกำกับของข้อความที่ระบุ

send

ส่งข้อความที่ระบุถึงผู้รับในส่วนหัว To, Cc และ Bcc

trash

ย้ายข้อความที่ระบุไปยังถังขยะ

untrash

นำข้อความที่ระบุออกจากถังขยะ