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

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

คู่มือนี้จะอธิบายความแตกต่างของ API ที่เฉพาะเจาะจงไดรฟ์ที่แชร์ในทรัพยากร files และ changes

แหล่งข้อมูลไฟล์

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

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

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

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

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

  • sharedWithMeDate
  • sharingUser

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

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

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

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

เปลี่ยนแหล่งข้อมูล

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

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

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