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

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

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

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

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

แสดงรายการและดาวน์โหลดการแก้ไขแต่ละรายการ

เมื่อได้รายการการแก้ไขไฟล์แล้ว คุณจะดาวน์โหลดเนื้อหาของการแก้ไขใดก็ได้โดยส่งคำขอ GET ที่ได้รับอนุญาตไปยังพร็อพเพอร์ตี้ []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) ของการแก้ไขนั้น Google ไดรฟ์จะสร้าง URL ที่มีอายุสั้นนี้เมื่อคุณขอการแก้ไข จึงไม่ควรใช้ 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) ดูข้อมูลเพิ่มเติมได้ที่อัปโหลดข้อมูลไฟล์ ข้อมูล

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

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

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

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

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

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