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

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

ทรัพยากรไฟล์

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

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

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

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

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

• sharedWithMeDate
• sharingUser

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

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

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

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

ทรัพยากรสิทธิ์

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

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

เปลี่ยนทรัพยากร

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

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

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