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
  },
  "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
  },
  "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

เอาต์พุตเท่านั้น ผู้ใช้ปัจจุบันสามารถทิ้งไฟล์ย่อยจากโฟลเดอร์ในไดรฟ์ที่แชร์นี้หรือไม่
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

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

string

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

เมธอด

create

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

delete

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

get

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

hide

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

list

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

unhide

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

update

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