REST Resource: files

Tài nguyên: Tệp

Siêu dữ liệu của một tệp.

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

Biểu diễn dưới dạng JSON 
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Trường
ownerNames[]

string

Chỉ có đầu ra. Tên của (các) chủ sở hữu tệp này. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
parents[]

object (ParentReference)

Mã của thư mục mẹ chứa tệp.

Một tệp chỉ có thể có một thư mục mẹ; không hỗ trợ việc chỉ định nhiều thư mục mẹ.

Nếu không được chỉ định trong yêu cầu chèn, tệp sẽ được đặt trực tiếp vào thư mục Drive của tôi của người dùng. Nếu không được chỉ định trong yêu cầu sao chép, tệp sẽ kế thừa mọi thư mục mẹ có thể phát hiện của tệp nguồn. Các yêu cầu files.update phải sử dụng các tham số addParents và removeParents để sửa đổi danh sách thư mục mẹ.
owners[]

object (User)

Chỉ có đầu ra. Chủ sở hữu của tệp này. Chỉ một số tệp cũ mới có thể có nhiều chủ sở hữu. Trường này không được điền sẵn cho các mục trong bộ nhớ dùng chung.
properties[]

object (Property)

Danh sách các cơ sở lưu trú.
permissions[]

object (Permission)

Chỉ có đầu ra. Danh sách quyền của người dùng có quyền truy cập vào tệp này. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
spaces[]

string

Chỉ có đầu ra. Danh sách các không gian chứa tệp đó. Giá trị được hỗ trợ là drive, appDataFolder và photos.
permissionIds[]

string

Chỉ đầu ra. files.list của mã nhận dạng quyền cho những người dùng có quyền truy cập vào tệp này.
contentRestrictions[]

object (ContentRestriction)

Các hạn chế khi truy cập vào nội dung của tệp. Chỉ được điền sẵn nếu có hạn chế như vậy.
kind

string

Chỉ có đầu ra. Loại tệp. Trạng thái này luôn là drive#file.
userPermission

object (Permission)

Chỉ có đầu ra. Quyền của người dùng đã xác thực đối với tệp này.
fileExtension

string

Chỉ có đầu ra. Thành phần cuối cùng của fullFileExtension với văn bản ở cuối không xuất hiện trong phần mở rộng đã bị xoá. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
md5Checksum

string

Chỉ có đầu ra. Một mã kiểm tra MD5 cho nội dung của tệp này. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
lastModifyingUserName

string

Chỉ có đầu ra. Tên của người dùng đã sửa đổi tệp này lần gần nhất.
editable
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng capabilities/canEdit.
writersCanShare

boolean

Liệu người viết có thể chia sẻ tài liệu với người dùng khác hay không. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
downloadUrl

string

Chỉ có đầu ra. URL tải xuống có thời hạn ngắn cho tệp. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Google Tài liệu hoặc tệp lối tắt.
mimeType

string

Loại MIME của tệp. Bạn chỉ có thể thay đổi thông tin này khi cập nhật nội dung mới. Bạn có thể để trống trường này và loại MIME sẽ được xác định từ loại MIME của nội dung đã tải lên.
driveId

string

Chỉ có đầu ra. Mã nhận dạng của bộ nhớ dùng chung nơi tệp cư trú. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
appDataContents

boolean

Chỉ có đầu ra. Tệp này có nằm trong thư mục Dữ liệu ứng dụng hay không.
shared

boolean

Chỉ có đầu ra. Tệp đã được chia sẻ hay chưa. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
lastModifyingUser

object (User)

Chỉ có đầu ra. Người dùng sửa đổi tệp này lần gần nhất. Trường này chỉ được điền sẵn khi người dùng đã đăng nhập thực hiện lần sửa đổi gần đây nhất.
headRevisionId

string

Chỉ có đầu ra. Mã nhận dạng của phiên bản đầu của tệp. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
copyable
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng capabilities/canCopy.
etag

string

Chỉ có đầu ra. ETag của tệp.
sharingUser

object (User)

Chỉ có đầu ra. Người dùng đã chia sẻ mục với người dùng hiện tại (nếu có).
webContentLink

string

Chỉ có đầu ra. Đường liên kết để tải nội dung của tệp xuống trong trình duyệt bằng cách sử dụng phương thức xác thực dựa trên cookie. Trong trường hợp nội dung được chia sẻ công khai, người dùng có thể tải nội dung xuống mà không cần thông tin đăng nhập.
fileSize

string (int64 format)

Chỉ có đầu ra. Kích thước tính bằng byte của các blob và tệp trình chỉnh sửa của bên thứ nhất. Không được điền sẵn cho những tệp không có kích thước, chẳng hạn như lối tắt và thư mục.
copyRequiresWriterPermission

boolean

Có nên tắt các tuỳ chọn sao chép, in hoặc tải tệp này xuống đối với người đọc và người nhận xét hay không.
hasThumbnail

boolean

Chỉ có đầu ra. Tệp này có hình thu nhỏ hay không. Điều này không cho biết liệu ứng dụng yêu cầu có quyền truy cập vào hình thu nhỏ hay không. Để kiểm tra quyền truy cập, hãy tìm trường thumbnailLink.
folderColorRgb

string

Màu thư mục dưới dạng chuỗi thập lục phân RGB nếu tệp là một thư mục hoặc lối tắt đến một thư mục. Danh sách màu được hỗ trợ có trong trường folderColorPalette của tài nguyên About. Nếu bạn chỉ định một màu không được hỗ trợ, màu đó sẽ được thay đổi thành màu gần nhất trong bảng màu.
id

string

Mã nhận dạng của tệp.
title

string

Tiêu đề của tệp này. Xin lưu ý rằng đối với các mục không thể thay đổi (chẳng hạn như thư mục cấp cao nhất của bộ nhớ dùng chung, thư mục gốc Drive của tôi và thư mục Dữ liệu ứng dụng), tiêu đề sẽ không đổi.
description

string

Nội dung mô tả ngắn về tệp.
labels

object

Một nhóm nhãn cho tệp.
labels.viewed

boolean

Người dùng này đã xem tệp này hay chưa.
labels.restricted
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng copyRequiresWriterPermission.
labels.starred

boolean

Người dùng có gắn dấu sao cho tệp này hay không.
labels.hidden
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa.
labels.trashed

boolean

Tệp này đã được chuyển vào thùng rác hay chưa. Nhãn này áp dụng cho tất cả người dùng truy cập vào tệp; tuy nhiên, chỉ chủ sở hữu mới được phép xem và khôi phục tệp.
labels.modified

boolean

Chỉ có đầu ra. Liệu người dùng này có sửa đổi tệp hay không.
explicitlyTrashed

boolean

Chỉ có đầu ra. Liệu tệp này có bị xoá rõ ràng hay không, thay vì bị xoá đệ quy.
createdDate

string

Chỉ có đầu ra. Thời gian tạo cho tệp này (dấu thời gian RFC 3339 được định dạng).
modifiedDate

string

Lần gần đây nhất tệp này được sửa đổi bởi bất kỳ ai (dấu thời gian theo định dạng RFC 3339). Bạn chỉ có thể thay đổi thông tin này khi cập nhật nếu đặt tham số setModifiedDate.
modifiedByMeDate

string

Chỉ có đầu ra. Lần gần đây nhất người dùng sửa đổi tệp này (dấu thời gian theo định dạng RFC 3339). Xin lưu ý rằng việc đặt modifiedDate cũng sẽ cập nhật ngày modifiedByMe cho người dùng đã đặt ngày.
lastViewedByMeDate

string

Lần gần đây nhất người dùng xem tệp này (dấu thời gian RFC 3339 được định dạng).
markedViewedByMeDate
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa.
sharedWithMeDate

string

Chỉ có đầu ra. Thời gian tệp này được chia sẻ với người dùng (dấu thời gian theo định dạng RFC 3339).
quotaBytesUsed

string (int64 format)

Chỉ có đầu ra. Số lượng hạn mức byte mà tệp này sử dụng.
version

string (int64 format)

Chỉ có đầu ra. Số phiên bản tăng dần đơn điệu cho tệp. Điều này phản ánh mọi thay đổi đối với tệp trên máy chủ, ngay cả những thay đổi mà người dùng yêu cầu không thấy được.
indexableText

object

Thuộc tính văn bản có thể lập chỉ mục cho tệp (chỉ có thể ghi)
indexableText.text

string

Văn bản sẽ được lập chỉ mục cho tệp này.
originalFilename

string

Tên tệp gốc của nội dung được tải lên (nếu có), nếu không thì là giá trị ban đầu của trường title. Tính năng này chỉ dùng được cho các tệp có nội dung nhị phân trong Google Drive.
ownedByMe

boolean

Chỉ có đầu ra. Tệp có thuộc sở hữu của người dùng hiện tại hay không. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
canComment
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng capabilities/canComment.
shareable
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng capabilities/canShare.
fullFileExtension

string

Chỉ có đầu ra. Đuôi tệp đầy đủ; được trích xuất từ tiêu đề. Có thể chứa nhiều phần mở rộng được nối, chẳng hạn như "tar.gz". Việc xoá phần mở rộng khỏi tiêu đề không xoá trường này; tuy nhiên, việc thay đổi phần mở rộng trong tiêu đề sẽ cập nhật trường này. Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
isAppAuthorized

boolean

Chỉ có đầu ra. Liệu tệp đó có được ứng dụng yêu cầu tạo hoặc mở hay không.
teamDriveId
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng driveId.
capabilities

object

Chỉ có đầu ra. Các chức năng mà người dùng hiện tại có trên tệp này. Mỗi chức năng tương ứng với một hành động chi tiết mà người dùng có thể thực hiện.
capabilities.canChangeRestrictedDownload
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa.
capabilities.canMoveChildrenOutOfDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể di chuyển các thư mục con của thư mục này ra khỏi bộ nhớ dùng chung hay không. Giá trị này là false khi mục không phải là thư mục. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
capabilities.canReadDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể đọc bộ nhớ dùng chung mà tệp này thuộc về hay không. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
capabilities.canEdit

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể chỉnh sửa tệp này hay không. Các yếu tố khác có thể giới hạn loại thay đổi mà người dùng có thể thực hiện đối với một tệp. Ví dụ: xem canChangeCopyRequiresWriterPermission hoặc canModifyContent.
capabilities.canCopy

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể sao chép tệp này hay không. Đối với một mục trong bộ nhớ dùng chung, liệu người dùng hiện tại có thể sao chép các mục không phải là thư mục con của mục này hay chính mục này nếu đó không phải là thư mục.
capabilities.canComment

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể nhận xét về tệp này hay không.
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 thư mục này hay không. Giá trị này luôn là false khi mục không phải là thư mục.
capabilities.canDelete

boolean

Chỉ có đầu ra. Xem người dùng hiện tại có thể xoá tệp này hay không.
capabilities.canDownload

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể tải tệp này xuống 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 của thư mục này hay không. Giá trị này luôn là false khi mục không phải là thư mục.
capabilities.canRemoveChildren

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể xoá các thư mục con khỏi thư mục này hay không. Giá trị này luôn là false khi mục không phải là thư mục. Đối với thư mục trong bộ nhớ dùng chung, hãy dùng biểu tượng canDeleteChildren hoặc canTrashChildren.
capabilities.canRename

boolean

Chỉ có đầu ra. Xem người dùng hiện tại có thể đổi tên tệp này hay không.
capabilities.canTrash

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể chuyển tệp này vào thùng rác 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 tệp này hay không. Đối với một mục trong bộ nhớ dùng chung, liệu các bản sửa đổi của những mục không phải là thư mục con của mục này hay chính mục này (nếu không phải là thư mục) có thể được đọc hay không.
capabilities.canReadTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canReadDrive.
capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveItemWithinDrive hoặc canMoveItemOutOfDrive.
capabilities.canChangeCopyRequiresWriterPermission

boolean

Chỉ có đầu ra. Xem người dùng hiện tại có thể thay đổi chế độ hạn chế copyRequiresWriterPermission của tệp này hay không.
capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveItemOutOfDrive.
capabilities.canUntrash

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể khôi phục tệp này từ thùng rác hay không.
capabilities.canModifyContent

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể sửa đổi nội dung của tệp này hay không.
capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveItemWithinDrive.
capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveItemOutOfDrive.
capabilities.canDeleteChildren

boolean

Chỉ có đầu ra. Xem người dùng hiện tại có thể xoá các thư mục con của thư mục này hay không. Giá trị này là false khi mục không phải là thư mục. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveChildrenOutOfDrive.
capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng canMoveChildrenWithinDrive.
capabilities.canTrashChildren

boolean

Chỉ có đầu ra. Xem người dùng hiện tại có thể xoá các mục con của thư mục này hay không. Giá trị này là false khi mục không phải là thư mục. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
capabilities.canMoveItemOutOfDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể di chuyển mục này ra khỏi ổ đĩa này bằng cách thay đổi thư mục mẹ hay không. Xin lưu ý rằng yêu cầu thay đổi phần tử mẹ của mục vẫn có thể không thành công, tuỳ thuộc vào phần tử mẹ mới mà bạn đang thêm.
capabilities.canAddMyDriveParent

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm một mục chính cho mục mà không cần xoá mục chính hiện có trong cùng một yêu cầu hay không. Không được điền sẵn cho các tệp trong bộ nhớ dùng chung.
capabilities.canRemoveMyDriveParent

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể xoá một người đóng vai trò là cha mẹ khỏi mục mà không cần thêm một người đóng vai trò là cha mẹ khác trong cùng một yêu cầu hay không. Không được điền sẵn cho các tệp trong bộ nhớ dùng chung.
capabilities.canMoveItemWithinDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể di chuyển mục này trong ổ đĩa này hay không. Xin lưu ý rằng yêu cầu thay đổi mục mẹ của mặt hàng vẫn có thể không thành công, tuỳ thuộc vào mục mẹ mới được thêm và mục mẹ bị xoá.
capabilities.canShare

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể sửa đổi chế độ cài đặt chia sẻ cho tệp này hay không.
capabilities.canMoveChildrenWithinDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể di chuyển các thư mục con của thư mục này trong ổ đĩa này hay không. Giá trị này là false khi mục không phải là thư mục. Xin lưu ý rằng yêu cầu di chuyển tệp con vẫn có thể không thành công, tuỳ thuộc vào quyền truy cập của người dùng hiện tại vào tệp con và thư mục đích.
capabilities.canModifyContentRestriction
(deprecated)

boolean

Không dùng nữa: Chỉ có đầu ra. Sử dụng một trong các giá trị canModifyEditorContentRestriction, canModifyOwnerContentRestriction hoặc canRemoveContentRestriction.
capabilities.canAddFolderFromAnotherDrive

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm một thư mục từ một bộ nhớ khác (bộ nhớ dùng chung khác hoặc Drive của tôi) vào thư mục này hay không. Giá trị này là false khi mục không phải là thư mục. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
capabilities.canChangeSecurityUpdateEnabled

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thay đổi trường securityUpdateEnabled trên siêu dữ liệu chia sẻ đường liên kết hay không.
capabilities.canAcceptOwnership

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có phải là chủ sở hữu đang chờ xử lý của tệp hay không. Không được điền sẵn cho các tệp trong bộ nhớ dùng chung.
capabilities.canReadLabels

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể đọc nhãn trên tệp hay không.
capabilities.canModifyLabels

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể sửa đổi nhãn trên tệp hay không.
capabilities.canModifyEditorContentRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm hoặc sửa đổi các chế độ hạn chế nội dung trên tệp mà chỉ có người chỉnh sửa mới có thể thực hiện hay không.
capabilities.canModifyOwnerContentRestriction

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm hoặc sửa đổi các chế độ hạn chế nội dung do chủ sở hữu hạn chế hay không.
capabilities.canRemoveContentRestriction

boolean

Chỉ có đầu ra. Liệu có hạn chế về nội dung đối với tệp mà người dùng hiện tại có thể xoá hay không.
capabilities.canDisableInheritedPermissions

boolean

Chỉ có đầu ra. Người dùng có thể tắt các quyền được kế thừa hay không.
capabilities.canEnableInheritedPermissions

boolean

Chỉ có đầu ra. Người dùng có thể bật lại các quyền được kế thừa hay không.
hasAugmentedPermissions

boolean

Chỉ có đầu ra. Liệu có quyền trực tiếp đối với tệp này hay không. Trường này chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
trashingUser

object (User)

Chỉ có đầu ra. Nếu tệp đã bị chuyển vào thùng rác một cách rõ ràng, thì đó là người dùng đã chuyển tệp đó vào thùng rác. Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
canReadRevisions
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng capabilities/canReadRevisions.
thumbnailVersion

string (int64 format)

Chỉ có đầu ra. Phiên bản hình thu nhỏ để sử dụng trong quá trình vô hiệu hoá bộ nhớ đệm hình thu nhỏ.
trashedDate

string

Chỉ có đầu ra. Thời gian xoá mục vào thùng rác (dấu thời gian được định dạng theo RFC 3339). Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
thumbnail

object

Hình thu nhỏ của tệp. Hình thu nhỏ này sẽ chỉ được dùng nếu không tạo được hình thu nhỏ chuẩn.
thumbnail.image

string (bytes format)

Các byte được mã hoá Base64 an toàn cho URL của hình ảnh thu nhỏ. Nội dung này phải tuân thủ mục 5 của RFC 4648.

Một chuỗi được mã hoá base64.
thumbnail.mimeType

string

Loại MIME của hình thu nhỏ.
imageMediaMetadata

object

Chỉ có đầu ra. Siêu dữ liệu về phương tiện hình ảnh. Tham số này chỉ xuất hiện cho các loại hình ảnh và nội dung của tham số này sẽ phụ thuộc vào những gì có thể phân tích cú pháp từ nội dung hình ảnh.
imageMediaMetadata.flashUsed

boolean

Chỉ có đầu ra. Đèn flash có được dùng để chụp ảnh hay không.
imageMediaMetadata.meteringMode

string

Chỉ có đầu ra. Chế độ đo sáng được dùng để tạo ảnh.
imageMediaMetadata.sensor

string

Chỉ có đầu ra. Loại cảm biến được dùng để tạo ảnh.
imageMediaMetadata.exposureMode

string

Chỉ có đầu ra. Chế độ phơi sáng được dùng để chụp ảnh.
imageMediaMetadata.colorSpace

string

Chỉ có đầu ra. Hệ màu của bức ảnh.
imageMediaMetadata.whiteBalance

string

Chỉ có đầu ra. Chế độ cân bằng trắng được dùng để tạo ảnh.
imageMediaMetadata.width

integer

Chỉ có đầu ra. Chiều rộng của hình ảnh, tính bằng pixel.
imageMediaMetadata.height

integer

Chỉ có đầu ra. Chiều cao của hình ảnh tính bằng pixel.
imageMediaMetadata.location

object

Chỉ có đầu ra. Thông tin vị trí địa lý được lưu trữ trong hình ảnh.
imageMediaMetadata.location.latitude

number

Chỉ có đầu ra. Vĩ độ được lưu trữ trong hình ảnh.
imageMediaMetadata.location.longitude

number

Chỉ có đầu ra. Kinh độ được lưu trữ trong hình ảnh.
imageMediaMetadata.location.altitude

number

Chỉ có đầu ra. Độ cao được lưu trữ trong hình ảnh.
imageMediaMetadata.rotation

integer

Chỉ có đầu ra. Số lần xoay 90 độ theo chiều kim đồng hồ được áp dụng từ hướng ban đầu của hình ảnh.
imageMediaMetadata.date

string

Chỉ có đầu ra. Ngày và giờ chụp ảnh (dấu thời gian ở định dạng EXIF).
imageMediaMetadata.cameraMake

string

Chỉ có đầu ra. Hãng sản xuất camera dùng để tạo ảnh.
imageMediaMetadata.cameraModel

string

Chỉ có đầu ra. Mẫu camera dùng để tạo bức ảnh.
imageMediaMetadata.exposureTime

number

Chỉ có đầu ra. Thời lượng phơi sáng, tính bằng giây.
imageMediaMetadata.aperture

number

Chỉ có đầu ra. Khẩu độ được dùng để tạo ảnh (số f).
imageMediaMetadata.focalLength

number

Chỉ có đầu ra. Tiêu cự dùng để tạo ảnh, tính bằng milimet.
imageMediaMetadata.isoSpeed

integer

Chỉ có đầu ra. Tốc độ ISO được dùng để chụp ảnh.
imageMediaMetadata.exposureBias

number

Chỉ có đầu ra. Độ bù phơi sáng của ảnh (giá trị APEX).
imageMediaMetadata.maxApertureValue

number

Chỉ có đầu ra. Số f nhỏ nhất của ống kính ở tiêu cự được dùng để tạo ảnh (giá trị APEX).
imageMediaMetadata.subjectDistance

integer

Chỉ có đầu ra. Khoảng cách đến đối tượng trong ảnh, tính bằng mét.
imageMediaMetadata.lens

string

Chỉ có đầu ra. Ống kính dùng để chụp ảnh.
videoMediaMetadata

object

Chỉ có đầu ra. Siêu dữ liệu về nội dung video. Chỉ có loại video mới có thông tin này.
videoMediaMetadata.width

integer

Chỉ có đầu ra. Chiều rộng của video tính bằng pixel.
videoMediaMetadata.height

integer

Chỉ có đầu ra. Chiều cao của video tính bằng pixel.
videoMediaMetadata.durationMillis

string (int64 format)

Chỉ có đầu ra. Thời lượng của video tính bằng mili giây.
shortcutDetails

object

Thông tin chi tiết về tệp lối tắt. Chỉ được điền sẵn cho các tệp lối tắt có trường mimeType được đặt thành application/vnd.google-apps.shortcut. Chỉ có thể đặt cho các yêu cầu files.insert.
shortcutDetails.targetId

string

Mã của tệp mà lối tắt này trỏ đến. Chỉ có thể đặt cho các yêu cầu files.insert.
shortcutDetails.targetMimeType

string

Chỉ có đầu ra. Loại MIME của tệp mà lối tắt này trỏ đến. Giá trị của trường này là ảnh chụp nhanh loại MIME của mục tiêu, được ghi lại khi lối tắt được tạo.
shortcutDetails.targetResourceKey

string

Chỉ có đầu ra. ResourceKey cho tệp đích.
resourceKey

string

Chỉ có đầu ra. Khoá cần thiết để truy cập vào mục thông qua đường liên kết được chia sẻ.
linkShareMetadata.securityUpdateEligible

boolean

Chỉ có đầu ra. Liệu tệp có đủ điều kiện nhận bản cập nhật bảo mật hay không.
linkShareMetadata.securityUpdateEnabled

boolean

Chỉ có đầu ra. Bản cập nhật bảo mật có được bật cho tệp này hay không.
labelInfo

object

Chỉ có đầu ra. Thông tin tổng quan về các nhãn trên tệp.
labelInfo.labels[]

object (Label)

Chỉ có đầu ra. Tập hợp nhãn trên tệp theo yêu cầu của mã nhận dạng nhãn trong tham số includeLabels. Theo mặc định, không có nhãn nào được trả về.
sha1Checksum

string

Chỉ có đầu ra. Tổng kiểm tra SHA1 được liên kết với tệp này (nếu có). Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
sha256Checksum

string

Chỉ có đầu ra. Tổng kiểm tra SHA256 liên kết với tệp này (nếu có). Trường này chỉ được điền sẵn cho các tệp có nội dung được lưu trữ trong Google Drive; trường này không được điền sẵn cho Trình chỉnh sửa Tài liệu hoặc tệp lối tắt.
inheritedPermissionsDisabled

boolean

Liệu tệp này có bị vô hiệu hoá các quyền được kế thừa hay không. Các quyền được kế thừa sẽ được bật theo mặc định.

ContentRestriction

Một hạn chế đối với quyền truy cập vào nội dung của tệp.

Biểu diễn dưới dạng JSON 
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Trường
readOnly

boolean

Nội dung của tệp có ở chế độ chỉ đọc hay không. Nếu một tệp ở chế độ chỉ đọc, thì bạn không thể thêm phiên bản mới của tệp, không thể thêm hoặc sửa đổi nhận xét và không thể sửa đổi tiêu đề của tệp.
reason

string

Lý do khiến nội dung của tệp bị hạn chế. Bạn chỉ có thể thay đổi giá trị này trong các yêu cầu cũng đặt readOnly=true.
type

string

Chỉ có đầu ra. Loại hạn chế nội dung. Hiện tại, giá trị có thể có duy nhất là globalContentRestriction.
restrictingUser

object (User)

Chỉ có đầu ra. Người dùng đã thiết lập chế độ hạn chế nội dung. Chỉ được điền sẵn nếu readOnly là true.
restrictionDate

string

Chỉ có đầu ra. Thời điểm thiết lập quy định hạn chế nội dung (dấu thời gian theo định dạng RFC 3339). Chỉ được điền sẵn nếu readOnly là true.
ownerRestricted

boolean

Liệu chỉ người dùng sở hữu tệp mới có thể sửa đổi hoặc xoá chế độ hạn chế nội dung hay không. Đối với các tệp trong bộ nhớ dùng chung, mọi người dùng có quyền organizer đều có thể sửa đổi hoặc xoá chế độ hạn chế nội dung này.
systemRestricted

boolean

Chỉ có đầu ra. Hệ thống có áp dụng quy định hạn chế về nội dung hay không, ví dụ: do chữ ký điện tử. Người dùng không thể sửa đổi hoặc xoá các chế độ hạn chế nội dung do hệ thống đặt.

Phương thức

copy

 Tạo bản sao của tệp đã chỉ định.

delete

 Xoá vĩnh viễn một tệp thuộc quyền sở hữu của người dùng mà không chuyển tệp đó vào thùng rác.

emptyTrash

 Xoá vĩnh viễn tất cả tệp đã bị xoá của người dùng.

export

 Xuất một tài liệu trên Google Workspace sang loại MIME được yêu cầu và trả về nội dung byte đã xuất.

generateIds

 Tạo một tập hợp mã nhận dạng tệp có thể được cung cấp trong các yêu cầu chèn hoặc sao chép.

get

Lấy siêu dữ liệu hoặc nội dung của một tệp theo mã nhận dạng.

insert

Chèn một tệp mới.

list

Liệt kê các tệp của người dùng.

listLabels

 Liệt kê các nhãn trên một tệp.

modifyLabels

 Sửa đổi bộ nhãn được áp dụng cho một tệp.

patch

 Cập nhật siêu dữ liệu và/hoặc nội dung của một tệp.

touch

 Đặt thời gian cập nhật của tệp thành thời gian hiện tại của máy chủ.

trash

 Chuyển một tệp vào thùng rác.

untrash

 Khôi phục tệp trong thùng rác.

update

Cập nhật siêu dữ liệu và/hoặc nội dung của một tệp.

watch

 Đăng ký nhận thông báo khi có thay đổi đối với một tệp.