REST Resource: drives

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

การแสดงไดรฟ์ที่แชร์

เมธอดทรัพยากรบางรายการ (เช่น drives.update) ต้องใช้ driveId ใช้เมธอด drives.list เพื่อเรียกข้อมูลรหัสของไดรฟ์ที่แชร์

การแสดง JSON
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean,
    "canChangeDownloadRestriction": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "orgUnitId": string
}
ช่อง
id

string

เอาต์พุตเท่านั้น รหัสของไดรฟ์ที่แชร์นี้ซึ่งเป็นรหัสของโฟลเดอร์ระดับบนสุดของไดรฟ์ที่แชร์นี้ด้วย

name

string

ชื่อของไดรฟ์ที่แชร์นี้

colorRgb

string

สีของไดรฟ์ที่แชร์นี้เป็นสตริงเลขฐานสิบหกของ RGB โดยจะตั้งค่าได้เฉพาะในคำขอ drive.drives.update ที่ไม่ได้ตั้งค่า themeId

kind

string

เอาต์พุตเท่านั้น ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "drive#drive"

capabilities

object

เอาต์พุตเท่านั้น ความสามารถที่ผู้ใช้ปัจจุบันมีในไดรฟ์ที่แชร์นี้

capabilities.canAddChildren

boolean

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

capabilities.canComment

boolean

เอาต์พุตเท่านั้น ผู้ใช้ปัจจุบันแสดงความคิดเห็นในไฟล์ในไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canCopy

boolean

เอาต์พุตเท่านั้น ระบุว่าผู้ใช้ปัจจุบันคัดลอกไฟล์ในไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canDeleteDrive

boolean

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

capabilities.canDownload

boolean

เอาต์พุตเท่านั้น ระบุว่าผู้ใช้ปัจจุบันดาวน์โหลดไฟล์ในไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canEdit

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canManageMembers

boolean

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

capabilities.canReadRevisions

boolean

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

capabilities.canRename

boolean

เอาต์พุตเท่านั้น ผู้ใช้ปัจจุบันเปลี่ยนชื่อไฟล์หรือโฟลเดอร์ในไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canRenameDrive

boolean

เอาต์พุตเท่านั้น ระบุว่าผู้ใช้ปัจจุบันเปลี่ยนชื่อไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canChangeDriveBackground

boolean

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

capabilities.canShare

boolean

เอาต์พุตเท่านั้น ไม่ว่าผู้ใช้ปัจจุบันจะแชร์ไฟล์หรือโฟลเดอร์ในไดรฟ์ที่แชร์นี้ได้หรือไม่

capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

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

capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

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

capabilities.canResetDriveRestrictions

boolean

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

capabilities.canDeleteChildren

boolean

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

capabilities.canTrashChildren

boolean

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

capabilities.canChangeDownloadRestriction

boolean

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

themeId

string

รหัสของธีมที่จะใช้ตั้งค่ารูปภาพและสีพื้นหลัง คุณดึงชุด driveThemes ที่เป็นไปได้จากคำตอบของ drive.about.get ได้ เมื่อไม่ได้ระบุในคำขอ drive.drives.create ระบบจะเลือกธีมแบบสุ่มเพื่อตั้งค่ารูปภาพและสีพื้นหลัง ฟิลด์นี้เป็นฟิลด์แบบเขียนอย่างเดียว โดยจะตั้งค่าได้เฉพาะในคำขอที่ไม่ได้ตั้งค่า colorRgb หรือ backgroundImageFile

backgroundImageFile

object

ไฟล์รูปภาพและพารามิเตอร์การครอบตัดที่ใช้ตั้งค่าภาพพื้นหลังสำหรับไดรฟ์ที่แชร์นี้ นี่คือฟิลด์ที่เขียนได้อย่างเดียว โดยจะตั้งค่าได้เฉพาะในคำขอ drive.drives.update ที่ไม่ได้ตั้งค่า themeId เมื่อระบุแล้ว ต้องตั้งค่าช่องทั้งหมดของ backgroundImageFile

backgroundImageFile.id

string

รหัสของไฟล์รูปภาพใน Google ไดรฟ์ที่จะใช้เป็นรูปภาพพื้นหลัง

backgroundImageFile.xCoordinate

number

พิกัด X ของมุมซ้ายบนของพื้นที่ครอบตัดในภาพพื้นหลัง ค่านี้อยู่ในช่วงปิดตั้งแต่ 0 ถึง 1 ค่านี้แสดงถึงระยะห่างในแนวนอนจากด้านซ้ายของรูปภาพทั้งหมดไปยังด้านซ้ายของพื้นที่ครอบตัด หารด้วยความกว้างของรูปภาพทั้งหมด

backgroundImageFile.yCoordinate

number

พิกัด Y ของมุมซ้ายบนของพื้นที่ครอบตัดในภาพพื้นหลัง ค่านี้อยู่ในช่วงปิดตั้งแต่ 0 ถึง 1 ค่านี้แสดงถึงระยะห่างในแนวตั้งจากด้านบนของรูปภาพทั้งหมดไปยังด้านบนของพื้นที่ครอบตัด หารด้วยความสูงของรูปภาพทั้งหมด

backgroundImageFile.width

number

ความกว้างของรูปภาพที่ครอบตัดในช่วงปิด 0 ถึง 1 ค่านี้แสดงถึงความกว้างของรูปภาพที่ครอบตัดหารด้วยความกว้างของรูปภาพทั้งหมด ระบบจะคำนวณความสูงโดยใช้อัตราส่วนสัดส่วนความกว้างต่อความสูงเป็น 80 ต่อ 9 รูปภาพที่ได้ต้องมีความกว้างอย่างน้อย 1280 พิกเซลและสูง 144 พิกเซล

createdTime

string

เอาต์พุตเท่านั้น เวลาที่สร้างไดรฟ์ที่แชร์ (วันที่และเวลาตาม RFC 3339)

hidden

boolean

ไม่ว่าจะซ่อนไดรฟ์ที่แชร์จากมุมมองเริ่มต้นหรือไม่

restrictions

object

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

restrictions.copyRequiresWriterPermission

boolean

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

restrictions.domainUsersOnly

boolean

ไม่ว่าการเข้าถึงไดรฟ์ที่แชร์นี้และรายการภายในไดรฟ์ที่แชร์นี้จะจำกัดเฉพาะผู้ใช้ของโดเมนที่ไดรฟ์ที่แชร์นี้เป็นของโดเมนนั้นหรือไม่ นโยบายการแชร์อื่นๆ ที่ควบคุมภายนอกไดรฟ์ที่แชร์นี้อาจลบล้างข้อจำกัดนี้

restrictions.driveMembersOnly

boolean

ไม่ว่าสิทธิ์เข้าถึงรายการในไดรฟ์ที่แชร์นี้จะจำกัดเฉพาะสมาชิกหรือไม่

restrictions.adminManagedRestrictions

boolean

ต้องมีสิทธิ์ของผู้ดูแลระบบในไดรฟ์ที่แชร์นี้หรือไม่จึงจะแก้ไขข้อจำกัดได้

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

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

restrictions.downloadRestriction

object (DownloadRestriction)

ข้อจำกัดในการดาวน์โหลดที่ผู้จัดการไดรฟ์ที่แชร์ใช้

orgUnitId

string

เอาต์พุตเท่านั้น หน่วยขององค์กรของไดรฟ์ที่แชร์นี้ ระบบจะป้อนข้อมูลในช่องนี้เฉพาะในการตอบกลับของ drives.list เมื่อตั้งค่าพารามิเตอร์ useDomainAdminAccess เป็น true

เมธอด

create

สร้างไดรฟ์ที่แชร์

delete

ลบไดรฟ์ที่แชร์ที่ผู้ใช้เป็นorganizerอย่างถาวร

get

รับข้อมูลเมตาของไดรฟ์ที่แชร์ตามรหัส

hide

ซ่อนไดรฟ์ที่แชร์จากมุมมองเริ่มต้น

list

แสดงรายการไดรฟ์ที่แชร์ของผู้ใช้

unhide

กู้คืนไดรฟ์ที่แชร์เป็นมุมมองเริ่มต้น

update

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