REST Resource: drives

Tài nguyên: Drive

Biểu thị 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 có 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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "orgUnitId": string
}
Trường
id

string

Chỉ có đầu ra. Mã nhận dạng của bộ nhớ dùng chung này, cũng là mã nhận dạng 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 tham số này trên một 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 quyền 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. 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. Liệu người dùng hiện tại có thể sao chép tệp trong bộ nhớ dùng chung này hay không.
capabilities.canDeleteDrive

boolean

Chỉ có đầu ra. Xem 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 có các mục chưa bị xoá vào thùng rác trong bộ nhớ dùng chung đó.
capabilities.canDownload

boolean

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

boolean

Chỉ có đầu ra. Xem 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ê các thư mục con trong bộ nhớ dùng chung này hay không.
capabilities.canManageMembers

boolean

Chỉ có đầu ra. Xem 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 thành viên hay không.
capabilities.canReadRevisions

boolean

Chỉ có đầu ra. Liệu 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. Liệu người dùng hiện tại có thể đổi tên 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. 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. 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ế của 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á các mục con khỏi 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 các thư mục con trong bộ nhớ dùng chung này vào thùng rác hay không.
capabilities.canChangeDownloadRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi các hạn chế tải xuống do người tổ chức áp dụng cho bộ nhớ dùng chung này hay không.
themeId

string

Mã nhận dạng của giao diện mà từ đó hình nền và màu nền sẽ được đặt. Bạn 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 sắc. Đây là trường chỉ ghi; bạn chỉ có thể đặt trường này trên những yêu cầu không đặt colorRgb hoặc backgroundImageFile.
backgroundImageFile

object

Một tệp hình ảnh và các thông số cắt xén để đặ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 trường 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 một tệp hình ảnh trong Google Drive để dùng cho hình nền.
backgroundImageFile.xCoordinate

number

Toạ độ X của góc trên cùng bên trái của vùng cắt trong hình nền. Đây là một giá trị trong khoảng đóng từ 0 đến 1. Giá trị này biểu thị khoảng cách theo chiều ngang từ cạnh trái của toàn bộ hình ảnh đến cạnh 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 cùng bên trái của vùng cắt trong hình nền. Đây là một giá trị trong khoảng đóng từ 0 đến 1. Giá trị này biểu thị 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ủ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 biểu thị 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 điểm tạo bộ nhớ dùng chung (ngày giờ theo RFC 3339).
hidden

boolean

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

object

Một nhóm các 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 hạn chế khi tạo bộ nhớ dùng chung. Để thêm 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 hạn chế.
restrictions.copyRequiresWriterPermission

boolean

Có nên tắt các lựa 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 chế độ hạn chế này thành true, chế độ này sẽ ghi đè trường có tên tương tự thành true cho mọi tệp trong bộ nhớ dùng chung này.
restrictions.domainUsersOnly

boolean

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ị hạn chế đối với người dùng thuộc miền mà bộ nhớ dùng chung này thuộc về 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ể ghi đè hạn chế này.
restrictions.driveMembersOnly

boolean

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

boolean

Có cần đặc quyền quản trị 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 đúng, 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 là false, 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.
restrictions.downloadRestriction

object (DownloadRestriction)

Các hạn chế tải xuống do người quản lý bộ nhớ dùng chung áp dụng.
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 trong các phản hồi drives.list khi tham số useDomainAdminAccess được đặt thành true.

Phương thức

create

 Tạo 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 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 bộ nhớ dùng chung.