ความแตกต่างของไดรฟ์ที่แชร์กับ API ไดรฟ์ของฉัน

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

ทรัพยากร Files

ระบบจะป้อนข้อมูลในช่องต่อไปนี้สำหรับไฟล์ที่อยู่ในไดรฟ์ที่แชร์เท่านั้น

• hasAugmentedPermissions — ผู้ใช้ได้รับสิทธิ์เข้าถึงไฟล์ในไฟล์นี้โดยตรงหรือไม่
• capabilities/canAddFolderFromAnotherDrive — อนุญาตให้ผู้ใช้ปัจจุบันเพิ่มโฟลเดอร์จากไดรฟ์ (ไดรฟ์ที่แชร์อื่นหรือไดรฟ์ของฉัน) ลงในโฟลเดอร์นี้ได้หรือไม่
• capabilities/canDeleteChildren — ผู้ใช้ปัจจุบันจะลบโฟลเดอร์ย่อยของโฟลเดอร์นี้ได้หรือไม่
• capabilities/canMoveChildrenOutOfDrive — ผู้ใช้ปัจจุบันสามารถย้ายโฟลเดอร์ย่อยของโฟลเดอร์นี้ออกนอกไดรฟ์ที่แชร์ได้หรือไม่
• capabilities/canMoveChildrenWithinDrive — ระบุว่าผู้ใช้ปัจจุบันย้ายโฟลเดอร์ย่อยของโฟลเดอร์นี้ภายในไดรฟ์ที่แชร์ได้หรือไม่
• capabilities/canMoveItemWithinDrive — ผู้ใช้ปัจจุบันสามารถย้ายรายการในไดรฟ์ที่แชร์นี้ภายในไดรฟ์ที่แชร์ได้หรือไม่
• capabilities/canReadDrive — ผู้ใช้ปัจจุบันมีสิทธิ์อ่านไดรฟ์ที่แชร์ซึ่งไฟล์นี้อยู่หรือไม่
• capabilities/canTrashChildren — ผู้ใช้ปัจจุบันสามารถทิ้งโฟลเดอร์ย่อยของโฟลเดอร์นี้ได้หรือไม่
• driveId — รหัสของไดรฟ์ที่แชร์ซึ่งมีตำแหน่งของไฟล์
• trashingUser — หากไฟล์ถูกทิ้งอย่างชัดแจ้ง ผู้ใช้ที่ทิ้งไฟล์

• trashedTime — เวลาที่มีการทิ้งรายการ

ระบบจะไม่ป้อนข้อมูลในช่องต่อไปนี้สำหรับไฟล์ที่อยู่ในไดรฟ์ที่แชร์

• permissions — ระบบจะไม่แสดงสิทธิ์เป็นส่วนหนึ่งของไฟล์เนื่องจากขนาดที่เป็นไปได้ของ ACL ของไดรฟ์ที่แชร์ ใช้เมธอด permissions.list ซึ่งรองรับการแบ่งหน้าเพื่อแสดงรายการสิทธิ์ของไฟล์ภายในไดรฟ์ที่แชร์หรือไดรฟ์ที่แชร์นั้นๆ
• owners, ownerNames, ownedByMe — ไฟล์ภายในไดรฟ์ที่แชร์จะถือเป็นของไดรฟ์ที่แชร์ ไม่ใช่ผู้ใช้แต่ละราย
• folderColorRgb — ไม่สามารถกำหนดสีให้กับโฟลเดอร์แต่ละรายการได้
• shared — แชร์รายการทั้งหมดในไดรฟ์ที่แชร์
• writersCanShare — ปัจจุบันคุณยังจำกัดการแชร์ตามบทบาทในไดรฟ์ที่แชร์ไม่ได้

ระบบจะตั้งค่าช่องต่อไปนี้ก็ต่อเมื่อผู้ใช้ได้รับสิทธิ์เข้าถึงไฟล์ในรายการเท่านั้น

• sharedWithMeDate
• sharingUser

คุณต้องพิจารณาช่องต่อไปนี้เป็นพิเศษเมื่อใช้ช่องเหล่านี้กับไดรฟ์ที่แชร์

• parents.isRoot — ช่องนี้จะมีค่าเป็น "จริง" สำหรับโฟลเดอร์รูทของไดรฟ์ของฉันเท่านั้น และมีค่าเป็น "เท็จ" สำหรับโฟลเดอร์ระดับบนสุดของไดรฟ์ที่แชร์

• parents — โฟลเดอร์หลักจะไม่ปรากฏในรายการโฟลเดอร์หลักหากผู้ใช้ที่ขอไม่ได้เป็นสมาชิกของไดรฟ์ที่แชร์และไม่มีสิทธิ์เข้าถึงโฟลเดอร์หลัก นอกจากนี้ รายการระดับบนสุดต้องมีเพียง 1 รายการเท่านั้นหากไฟล์อยู่ในไดรฟ์ที่แชร์ (ยกเว้นโฟลเดอร์ระดับบนสุด)

• capabilities/canRemoveChildren — ใช้ capabilities/canDeleteChildren หรือ capabilities/canTrashChildren

ทรัพยากร Permissions

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

• มีการกำหนดบทบาทใหม่ 2 บทบาท ได้แก่ organizer และ fileOrganizer
• ขณะนี้ permissions.list รองรับการแบ่งหน้าแล้ว

ทรัพยากร Changes

ฟิลด์ใหม่ต่อไปนี้มีอยู่ในChangesแหล่งข้อมูลสำหรับไดรฟ์ที่แชร์

• changeType — ประเภทของการเปลี่ยนแปลง ค่าที่เป็นไปได้คือ file และ drive
• driveId — รหัสของไดรฟ์ที่แชร์ซึ่งเชื่อมโยงกับการเปลี่ยนแปลงนี้
• drive — สถานะที่อัปเดตแล้วของไดรฟ์ที่แชร์ แสดงหาก changeType คือ drive และผู้ใช้ยังคงเป็นสมาชิกของไดรฟ์ที่แชร์

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