ความแตกต่างของไดรฟ์ที่แชร์กับ 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 และผู้ใช้ยังคงเป็นสมาชิกของไดรฟ์ที่แชร์

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