Method: users.messages.list

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

คำขอ HTTP

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

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

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

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

string

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

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

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

integer (uint32 format)

จำนวนข้อความสูงสุดที่จะแสดง ช่องนี้จะมีค่าเริ่มต้นเป็น 100 ค่าสูงสุดที่อนุญาตสำหรับช่องนี้คือ 500
pageToken

string

โทเค็นหน้าเว็บเพื่อดึงข้อมูลหน้าผลการค้นหาที่ต้องการในรายการ
q

string

แสดงเฉพาะข้อความที่ตรงกับข้อความค้นหาที่ระบุ รองรับรูปแบบการค้นหาเดียวกับช่องค้นหาของ Gmail เช่น "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" ใช้พารามิเตอร์ไม่ได้เมื่อเข้าถึง API โดยใช้ขอบเขต gmail.metadata
labelIds[]

string

แสดงเฉพาะข้อความที่มีป้ายกำกับซึ่งตรงกับรหัสป้ายกำกับที่ระบุทั้งหมด ข้อความในชุดข้อความอาจมีป้ายกำกับที่ข้อความอื่นๆ ในชุดข้อความเดียวกันไม่มี ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการป้ายกำกับในข้อความและชุดข้อความ
includeSpamTrash

boolean

รวมข้อความจาก SPAM และ TRASH ไว้ในผลการค้นหา

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
ช่อง
messages[]

object (Message)

รายการข้อความ โปรดทราบว่าแหล่งข้อมูลข้อความแต่ละรายการมีเพียง id และ threadId เท่านั้น คุณเรียกข้อมูลรายละเอียดข้อความเพิ่มเติมได้โดยใช้เมธอด messages.get
nextPageToken

string

โทเค็นสำหรับดึงข้อมูลหน้าถัดไปของผลการค้นหาในรายการ
resultSizeEstimate

integer (uint32 format)

จํานวนผลลัพธ์ทั้งหมดโดยประมาณ

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

ต้องใช้ขอบเขต 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

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