Method: users.history.list

แสดงประวัติการเปลี่ยนแปลงทั้งหมดในกล่องจดหมายที่ระบุ ผลลัพธ์ประวัติจะแสดงตามลำดับเวลา (historyId เพิ่มขึ้น)

คำขอ HTTP

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

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

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

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

string

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

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

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

integer (uint32 format)

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

string

โทเค็นหน้าเว็บเพื่อดึงข้อมูลหน้าผลลัพธ์ที่เฉพาะเจาะจงในรายการ
startHistoryId

string

ต้องระบุ แสดงผลระเบียนประวัติหลังจาก startHistoryId ที่ระบุ startHistoryId ที่ระบุควรมาจาก historyId ของข้อความ เธรด หรือการตอบกลับ list ก่อนหน้า รหัสประวัติจะเพิ่มขึ้นตามลำดับเวลา แต่จะไม่ต่อเนื่องโดยมีช่องว่างแบบสุ่มระหว่างรหัสที่ถูกต้อง การระบุ startHistoryId ที่ไม่ถูกต้องหรือล้าสมัยมักจะแสดงHTTP 404รหัสข้อผิดพลาด โดยปกติแล้ว historyId จะมีอายุอย่างน้อย 1 สัปดาห์ แต่ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก อาจมีอายุเพียงไม่กี่ชั่วโมง หากได้รับการตอบกลับเป็นข้อผิดพลาด HTTP 404 แอปพลิเคชันของคุณควรทำการซิงค์แบบเต็ม หากไม่ได้รับ nextPageToken ในการตอบกลับ แสดงว่าไม่มีข้อมูลอัปเดตที่จะดึงข้อมูล และคุณสามารถจัดเก็บ historyId ที่ส่งคืนสำหรับการขอในอนาคตได้
labelId

string

แสดงเฉพาะข้อความที่มีป้ายกำกับที่ตรงกับรหัส
historyTypes[]

enum (HistoryType)

ประเภทประวัติที่ฟังก์ชันจะแสดงผล

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

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

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

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

การแสดง JSON 
{
  "history": [
    {
      object (History)
    }
  ],
  "nextPageToken": string,
  "historyId": string
}
ช่อง
history[]

object (History)

รายการบันทึกประวัติ โดยปกติแล้ว messages ใดๆ ที่อยู่ในคำตอบจะมีเฉพาะช่อง id และ threadId ที่มีข้อมูล
nextPageToken

string

โทเค็นหน้าเว็บเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไปในรายการ
historyId

string

รหัสของบันทึกประวัติปัจจุบันของกล่องจดหมาย

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

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

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

HistoryType

Enum
messageAdded
messageDeleted
labelAdded
labelRemoved

ประวัติ

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

การแสดง JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}
ช่อง
id

string

รหัสลำดับของกล่องจดหมาย
messages[]

object (Message)

รายการข้อความที่มีการเปลี่ยนแปลงในบันทึกประวัตินี้ ฟิลด์สำหรับการเปลี่ยนแปลงบางประเภท เช่น messagesAdded อาจทำซ้ำข้อความในฟิลด์นี้ เราขอแนะนำให้ใช้ฟิลด์ประเภทการเปลี่ยนแปลงที่เฉพาะเจาะจงแทน
messagesAdded[]

object (MessageAdded)

ข้อความที่เพิ่มลงในกล่องจดหมายในบันทึกประวัตินี้
messagesDeleted[]

object (MessageDeleted)

ข้อความที่ลบ (ไม่ใช่ที่ย้ายไปถังขยะ) จากกล่องจดหมายในบันทึกประวัตินี้
labelsAdded[]

object (LabelAdded)

ป้ายกำกับที่เพิ่มลงในข้อความในบันทึกประวัตินี้
labelsRemoved[]

object (LabelRemoved)

ป้ายกำกับที่นำออกจากข้อความในบันทึกประวัตินี้

MessageAdded

การแสดง JSON 
{
  "message": {
    object (Message)
  }
}
ช่อง
message

object (Message)

MessageDeleted

การแสดง JSON 
{
  "message": {
    object (Message)
  }
}
ช่อง
message

object (Message)

LabelAdded

การแสดง JSON 
{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}
ช่อง
message

object (Message)
labelIds[]

string

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

LabelRemoved

การแสดง JSON 
{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}
ช่อง
message

object (Message)
labelIds[]

string

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