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

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

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

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

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

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

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

ความแตกต่างของคำค้นหาสำหรับเวอร์ชัน 2

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

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

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