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

หากคุณใช้ Google ไดรฟ์ API เวอร์ชัน 2 เนื้อหาส่วนใหญ่ในคู่มือ API ของ Google ไดรฟ์ เวอร์ชัน 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 สำหรับเวอร์ชัน 2

ในการใช้งานการรองรับไดรฟ์ที่แชร์ วิธีการต่อไปนี้ต้องใช้ 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 ระบุบทบาทที่มีผลสำหรับผู้ใช้ กลุ่ม หรือโดเมน ในเวอร์ชัน 2 คุณต้องมีทั้งช่อง role และ additionalRoles ของสิทธิ์ที่แสดงถึงบทบาทที่มีผลของผู้ใช้ กลุ่ม หรือโดเมนสำหรับรายการที่ระบุ

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

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

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

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