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

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

ในการเริ่มต้น คุณต้องใส่พารามิเตอร์การค้นหา 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

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

เมธอด 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 ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าการผสานรวม UI ของไดรฟ์

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

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

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

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