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

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

แหล่งข้อมูล Files

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

• 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 — ผู้เผยแพร่โฆษณาหลักจะไม่ปรากฏในรายชื่อระดับบนสุด หากผู้ใช้ที่ร้องขอไม่ได้เป็นสมาชิกของไดรฟ์ที่แชร์และไม่มีสิทธิ์เข้าถึงระดับบนสุด นอกจากนี้ ข้อมูลรายการระดับบนสุดจะต้องมี 1 รายการเท่านั้นหากไฟล์อยู่ในไดรฟ์ที่แชร์ ยกเว้นโฟลเดอร์ระดับบนสุด

  หมายเหตุ: หากคุณใช้ Drive API v2 เวอร์ชันเก่า ให้ทำดังนี้

  • shareable — เลิกใช้งานแล้ว ใช้ capabilities/canShare
  • editable — เลิกใช้งานแล้ว ใช้ capabilities/canEdit
  • copyable — เลิกใช้งานแล้ว ใช้ capabilities/canCopy
  • canComment — เลิกใช้งานแล้ว ใช้ capabilities/canComment
  • canReadRevisions — เลิกใช้งานแล้ว ใช้ capabilities/canReadRevisions

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

แหล่งข้อมูล Permissions

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

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

แหล่งข้อมูล Changes

ช่องใหม่ต่อไปนี้พร้อมใช้งานในทรัพยากร Changes สำหรับไดรฟ์ที่แชร์

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

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