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

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

หากต้องการเริ่มต้น คุณต้องใส่พารามิเตอร์การค้นหา 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 ไดรฟ์ทราบว่าแอปพลิเคชันของคุณออกแบบมาเพื่อจัดการไฟล์ในไดรฟ์ที่แชร์

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

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

ใช้วิธี list ในแหล่งข้อมูล files เพื่อค้นหาไฟล์ของผู้ใช้ในไดรฟ์ที่แชร์ หากต้องการ ค้นหาไดรฟ์ที่แชร์ โปรดดูค้นหาไดรฟ์ที่แชร์

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

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

  • corpora: เนื้อหาของรายการ (ไฟล์หรือเอกสาร) ที่ใช้การค้นหา หน่วยงานที่รองรับ ได้แก่ user, domain, drive และ allDrives user หรือ drive ดีกว่า allDrives เพื่อประสิทธิภาพ โดยค่าเริ่มต้น ระบบจะตั้งค่าคลังข้อความ เป็น user

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

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

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

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

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

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

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

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

  • includeItemsFromAllDrives: ระบุว่าควรมีไฟล์หรือการเปลี่ยนแปลงในไดรฟ์ที่แชร์ รวมอยู่ในรายการการเปลี่ยนแปลงหรือไม่

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

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

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

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับลักษณะการทำงานของบันทึกการเปลี่ยนแปลงที่หัวข้อติดตามการเปลี่ยนแปลงสำหรับผู้ใช้ และไดรฟ์ที่แชร์

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

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

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

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