ไดรฟ์ที่แชร์จะเป็นไปตามรูปแบบการจัดระเบียบ การแชร์ และการเป็นเจ้าของที่ต่างกันจากไดรฟ์ของฉัน หากแอปของคุณจะสร้างและจัดการไฟล์ในไดรฟ์ที่แชร์ คุณต้องใช้การรองรับไดรฟ์ที่แชร์ในแอป โดยความซับซ้อนของการติดตั้งใช้งานจะขึ้นอยู่กับฟังก์ชันการทำงานของแอป
ในการเริ่มต้น คุณต้องใส่พารามิเตอร์การค้นหา 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
ขั้นตอนถัดไป
ไปที่หัวข้อจัดการไดรฟ์ที่แชร์เพื่อขอความช่วยเหลือในการสร้างไดรฟ์ที่แชร์และจัดการสิทธิ์ในไดรฟ์ที่แชร์