ใช้การรองรับไดรฟ์ที่แชร์

ไดรฟ์ที่แชร์ใช้รูปแบบองค์กร การแชร์ และการเป็นเจ้าของที่แตกต่างจากไดรฟ์ของฉัน หากแอปจะสร้างและจัดการไฟล์ในไดรฟ์ที่แชร์ คุณต้องใช้การรองรับไดรฟ์ที่แชร์ในแอป ความซับซ้อนของการติดตั้งใช้งานจะขึ้นอยู่กับฟังก์ชันการทำงานของแอป

ในการเริ่มต้นใช้งาน คุณจะต้องใส่พารามิเตอร์การค้นหา supportsAllDrives=true ไว้ในคําขอเมื่อแอปดําเนินการต่อไปนี้

API ไดรฟ์ v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API เวอร์ชัน 2

  • 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

พารามิเตอร์ supportsAllDrives=true จะแจ้งให้ Google ไดรฟ์ทราบว่าแอปพลิเคชันของคุณออกแบบมาเพื่อจัดการไฟล์ในไดรฟ์ที่แชร์

แอปพลิเคชันที่อ่านหรือแก้ไขสิทธิ์ ติดตามการเปลี่ยนแปลง หรือจำเป็นต้องค้นหาในคอร์ปัสหลายรายการต้องใช้ฟังก์ชันการทำงานเพิ่มเติมของไดรฟ์ที่แชร์ ส่วนที่เหลือของเอกสารนี้จะไฮไลต์การเปลี่ยนแปลงเพิ่มเติมที่จําเป็นต่อการดำเนินการเหล่านี้

ค้นหาเนื้อหาในไดรฟ์ที่แชร์

ใช้เมธอด files.list เพื่อค้นหาไดรฟ์ที่แชร์ ส่วนนี้จะกล่าวถึงฟิลด์เฉพาะของไดรฟ์ที่แชร์ในเมธอด files.list หากต้องการค้นหาไดรฟ์ที่แชร์ โปรดดูหัวข้อค้นหาไฟล์และโฟลเดอร์

เมธอด files.list มีช่องและโหมดการค้นหาเฉพาะไดรฟ์ที่แชร์ต่อไปนี้

  • driveId — รหัสของไดรฟ์ที่แชร์ที่จะค้นหา

  • includeItemsFromAllDrives — ระบุว่าควรรวมรายการในไดรฟ์ที่แชร์ไว้ในผลการค้นหาหรือไม่ หากไม่มีหรือตั้งค่าเป็น "เท็จ" ระบบจะไม่แสดงรายการในไดรฟ์ที่แชร์

  • corpora — เนื้อความของรายการ (ไฟล์/เอกสาร) ที่ใช้การค้นหา เนื้อหาที่รองรับ ได้แก่ user, domain, drive และ allDrives แนะนำให้ใช้ user หรือ drive แทน allDrives เพื่อประหยัดพลังงาน

  • supportsAllDrives — แอปพลิเคชันที่ขอรองรับทั้งไดรฟ์ของฉันและไดรฟ์ที่แชร์หรือไม่ หากเป็น "เท็จ" รายการในไดรฟ์ที่แชร์จะไม่รวมอยู่ในการตอบกลับ

โหมดการค้นหาต่อไปนี้ใช้กับไดรฟ์ที่แชร์เท่านั้น

includeItemsFromAllDrives corpora คำอธิบายการค้นหา
true user ไฟล์คำค้นหาที่ผู้ใช้เข้าถึง รวมถึงไฟล์ในไดรฟ์ที่แชร์และไดรฟ์ของฉัน
true drive ค้นหารายการทั้งหมดในไดรฟ์ที่แชร์ที่ระบุ คุณต้องระบุ driveId ในคำขอ
true allDrives ค้นหาไฟล์ที่ผู้ใช้เข้าถึงและไดรฟ์ที่แชร์ทั้งหมดที่ผู้ใช้เป็นสมาชิก โปรดทราบว่าการตอบกลับอาจประกอบด้วย incompleteSearch : true ซึ่งบ่งบอกว่าไม่ได้ค้นหาคลังข้อมูลบางรายการสำหรับคำขอนี้
true domain ไฟล์คำค้นหาที่แชร์กับโดเมน ซึ่งรวมถึงไฟล์ในไดรฟ์ที่แชร์และไดรฟ์ของฉัน

ติดตามการเปลี่ยนแปลงในไดรฟ์ที่แชร์

ใช้เมธอด changes.list เพื่อติดตามการเปลี่ยนแปลงในไดรฟ์ที่แชร์ ส่วนนี้จะกล่าวถึงฟิลด์เฉพาะของไดรฟ์ที่แชร์ในเมธอด changes.list ดูข้อมูลเพิ่มเติมได้ที่ติดตามการเปลี่ยนแปลงสำหรับผู้ใช้และไดรฟ์ที่แชร์ เมธอด changes.list มีช่องและโหมดการค้นหาเฉพาะไดรฟ์ที่แชร์ต่อไปนี้

  • driveId — ไดรฟ์ที่แชร์ซึ่งแสดงผลการเปลี่ยนแปลง หากระบุไว้ รหัสการเปลี่ยนแปลงจะหมายถึงการเปลี่ยนแปลงภายในไดรฟ์ที่แชร์ ไม่ใช่การเปลี่ยนแปลงไฟล์ที่แสดงต่อผู้ใช้ หากต้องการอ้างอิงการเปลี่ยนแปลงในไดรฟ์ที่แชร์ที่เฉพาะเจาะจง ต้องใช้ทั้งรหัสไดรฟ์ที่แชร์และรหัสการเปลี่ยนแปลงเป็นตัวระบุ
  • supportsAllDrives — แอปพลิเคชันที่ส่งคำขอรองรับไดรฟ์ที่แชร์หรือไม่ หากเป็นเท็จ ระบบจะไม่แสดงรายการในไดรฟ์ที่แชร์ ซึ่งรวมถึงทั้งไดรฟ์ที่แชร์และไฟล์ภายในไดรฟ์ที่แชร์
  • includeItemsFromAllDrives — กำหนดว่าควรรวมไฟล์หรือการเปลี่ยนแปลงในไดรฟ์ที่แชร์ไว้ในรายการการเปลี่ยนแปลงหรือไม่

โหมดการค้นหาต่อไปนี้ใช้กับไดรฟ์ที่แชร์เท่านั้น

includeItemsFromAllDrives driveId คำอธิบายการค้นหา
true ไม่ การเปลี่ยนแปลงจะแสดงถึงการเปลี่ยนแปลงของไฟล์ในหรือนอกไดรฟ์ที่แชร์ซึ่งผู้ใช้เข้าถึง รวมถึงการเปลี่ยนแปลงของไดรฟ์ที่แชร์ซึ่งผู้ใช้เป็นสมาชิก
true ใช่ การเปลี่ยนแปลงจะแสดงการเปลี่ยนแปลงในไดรฟ์ที่แชร์ซึ่งระบุไว้และรายการภายในไดรฟ์ที่แชร์นั้น

ดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการทำงานของบันทึกการเปลี่ยนแปลงได้ที่บันทึกการเปลี่ยนแปลง

เปิดใช้การสนับสนุนไดรฟ์ที่แชร์ใน UI ของไดรฟ์

หากต้องการเข้าถึงเนื้อหาในไดรฟ์ที่แชร์โดยใช้ UI ของไดรฟ์ โปรดตรวจสอบว่าได้เลือกตัวเลือก "รองรับไดรฟ์ที่แชร์" ใน Google API Console แล้ว ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกำหนดค่าการผสานรวม UI ของไดรฟ์

การใช้เครื่องมือเลือกไฟล์กับไดรฟ์ที่แชร์

เครื่องมือเลือกไฟล์รองรับการเลือกรายการในไดรฟ์ที่แชร์ โปรดดูรายละเอียดเกี่ยวกับการเปิดใช้การรองรับไดรฟ์ที่แชร์และการเพิ่มมุมมองไดรฟ์ที่แชร์ในเครื่องมือเลือกไฟล์ได้ที่ Google Picker API

ขั้นตอนถัดไป

ไปที่จัดการไดรฟ์ที่แชร์เพื่อรับความช่วยเหลือในการสร้างไดรฟ์ที่แชร์และการจัดการสิทธิ์ของไดรฟ์ที่แชร์