Method: users.threads.get

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

คำขอ HTTP

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

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

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

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

string

อีเมลของผู้ใช้ สามารถใช้ค่าพิเศษ me เพื่อระบุผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

id

string

รหัสของชุดข้อความที่จะดึงข้อมูล

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

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

enum (Format)

รูปแบบที่จะส่งกลับข้อความ

metadataHeaders[]

string

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

เนื้อหาของคำขอ

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

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

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

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

ต้องมีขอบเขต 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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์

รูปแบบ

Enum
full แสดงผลข้อมูลข้อความอีเมลแบบเต็มพร้อมเนื้อหาเนื้อความที่แยกวิเคราะห์ในช่อง payload ระบบจะไม่ใช้ช่อง raw ใช้รูปแบบไม่ได้เมื่อเข้าถึง API โดยใช้ขอบเขต gmail.metadata
metadata แสดงผลเฉพาะรหัสข้อความอีเมล ป้ายกำกับ และส่วนหัวของอีเมล
minimal แสดงเฉพาะรหัสและป้ายกำกับของข้อความอีเมล ไม่แสดงส่วนหัว เนื้อหา หรือเพย์โหลดของอีเมล