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
  },
  "createdDate": 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.insert ระบบจะเลือกธีมแบบสุ่มซึ่งใช้เป็นการตั้งค่าภาพพื้นหลังและสี ช่องนี้เป็นช่องสำหรับเขียนเท่านั้น ตั้งค่าได้สำหรับคำขอที่ไม่ได้ตั้งค่า 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 พิกเซล

createdDate

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

วิธีการ

delete

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

get

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

hide

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

insert

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

list

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

unhide

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

update

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