Method: revisions.list

แสดงรายการการแก้ไขของไฟล์ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อจัดการการแก้ไขไฟล์

สำคัญ: รายการการแก้ไขที่เมธอดนี้แสดงอาจไม่สมบูรณ์สำหรับไฟล์ที่มีประวัติการแก้ไขจำนวนมาก ซึ่งรวมถึง Google เอกสาร, ชีต และสไลด์ที่แก้ไขบ่อย ระบบอาจละเว้นการแก้ไขเวอร์ชันเก่าออกจากคำตอบ ซึ่งหมายความว่าการแก้ไขเวอร์ชันแรกที่แสดงอาจไม่ใช่การแก้ไขเวอร์ชันเก่าที่สุดที่มีอยู่ ประวัติการแก้ไขที่แสดงในอินเทอร์เฟซผู้ใช้ของโปรแกรมแก้ไข Workspace อาจสมบูรณ์กว่ารายการที่ API แสดง

คำขอ HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

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

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

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

string

รหัสของไฟล์

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

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

integer

จำนวนการแก้ไขสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงผลการแก้ไขอย่างน้อย 200 รายการ

ค่าสูงสุดคือ 1,000 และค่าที่สูงกว่า 1,000 จะถูกบังคับให้เป็น 1,000
pageToken

string

โทเค็นสำหรับดำเนินการต่อจากคำขอก่อนหน้าในหน้าถัดไป ควรตั้งค่าเป็นค่าของ "nextPageToken" จากการตอบกลับก่อนหน้า

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

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

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

รายการการแก้ไขไฟล์

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

การแสดง JSON 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
ช่อง
revisions[]

object (Revision)

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

string

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

string

ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "drive#revisionList"

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

ขอบเขตบางอย่างถูกจำกัดและต้องมีการประเมินความปลอดภัยเพื่อให้แอปของคุณใช้ขอบเขตเหล่านั้นได้ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์