คู่มือนี้มีงานที่เกี่ยวข้องกับการจัดการไดรฟ์ที่แชร์ เช่น การสร้างไดรฟ์ที่แชร์และการจัดการสมาชิกและสิทธิ์โดยใช้ Google Drive API
หากต้องการระบุช่องที่จะแสดงผลในการตอบกลับ คุณสามารถตั้งค่า
fields พารามิเตอร์ระบบ
ด้วยวิธีใดก็ได้ของทรัพยากร drives หากคุณไม่ได้ระบุพารามิเตอร์ fields เซิร์ฟเวอร์จะแสดงชุดฟิลด์เริ่มต้น
ที่เฉพาะเจาะจงกับเมธอด เช่น เมธอด list จะแสดงเฉพาะฟิลด์ kind, id และ name สำหรับไดรฟ์ที่แชร์แต่ละรายการ ดูข้อมูลเพิ่มเติมได้ที่ส่งคืนฟิลด์
ที่เฉพาะเจาะจง
ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดของโฟลเดอร์ในไดรฟ์ที่แชร์ได้ที่ขีดจำกัดของโฟลเดอร์ในไดรฟ์ที่แชร์
สร้างไดรฟ์ที่แชร์
หากต้องการสร้างไดรฟ์ที่แชร์ ให้ใช้เมธอด create
ในทรัพยากร drives ที่มีพารามิเตอร์
requestId
พารามิเตอร์ requestId จะระบุความพยายามเชิงตรรกะในการสร้างไดรฟ์ที่แชร์แบบ Idempotent
หากคำขอหมดเวลาหรือแสดงข้อผิดพลาดในแบ็กเอนด์ที่ไม่แน่นอน
คุณสามารถส่งคำขอเดียวกันซ้ำได้โดยไม่ทำให้เกิดรายการที่ซ้ำกัน
requestId และเนื้อหาของคำขอต้องยังคงเหมือนเดิม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างไดรฟ์ที่แชร์
Java
Python
Node.js
PHP
.NET
การเรียกใช้เมธอด create จะ
ไม่เปลี่ยนแปลง
หากสร้างไดรฟ์ที่แชร์สำเร็จในคำขอก่อนหน้าหรือเนื่องจาก
การลองใหม่ เมธอดจะแสดงผลอินสแตนซ์ของทรัพยากร drives บางครั้ง เช่น หลังจากผ่านไประยะเวลานานหรือหากเนื้อหาของคำขอมีการเปลี่ยนแปลง ระบบอาจแสดงข้อผิดพลาด 409
ซึ่งบ่งชี้ว่าต้องทิ้ง requestId
รับไดรฟ์ที่แชร์
หากต้องการรับข้อมูลเมตาสำหรับไดรฟ์ที่แชร์ ให้ใช้เมธอด
get ในทรัพยากร drives ที่มีพารามิเตอร์เส้นทาง driveId หากไม่ทราบรหัสไดรฟ์ คุณสามารถแสดงรายการไดรฟ์ที่แชร์ทั้งหมด
โดยใช้วิธี list
เมธอด get จะแสดงผลไดรฟ์ที่แชร์เป็นอินสแตนซ์ของทรัพยากร drives
หากต้องการส่งคำขอในฐานะผู้ดูแลระบบโดเมน ให้ตั้งค่าพารามิเตอร์การค้นหา useDomainAdminAccess
เป็น true โปรดดูข้อมูลเพิ่มเติมที่หัวข้อจัดการไดรฟ์ที่แชร์ในฐานะ
ผู้ดูแลระบบโดเมน
แสดงไดรฟ์ที่แชร์
หากต้องการแสดงไดรฟ์ที่แชร์ของผู้ใช้ ให้ใช้เมธอด list
ในทรัพยากร drives เมธอดจะแสดงรายการไดรฟ์ที่แชร์
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรอง ไดรฟ์ที่แชร์
pageSize: จำนวนไดรฟ์ที่แชร์สูงสุดที่จะแสดงต่อหน้าpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ list ก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไปq: สตริงการค้นหาสำหรับค้นหาไดรฟ์ที่แชร์ ดูข้อมูลเพิ่มเติมได้ที่ค้นหาไดรฟ์ที่แชร์useDomainAdminAccess: ตั้งค่าเป็นtrueเพื่อส่งคำขอในฐานะผู้ดูแลระบบโดเมน เพื่อแสดงไดรฟ์ที่แชร์ทั้งหมดของโดเมนที่ผู้ส่งคำขอ เป็นผู้ดูแลระบบ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการไดรฟ์ที่แชร์ในฐานะผู้ดูแลระบบโดเมน
อัปเดตไดรฟ์ที่แชร์
หากต้องการอัปเดตข้อมูลเมตาสำหรับไดรฟ์ที่แชร์ ให้ใช้วิธี update ในแหล่งข้อมูล
drives ที่มีพารามิเตอร์เส้นทาง driveId
เมธอดจะแสดงผลไดรฟ์ที่แชร์เป็นอินสแตนซ์ของทรัพยากร drives
หากต้องการส่งคำขอในฐานะผู้ดูแลระบบโดเมน ให้ตั้งค่าพารามิเตอร์การค้นหา useDomainAdminAccess
เป็น true โปรดดูข้อมูลเพิ่มเติมที่หัวข้อจัดการไดรฟ์ที่แชร์ในฐานะ
ผู้ดูแลระบบโดเมน
ซ่อนและเลิกซ่อนไดรฟ์ที่แชร์
หากต้องการซ่อนไดรฟ์ที่แชร์จากมุมมองเริ่มต้น ให้ใช้วิธี hide ในแหล่งข้อมูล drives ที่มีพารามิเตอร์ driveId
เมื่อซ่อนไดรฟ์ที่แชร์ ไดรฟ์จะทำเครื่องหมายทรัพยากรไดรฟ์ที่แชร์
เป็น hidden=true ไดรฟ์ที่แชร์ที่ซ่อนไว้จะไม่ปรากฏใน
UI ของไดรฟ์หรือในรายการไฟล์ที่ส่งคืน
หากต้องการกู้คืนไดรฟ์ที่แชร์เป็นมุมมองเริ่มต้น ให้ใช้วิธี unhide กับแหล่งข้อมูล drives ที่มีพารามิเตอร์ driveId
ทั้ง 2 วิธีจะแสดงผลไดรฟ์ที่แชร์เป็นอินสแตนซ์ของทรัพยากร drives
ลบไดรฟ์ที่แชร์
หากต้องการลบไดรฟ์ที่แชร์อย่างถาวร ให้ใช้วิธี delete ในแหล่งข้อมูล drives ด้วยพารามิเตอร์ driveId
ก่อนลบไดรฟ์ที่แชร์ คุณต้องย้ายเนื้อหาทั้งหมดในไดรฟ์ที่แชร์ไปไว้ในถังขยะหรือลบออก ผู้ใช้ต้องมีrole=organizerในโฟลเดอร์ไดรฟ์ที่แชร์ด้วย ดูข้อมูลเพิ่มเติมได้ที่ทิ้งหรือลบไฟล์และโฟลเดอร์
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อกรองไดรฟ์ที่แชร์
useDomainAdminAccess: ตั้งค่าเป็นtrueเพื่อส่งคำขอในฐานะผู้ดูแลระบบโดเมน เพื่อแสดงไดรฟ์ที่แชร์ทั้งหมดของโดเมนที่ผู้ส่งคำขอ เป็นผู้ดูแลระบบ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการไดรฟ์ที่แชร์ในฐานะผู้ดูแลระบบโดเมนallowItemDeletion: ตั้งค่าเป็นtrueเพื่อลบรายการภายในไดรฟ์ที่แชร์ รองรับเฉพาะเมื่อตั้งค่าuseDomainAdminAccessเป็นtrueด้วย
เพิ่มหรือนำสมาชิกออกจากไดรฟ์ที่แชร์
เพิ่มหรือนำสมาชิกไดรฟ์ที่แชร์ออกโดยใช้แหล่งข้อมูล permissions
หากต้องการเพิ่มสมาชิก ให้สร้างสิทธิ์ในไดรฟ์ที่แชร์ นอกจากนี้ คุณยังใช้วิธีการให้สิทธิ์ กับไฟล์แต่ละไฟล์ภายในไดรฟ์ที่แชร์เพื่อมอบสิทธิ์เพิ่มเติมให้สมาชิก หรืออนุญาตให้ผู้ที่ไม่ได้เป็นสมาชิกทำงานร่วมกันในรายการที่เฉพาะเจาะจงได้ด้วย
ดูข้อมูลเพิ่มเติมและโค้ดตัวอย่างได้ที่แชร์ไฟล์ โฟลเดอร์ และไดรฟ์
จัดการไดรฟ์ที่แชร์ในฐานะผู้ดูแลระบบโดเมน
ใช้พารามิเตอร์ useDomainAdminAccess กับทรัพยากร drives และ permissions
เพื่อจัดการไดรฟ์ที่แชร์ทั่วทั้งองค์กร
ผู้ใช้ที่เรียกใช้เมธอดเหล่านี้ด้วย useDomainAdminAccess=true ต้องมีDrive and Docs สิทธิ์ของผู้ดูแลระบบ
ผู้ดูแลระบบสามารถค้นหาไดรฟ์ที่แชร์หรืออัปเดตสิทธิ์สำหรับไดรฟ์ที่แชร์ซึ่งองค์กรเป็นเจ้าของได้ ไม่ว่าผู้ดูแลระบบจะเป็นสมาชิกในไดรฟ์ที่แชร์ใดก็ตามหรือไม่ก็ตาม
เมื่อใช้บัญชีบริการ คุณอาจต้องแอบอ้างเป็นผู้ดูแลระบบที่ได้รับการตรวจสอบสิทธิ์โดยใช้การแอบอ้างเป็นบัญชีบริการ โปรดทราบว่าบัญชีบริการไม่ได้อยู่ในโดเมน Google Workspace ของคุณ ซึ่งแตกต่างจากบัญชีผู้ใช้ หากคุณแชร์ชิ้นงาน Google Workspace เช่น เอกสารหรือ กิจกรรม กับทั้งโดเมน Google Workspace ระบบจะไม่แชร์ชิ้นงานเหล่านั้นกับ บัญชีบริการ ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของบัญชีบริการ
กู้คืนไดรฟ์ที่แชร์ที่ไม่มีผู้จัดการ
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเรียกคืนไดรฟ์ที่แชร์ที่ไม่มี ผู้จัดการอีกต่อไป
Java
Python
Node.js
PHP
.NET
ป้องกันไม่ให้ผู้ใช้ดาวน์โหลด พิมพ์ หรือคัดลอกไฟล์
คุณจำกัดวิธีที่ผู้ใช้ดาวน์โหลด พิมพ์ และคัดลอกไฟล์ภายในไดรฟ์ที่แชร์ได้
หากต้องการดูว่าผู้ใช้เปลี่ยนข้อจำกัดในการดาวน์โหลดที่ผู้จัดการใช้กับไดรฟ์ที่แชร์ได้หรือไม่ ให้ตรวจสอบฟิลด์บูลีน capabilities.canChangeDownloadRestriction หากตั้งค่า
capabilities.canChangeDownloadRestrictionเป็น true คุณจะใช้ข้อจำกัดในการดาวน์โหลดกับไดรฟ์ที่แชร์ได้ ดูข้อมูลเพิ่มเติมได้ที่
ทำความเข้าใจความสามารถของไฟล์
ทรัพยากร drives มีฟิลด์
บูลีน restrictions
ที่ใช้เพื่อระบุว่าดำเนินการในไดรฟ์ที่แชร์ได้หรือไม่
ข้อจำกัดจะมีผลกับไดรฟ์ที่แชร์หรือรายการภายในไดรฟ์ที่แชร์
คุณตั้งค่าข้อจำกัดได้โดยใช้วิธี drives.update
หากต้องการใช้ข้อจำกัดในการดาวน์โหลดกับไดรฟ์ที่แชร์ ผู้จัดการไดรฟ์ที่แชร์สามารถตั้งค่าฟิลด์ restrictions.downloadRestriction ของทรัพยากร drives
ได้โดยใช้ออบเจ็กต์ DownloadRestriction
การตั้งค่าฟิลด์บูลีน restrictedForReaders เป็น true จะประกาศว่ามีการจำกัดทั้งการดาวน์โหลดและการคัดลอกสำหรับผู้อ่าน
การตั้งค่าrestrictedForWriters
ฟิลด์บูลีนเป็น true จะประกาศว่ามีการจำกัดทั้งการดาวน์โหลดและการคัดลอกสำหรับ
ผู้เขียน โปรดทราบว่าหากฟิลด์ restrictedForWriters เป็น true ผู้อ่านจะถูกจำกัดไม่ให้ดาวน์โหลดและคัดลอกด้วย ในทำนองเดียวกัน การตั้งค่า restrictedForWriters
เป็น true และ restrictedForReaders เป็น false จะเทียบเท่ากับการตั้งค่าทั้ง restrictedForWriters และ restrictedForReaders เป็น true
ความเข้ากันได้แบบย้อนหลัง
เมื่อเปิดตัวออบเจ็กต์ DownloadRestriction แล้ว ฟังก์ชันการทำงานของฟิลด์บูลีน
restrictions.copyRequiresWriterPermission
ได้รับการอัปเดตแล้ว
ตอนนี้การตั้งค่า restrictions.copyRequiresWriterPermission เป็น true จะอัปเดตฟิลด์บูลีน restrictedForReaders ของออบเจ็กต์ DownloadRestriction เป็น true เพื่อประกาศว่า
ทั้งการดาวน์โหลดและการคัดลอกจะถูกจำกัดสำหรับผู้อ่าน
การตั้งค่าฟิลด์ copyRequiresWriterPermission เป็น false จะอัปเดตทั้งฟิลด์
restrictedForWriters และ restrictedForReaders เป็น false ซึ่งหมายความว่าระบบจะนำการตั้งค่าการจำกัดการดาวน์โหลดหรือการคัดลอกออกสำหรับผู้ใช้ทั้งหมด
ฟิลด์ที่ควบคุมฟีเจอร์การดาวน์โหลด การพิมพ์ และการคัดลอก
ตารางต่อไปนี้แสดงฟิลด์ทรัพยากร drives
ที่มีผลต่อฟังก์ชันการดาวน์โหลด การพิมพ์ และการคัดลอก
| ช่อง | คำอธิบาย | เวอร์ชัน |
|---|---|---|
capabilities.canCopy |
ไม่ว่าผู้ใช้ปัจจุบันจะคัดลอกไฟล์ในไดรฟ์ที่แชร์ได้หรือไม่ | v2 และ v3 |
capabilities.canDownload |
ผู้ใช้ปัจจุบันดาวน์โหลดไฟล์ในไดรฟ์ที่แชร์ได้หรือไม่ | v2 และ v3 |
capabilities.canChangeCopyRequiresWriterPermission |
ผู้ใช้ปัจจุบันเปลี่ยนข้อจำกัด copyRequiresWriterPermission ของไดรฟ์ที่แชร์ได้หรือไม่ |
v2 และ v3 |
capabilities.canResetDriveRestrictions |
ผู้ใช้ปัจจุบันรีเซ็ตข้อจำกัดของไดรฟ์ที่แชร์เป็นค่าเริ่มต้นได้หรือไม่ | v2 และ v3 |
capabilities.canChangeDownloadRestriction |
ผู้ใช้ปัจจุบันเปลี่ยนข้อจำกัดในการดาวน์โหลดของไดรฟ์ที่แชร์ได้หรือไม่ | v3 เท่านั้น |
restrictions.copyRequiresWriterPermission |
ปิดใช้ตัวเลือกในการคัดลอก พิมพ์ หรือดาวน์โหลดไฟล์ภายในไดรฟ์ที่แชร์สำหรับผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นหรือไม่ เมื่อ true ระบบจะตั้งค่าฟิลด์ที่มีชื่อคล้ายกันเป็น true สำหรับไฟล์ใดก็ตามที่อยู่ในไดรฟ์ที่แชร์นี้ |
v2 และ v3 |
restrictions.downloadRestriction |
ข้อจำกัดในการดาวน์โหลดที่ผู้จัดการไดรฟ์ที่แชร์ใช้ | v3 เท่านั้น |
ข้อจำกัดของโฟลเดอร์
โฟลเดอร์ในไดรฟ์ที่แชร์มีขีดจำกัดของพื้นที่เก็บข้อมูลบางอย่าง ดูข้อมูลได้ที่ขีดจำกัดของไดรฟ์ที่แชร์ใน Google ไดรฟ์
จำนวนรายการสูงสุด
ไดรฟ์ที่แชร์ของผู้ใช้แต่ละรายมีขีดจำกัดอยู่ที่ 500,000 รายการ ซึ่งรวมถึงไฟล์ โฟลเดอร์ และทางลัด
เมื่อถึงขีดจำกัดแล้ว ไดรฟ์ที่แชร์จะรับรายการไม่ได้อีก หากต้องการ รับไฟล์ต่อ ผู้ใช้ต้องลบรายการออกจากไดรฟ์ที่แชร์อย่างถาวร โปรดทราบว่ารายการในถังขยะจะนับรวมในโควต้า แต่รายการที่ลบถาวรจะไม่นับรวม ดูข้อมูลเพิ่มเติมได้ที่หัวข้อทิ้งหรือลบไฟล์และโฟลเดอร์
ขีดจำกัดความลึกของโฟลเดอร์
โฟลเดอร์ในไดรฟ์ที่แชร์จะมีโฟลเดอร์ซ้อนกันได้ไม่เกิน 100 ระดับ ซึ่งหมายความว่าโฟลเดอร์ย่อยจะจัดเก็บไว้ในโฟลเดอร์ที่มีระดับความลึกมากกว่า 99 ระดับไม่ได้ ข้อจำกัดนี้ใช้กับโฟลเดอร์ย่อยเท่านั้น
การพยายามเพิ่มโฟลเดอร์มากกว่า 100 ระดับจะแสดงการตอบกลับรหัสสถานะ HTTP teamDriveHierarchyTooDeep