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

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

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

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

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

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

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

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