คู่มือสําหรับ Drive API v2

ถ้าคุณใช้ Google Drive API เวอร์ชัน 2 เนื้อหาส่วนใหญ่ใน Google Drive API คำแนะนำ v3 เกี่ยวข้องกับ v2 ด้วยเช่นกัน ส่วนนี้ มีข้อมูลทั้งหมดที่เจาะจงเฉพาะ v2 และแตกต่างจาก แสดงในหน้าเว็บบางหน้าของคู่มือ v3 หากต้องการดูบริบททั้งหมด ให้หัวข้อย่อยแต่ละส่วน จะมีลิงก์ไปยังหน้าคำแนะนำที่เกี่ยวข้อง

ดูรายการความแตกต่างทั้งหมดได้ที่ Drive API v2 และ การเปรียบเทียบ v3 ข้อมูลอ้างอิง

ดาวน์โหลดและ เผยแพร่การแก้ไขไฟล์

ในหน้า ดาวน์โหลดและ เผยแพร่การแก้ไขไฟล์ จะมีข้อมูลต่อไปนี้เฉพาะสำหรับ v2 และแทนที่ส่วนเหล่านี้ แสดงสำหรับ v3:

รายการและ ดาวน์โหลดการแก้ไขส่วนบุคคล

เมื่อคุณได้รับรายการการแก้ไขของไฟล์แล้ว คุณสามารถดาวน์โหลดเนื้อหาของ โดยส่งคำขอ GET ที่ได้รับอนุญาตไปยัง []downloadUrl](/drive/api/reference/rest/v2/revisions) Google ไดรฟ์จะสร้าง URL ที่มีอายุสั้นนี้เมื่อคุณขอแก้ไข โปรดอย่าใช้ฟีเจอร์นี้ในภายหลัง

นอกจากนี้คุณยังส่งออกการแก้ไขได้ในรูปแบบที่รองรับโดยทำเครื่องหมายในช่อง พร็อพเพอร์ตี้ exportLinks

พร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง

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

มีการเข้าถึงพร็อพเพอร์ตี้โดยใช้ แหล่งข้อมูล properties

นี่คือโครงสร้างของพร็อพเพอร์ตี้ทั่วไปที่อาจใช้จัดเก็บ รหัสฐานข้อมูลของไฟล์ในไดรฟ์ในไฟล์

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจํากัดที่หัวข้อ properties ในข้อมูลอ้างอิง เอกสารประกอบ

เปิดใช้การรองรับไดรฟ์ที่แชร์

นอกเหนือจากข้อมูลในหน้าใช้งานการสนับสนุนไดรฟ์ที่แชร์แล้ว ให้ใส่ข้อมูลในช่องเพิ่มเติมนี้แทน trashedDate สำหรับ v2

ในการใช้งานการสนับสนุนไดรฟ์ที่แชร์ เมธอดต่อไปนี้ต้องใช้ supportsAllDrives=true เมื่อใช้งานร่วมกับ ขับเคลื่อนเนื้อหา:

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

เมธอด changes.get และ changes.list มีพารามิเตอร์หลายรายการที่เกี่ยวข้องกับ ไดรฟ์ที่แชร์ สำหรับรายการของพารามิเตอร์ โปรดดู ติดตามการเปลี่ยนแปลงบน ไดรฟ์

อัปโหลดไฟล์

ในหน้าอัปโหลดข้อมูลไฟล์ คุณจะเห็นข้อมูลนี้ เป็นข้อมูลเฉพาะสำหรับ v2:

นำเข้าเป็นประเภท Google เอกสาร

เมื่อคุณสร้างไฟล์ใน Google ไดรฟ์ คุณสามารถแปลงไฟล์บางประเภทเป็นไฟล์ เอกสาร Google เอกสาร, Google ชีต หรือ Google สไลด์ ใส่ files.insert convert การค้นหา และตั้งค่าพร็อพเพอร์ตี้ mimeType (workspace_name) ของไฟล์ สำหรับ ดูข้อมูลเพิ่มเติมได้ที่อัปโหลดไฟล์ ข้อมูล

แชร์ไฟล์ โฟลเดอร์ และ ไดรฟ์

ประกาศเกี่ยวกับแชร์ไฟล์ โฟลเดอร์ และ ไดรฟ์ role ระบุบทบาทที่มีประสิทธิภาพสำหรับผู้ใช้ กลุ่ม หรือโดเมน ในเวอร์ชัน 2 คุณต้องมีทั้งช่อง role และ additionalRoles สิทธิ์แสดงถึงบทบาทที่มีผลที่ผู้ใช้ กลุ่ม หรือโดเมนมีสำหรับ รายการที่กำหนด

ความแตกต่างของคำค้นหาสำหรับ v2

ฟิลด์ title ของ v2 คือ name ใน v3 โปรดดูตัวอย่างที่หัวข้อค้นหาไฟล์และ โฟลเดอร์

ฟิลด์ createdDate ของ v2 คือ createdTime ใน v3 ตัวอย่างเช่น ดูค้นหา ไดรฟ์ที่แชร์

ฟิลด์ modifiedDate ของ v2 คือ modifiedTime ใน v3 lastViewedByMeDate เวอร์ชัน 2 viewedByMeTimeใน v3 ดูรายละเอียดเพิ่มเติมได้ที่ คำค้นหาและ โอเปอเรเตอร์