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

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

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

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

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

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

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