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 cho một 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
}
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 trong 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 ổ đĩa dùng chung này dưới dạng chuỗi thập lục phân RGB. Bạn chỉ có thể đặt giá trị này trên một yêu cầu drive.drives.update không đặt themeId.

kind

string

Chỉ có đầu ra. Giá trị này luôn là 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. Người dùng hiện tại có thể thêm thư mục con vào 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. 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. 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 được chuyển vào thùng rác bên trong bộ nhớ dùng chung.

capabilities.canDownload

boolean

Chỉ có đầu ra. 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. 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. 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. Người dùng hiện tại có thể thêm, xoá hoặc thay đổi vai trò của thành viên trong bộ nhớ dùng chung này 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 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. 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. Người dùng hiện tại có thể thay đổi quy định 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 quy định hạn chế domainUsersOnly của bộ nhớ dùng chung này hay không.

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể thay đổi quy định 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 quy định 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á thư mục con 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. Người dùng hiện tại có thể chuyển các thư mục con vào thùng rác trong bộ nhớ dùng chung này hay không.

themeId

string

Mã nhận dạng của giao diện mà hình ảnh 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 trên yêu cầu drive.drives.insert, hệ thống sẽ chọn một giao diện ngẫu nhiên để đặt hình nền và màu. Đây là trường chỉ có thể ghi; bạn chỉ có thể đặt trường này trên các yêu cầu không đặt colorRgb hoặc backgroundImageFile.

backgroundImageFile

object

Tệp hình ảnh và các thông số cắt để đặt hình nền cho bộ nhớ dùng chung này. Đây là trường chỉ có thể 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ã 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 khoảng khép kín 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 bên trái của vùng cắt trong hình nền. Đây là một giá trị trong khoảng khép kín 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ù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 đã cắt trong phạm vi kín từ 0 đến 1. Giá trị này biểu thị chiều rộng của hình ảnh đã 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 trên chiều cao là 80 trê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ờ theo 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 bên trong bộ nhớ dùng chung này.

restrictions.copyRequiresWriterPermission

boolean

Liệu người đọc và người nhận xét có thể sao chép, in hoặc tải tệp xuống trong bộ nhớ dùng chung này hay không. Khi bạn đặt giới hạn này thành true, giới hạn 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

Liệu quyền truy cập vào bộ nhớ dùng chung này và các mục bên trong bộ nhớ dùng chung này có bị hạn chế đối với người dùng của 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 đè 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ị hạn chế đối với các thành viên hay không.

restrictions.adminManagedRestrictions

boolean

Liệu bạn 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 giá trị là false, 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 các phản hồi drives.list khi tham số useDomainAdminAccess được đặt 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 một bộ nhớ dùng chung theo mã.

hide

Ẩn một 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ê các 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.