Method: users.messages.get

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

คำขอ HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
userId

string

อีเมลของผู้ใช้ ค่าพิเศษ me ใช้ระบุผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ได้
id

string

รหัสของข้อความที่จะดึงข้อมูล โดยปกติแล้ว ระบบจะดึงข้อมูลรหัสนี้โดยใช้ messages.list นอกจากนี้ รหัสจะอยู่ในผลลัพธ์เมื่อมีการแทรก (messages.insert) หรือนำเข้า (messages.import) ข้อความด้วย

พารามิเตอร์การค้นหา

พารามิเตอร์
format

enum (Format)

รูปแบบที่จะแสดงข้อความ
metadataHeaders[]

string

เมื่อระบุและรูปแบบเป็น METADATA ให้รวมเฉพาะส่วนหัวที่ระบุ

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Message

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview