REST Resource: drives

Tài nguyên: Drive

Hình ảnh đại diện cho 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
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}
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 một chuỗi hệ thập lục phân RGB. Bạn chỉ có thể đặt thuộc tính này trên yêu cầu drive.drives.update không đặt themeId.

kind

string

Chỉ có đầu ra. Xác định loại tài nguyên này. Giá trị: chuỗi cố định "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 trẻ 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 về các tệp trong bộ nhớ dùng chung này hay không.

capabilities.canCopy

boolean

Chỉ có đầu ra. Việc 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 vẫn có các mục chưa được 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 các tệp trong bộ nhớ dùng chung này xuống hay không.

capabilities.canEdit

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể chỉnh sửa các 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á thành viên hoặc thay đổi vai trò của họ hay không.

capabilities.canReadRevisions

boolean

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

capabilities.canRename

boolean

Chỉ có đầu ra. Liệu 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 quy định hạn chế về 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 quy định hạn chế về 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 quy định hạn chế về 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 quy định hạn chế về 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ề chế độ 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 vào thùng rác các tệp con trong 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à từ đó hình nền và màu sẽ được đặt. Có thể truy xuất tập hợp 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.create, một giao diện ngẫu nhiên sẽ được chọn để đặt hình nền và màu. Đây là trường chỉ ghi; bạn chỉ có thể đặt thuộc tính này trên 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 mà từ đó đặt hình nền cho bộ nhớ dùng chung này. Đây là trường chỉ ghi; bạn chỉ có thể đặt thuộc tính này trên các yêu cầu drive.drives.update không đặt themeId. Khi được chỉ định, bạn phải đặt tất cả các trường của backgroundImageFile.

backgroundImageFile.id

string

Mã nhận dạng 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 của vùng cắt trong hình nền. Đây là một giá trị trong phạm vi đóng từ 0 đến 1. Giá trị này thể hiện khoảng cách theo chiều ngang từ phía bên trái của toàn bộ hình ảnh đến phía 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 của vùng cắt trong hình nền. Đây là một giá trị trong phạm vi đóng từ 0 đến 1. Giá trị này thể hiện khoảng cách theo chiều dọc từ cạnh trên cùng 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 bị cắt trong phạm vi đã đóng từ 0 đến 1. Giá trị này thể hiện chiều rộng của hình ảnh bị 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 giữa chiều rộng và chiều cao là 80:9. Hình ảnh thu được phải có chiều rộng tối thiểu là 1280 pixel và chiều cao tối thiểu là 144 pixel.

createdTime

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ộ quy định 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. Xin lưu ý rằng bạn không thể đặt các quy định hạn chế khi tạo bộ nhớ dùng chung. Để thêm một quy tắc hạn chế, trước tiên, hãy tạo một bộ nhớ dùng chung rồi dùng drives.update để thêm các quy tắc hạn chế.

restrictions.copyRequiresWriterPermission

boolean

Liệu các tuỳ chọn sao chép, in hoặc tải tệp bên trong bộ nhớ dùng chung này xuống có bị tắt đối với người đọc và người nhận xét hay không. Khi bạn đặt quy định hạn chế này thành true, quy định hạn chế 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 người dùng của miền sở hữu bộ nhớ dùng chung này có bị giới hạn hay không 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á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 các thành viên có quyền truy cập vào các mục trong bộ nhớ dùng chung này hay không.

restrictions.adminManagedRestrictions

boolean

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

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Nếu đặt là true, chỉ 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 false, thì người dùng có vai trò người tổ chức hoặc vai trò 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 trên phản hồi drives.list khi tham số useDomainAdminAccess được đặt thành true.

Phương thức

create

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

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 một bộ nhớ dùng chung khỏi chế độ xem mặc định.

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 một bộ nhớ dùng chung.