REST Resource: drives

Tài nguyên: Drive

Hình đại diện của một bộ nhớ dùng chung.

Một số phương thức tài nguyên (chẳng hạn như drives.update) yêu cầu driveId. Sử dụng phương thức drives.list để truy xuất mã nhận dạng của bộ nhớ dùng chung.

Biểu diễn dưới dạng 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
}
Các trường
id

string

Chỉ có đầu ra. Mã của bộ nhớ dùng chung này cũng là mã của thư mục cấp cao nhất của bộ nhớ dùng chung này.
name

string

Tên của bộ nhớ dùng chung này.
colorRgb

string

Màu của bộ nhớ dùng chung này dưới dạng chuỗi hex RGB. Bạn chỉ có thể đặt thuộc tính này theo yêu cầu drive.drives.update chưa đặt themeId.
kind

string

Chỉ có đầu ra. Đây luôn là drive#drive
capabilities

object

Chỉ có đầu ra. Các chức năng mà người dùng hiện tại có trên bộ nhớ dùng chung này.
capabilities.canAddChildren

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm thư mục con vào các thư mục trong bộ nhớ dùng chung này hay không.
capabilities.canComment

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể nhận xét trên các tệp trong bộ nhớ dùng chung này hay không.
capabilities.canCopy

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể sao chép các tệp trong bộ nhớ dùng chung này hay không.
capabilities.canDeleteDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể xoá bộ nhớ dùng chung này hay không. Bạn vẫn có thể không xoá được bộ nhớ dùng chung nếu trong bộ nhớ dùng chung có các mục chưa chuyển vào thùng rác.
capabilities.canDownload

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể tải tệp trong bộ nhớ dùng chung này xuống hay không.
capabilities.canEdit

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể chỉnh sửa tệp trong bộ nhớ dùng chung này hay không
capabilities.canListChildren

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể liệt kê thư mục con của các thư mục trong bộ nhớ dùng chung này hay không.
capabilities.canManageMembers

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm thành viên vào bộ nhớ dùng chung này, xoá họ hoặc thay đổi vai trò của họ hay không.
capabilities.canReadRevisions

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể đọc tài nguyên bản sửa đổi của các tệp trong bộ nhớ dùng chung này hay không.
capabilities.canRename

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể đổi tên các tệp hoặc thư mục trong bộ nhớ dùng chung này hay không.
capabilities.canRenameDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể đổi tên bộ nhớ dùng chung này hay không.
capabilities.canChangeDriveBackground

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi nền của bộ nhớ dùng chung này hay không.
capabilities.canShare

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể chia sẻ tệp hoặc thư mục trong bộ nhớ dùng chung này hay không.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế copyRequiresWriterPermission của bộ nhớ dùng chung này hay không.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế domainUsersOnly của bộ nhớ dùng chung này hay không.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế driveMembersOnly của bộ nhớ dùng chung này hay không.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế sharingFoldersRequiresOrganizerPermission của bộ nhớ dùng chung này hay không.
capabilities.canResetDriveRestrictions

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể đặt lại các hạn chế đối với bộ nhớ dùng chung về giá trị mặc định hay không.
capabilities.canDeleteChildren

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể xoá trẻ khỏi các thư mục trong bộ nhớ dùng chung này hay không.
capabilities.canTrashChildren

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể chuyển trẻ vào thùng rác của các thư mục trong bộ nhớ dùng chung này hay không.
themeId

string

Mã của giao diện mà hình nền và màu nền sẽ được đặt. Bạn có thể truy xuất tập hợp các driveThemes có thể có từ phản hồi drive.about.get. Khi không được chỉ định trong yêu cầu drive.drives.insert, một giao diện ngẫu nhiên sẽ được chọn để đặt hình nền và màu nền. Đây là trường chỉ ghi; chỉ có thể đặt trường này trong các yêu cầu không đặt colorRgb hoặc backgroundImageFile.
backgroundImageFile

object

Một tệp hình ảnh và thông số cắt để đặt hình nền cho bộ nhớ dùng chung này. Đây là trường chỉ ghi; trường này chỉ có thể thiết lập theo các yêu cầu drive.drives.update không đặt themeId. Khi chỉ định, bạn phải đặt tất cả các trường của backgroundImageFile.
backgroundImageFile.id

string

Mã của tệp hình ảnh trong Google Drive để sử dụng cho hình nền.
backgroundImageFile.xCoordinate

number

Toạ độ X của góc trên bên trái vùng cắt trong hình nền. Đây là một giá trị nằm trong khoảng khép kín từ 0 đến 1. Giá trị này thể hiện khoảng cách theo chiều ngang từ cạnh bên trái của toàn bộ hình ảnh đến bên trái của vùng cắt chia cho chiều rộng của toàn bộ hình ảnh.
backgroundImageFile.yCoordinate

number

Toạ độ Y của góc trên bên trái vùng cắt trong hình nền. Đây là một giá trị nằm trong khoảng khép kín từ 0 đến 1. Giá trị này đại diện cho khoảng cách theo chiều dọc từ cạnh trên của toàn bộ hình ảnh đến cạnh trên cùng của vùng cắt chia cho chiều cao của toàn bộ hình ảnh.
backgroundImageFile.width

number

Chiều rộng của hình ảnh được cắt trong phạm vi khép kín từ 0 đến 1. Giá trị này biểu thị chiều rộng của hình ảnh được cắt chia cho chiều rộng của toàn bộ hình ảnh. Chiều cao được tính bằng cách áp dụng tỷ lệ khung hình chiều rộng so với chiều cao từ 80 đến 9. Hình ảnh thu được phải có chiều rộng tối thiểu 1280 pixel và chiều cao tối thiểu 144 pixel.
createdDate

string

Chỉ có đầu ra. Thời gian tạo bộ nhớ dùng chung (ngày-giờ RFC 3339).
hidden

boolean

Liệu bộ nhớ dùng chung có bị ẩn khỏi chế độ xem mặc định hay không.
restrictions

object

Một bộ hạn chế áp dụng cho bộ nhớ dùng chung này hoặc các mục trong bộ nhớ dùng chung này.
restrictions.copyRequiresWriterPermission

boolean

Có tắt các tuỳ chọn sao chép, in hoặc tải tệp xuống trong bộ nhớ dùng chung này đối với người đọc và người nhận xét hay không. Khi bạn đặt hạn chế này thành true, trường này sẽ ghi đè trường có tên tương tự thành true đối với mọi tệp trong bộ nhớ dùng chung này.
restrictions.domainUsersOnly

boolean

Việc quyền truy cập vào bộ nhớ dùng chung này và các mục trong bộ nhớ dùng chung này có bị giới hạn ở người dùng của miền chứa bộ nhớ dùng chung này hay không. Các chính sách chia sẻ khác được kiểm soát bên ngoài bộ nhớ dùng chung này có thể thay thế quy định hạn chế này.
restrictions.driveMembersOnly

boolean

Liệu quyền truy cập vào các mục trong bộ nhớ dùng chung này có bị giới hạn đối với các thành viên trong bộ nhớ dùng chung hay không.
restrictions.adminManagedRestrictions

boolean

Liệu có cần đặc quyền quản trị trên bộ nhớ dùng chung này để sửa đổi các quy định hạn chế hay không.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Nếu đúng, thì chỉ những người dùng có vai trò người tổ chức mới có thể chia sẻ thư mục. Nếu bạn đặt chính sách này thành sai, thì người dùng có vai trò người tổ chức hoặc người tổ chức tệp có thể chia sẻ thư mục.
orgUnitId

string

Chỉ có đầu ra. Đơn vị tổ chức của bộ nhớ dùng chung này. Trường này chỉ được điền sẵn trên drives.list phản hồi khi bạn đặt tham số useDomainAdminAccess thành true.

Phương thức

delete

 Xoá vĩnh viễn một bộ nhớ dùng chung mà người dùng là organizer.

get

 Lấy siêu dữ liệu của bộ nhớ dùng chung theo mã nhận dạng.

hide

 Ẩn bộ nhớ dùng chung khỏi chế độ xem mặc định.

insert

 Tạo bộ nhớ dùng chung mới.

list

Liệt kê bộ nhớ dùng chung của người dùng.

unhide

 Khôi phục bộ nhớ dùng chung về chế độ xem mặc định.

update

 Cập nhật siêu dữ liệu cho bộ nhớ dùng chung.