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

หากคุณใช้ Google Drive API เวอร์ชัน 2 เนื้อหาส่วนใหญ่ในคู่มือ Google Drive API เวอร์ชัน 3 เกี่ยวข้องกับเวอร์ชัน 2 ด้วย ส่วนนี้ประกอบด้วยข้อมูลทั้งหมดสำหรับ 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 และตั้งค่าพร็อพเพอร์ตี้ (workspace_name) mimeType ของไฟล์ ดูข้อมูลเพิ่มเติมได้ที่อัปโหลดข้อมูลไฟล์

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

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

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

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

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

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