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

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

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

Drive 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 v2

  • 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 method หากต้องการค้นหาไดรฟ์ที่แชร์ โปรดดูที่หัวข้อ ค้นหาไฟล์และโฟลเดอร์

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

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

  • includeItemsFromAllDrives — Whether shared drive items should be included in results. หากไม่มีหรือตั้งค่าเป็น "เท็จ" ระบบจะไม่แสดงรายการในไดรฟ์ที่แชร์

  • 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 method ดูข้อมูลเพิ่มเติมได้ที่ติดตามการเปลี่ยนแปลงสำหรับผู้ใช้และไดรฟ์ที่แชร์ เมธอด changes.list มีฟิลด์และโหมดการค้นหาเฉพาะไดรฟ์ที่แชร์ต่อไปนี้

  • driveId — ไดรฟ์ที่แชร์ซึ่งมีการส่งคืนการเปลี่ยนแปลง หาก ระบุ รหัสการเปลี่ยนแปลงจะอ้างอิงถึงการเปลี่ยนแปลงภายในไดรฟ์ที่แชร์ ไม่ใช่ การเปลี่ยนแปลงไฟล์ที่แสดงต่อผู้ใช้ หากต้องการอ้างอิงการเปลี่ยนแปลงในไดรฟ์ที่แชร์ ที่เฉพาะเจาะจง คุณต้องใช้ทั้งรหัสไดรฟ์ที่แชร์และรหัสการเปลี่ยนแปลงเป็นตัวระบุ
  • supportsAllDrives — ระบุว่าแอปพลิเคชันที่ขอรองรับไดรฟ์ที่แชร์หรือไม่ หากเป็นเท็จ ระบบจะไม่แสดงรายการในไดรฟ์ที่แชร์ ซึ่งรวมถึงทั้งไดรฟ์ที่แชร์และ ไฟล์ภายในไดรฟ์ที่แชร์
  • includeItemsFromAllDrives — Whether shared drive files or changes should be included in the list of changes.

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

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

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

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

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

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

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

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

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