REST Resource: drives

ทรัพยากร: ไดรฟ์

การนําเสนอไดรฟ์ที่แชร์

การแสดง 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

ชุดของข้อจํากัดที่ใช้กับไดรฟ์ที่แชร์นี้หรือรายการต่างๆ ภายในไดรฟ์ที่แชร์นี้

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

ลบไดรฟ์ที่แชร์ถาวรเมื่อผู้ใช้เป็นผู้จัด

get

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

hide

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

list

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

unhide

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

update

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