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 fileId. Sử dụng phương thức files.list để truy xuất mã nhận dạng cho một tệp.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": 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)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    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,
    "time": 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
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Trường
kind

string

Chỉ có đầu ra. Xác định loại tài nguyên này. Giá trị: chuỗi cố định "drive#file".
driveId

string

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

string

Chỉ có đầu ra. Thành phần cuối cùng của fullFileExtension. Tính năng này chỉ dùng được cho các tệp có nội dung tệp nhị phân trong Google Drive.
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 này xuống hay không.
md5Checksum

string

Chỉ có đầu ra. Checksum MD5 cho nội dung của tệp. Điều này chỉ áp dụng cho các tệp có nội dung tệp nhị phân trong Google Drive.
contentHints

object

Thông tin bổ sung về nội dung của tệp. Các trường này không bao giờ được điền sẵn trong nội dung phản hồi.
contentHints.indexableText

string

Văn bản cần được lập chỉ mục cho tệp để cải thiện truy vấn fullText. Tệp này có giới hạn kích thước là 128 KB và có thể chứa các phần tử HTML.
contentHints.thumbnail

object

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

string (bytes format)

Dữ liệu hình thu nhỏ được mã hoá bằng Base64 an toàn với URL (mục 5, RFC 4648).

Chuỗi được mã hoá base64.
contentHints.thumbnail.mimeType

string

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

boolean

Liệu người dùng chỉ có quyền writer có thể sửa đổi quyền của tệp hay không. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
viewedByMe

boolean

Chỉ có đầu ra. Liệu người dùng này đã xem tệp hay chưa.
mimeType

string

Loại MIME của tệp.

Google Drive sẽ cố gắng tự động phát hiện giá trị phù hợp từ nội dung tải lên, nếu bạn không cung cấp giá trị. Bạn không thể thay đổi giá trị này trừ phi tải bản sửa đổi mới lên.

Nếu một tệp được tạo bằng loại MIME của Google Tài liệu, thì nội dung được tải lên sẽ được nhập (nếu có thể). Các định dạng nhập được hỗ trợ được xuất bản trong tài nguyên Giới thiệu.
parents[]

string

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 tạo, 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 tệp mẹ có thể phát hiện được của tệp nguồn. Yêu cầu files.update phải sử dụng các tham số addParents và removeParents để sửa đổi danh sách tệp mẹ.
shared

boolean

Chỉ có đầu ra. Tệp có được chia sẻ hay không. 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 gần đây nhất sửa đổi tệp. Trường này chỉ được điền khi người dùng đã đăng nhập thực hiện lần sửa đổi gần đây nhất.
owners[]

object (User)

Chỉ có đầu ra. Chủ sở hữu của tệp này. Chỉ một số tệp cũ nhất định 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.
headRevisionId

string

Chỉ có đầu ra. Mã của bản sửa đổi đầu của tệp. Tính năng này hiện chỉ có trên các tệp có nội dung tệp nhị phân trong Google Drive.
sharingUser

object (User)

Chỉ có đầu ra. Người dùng đã chia sẻ tệp với người dùng yêu cầu (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. Tính năng này chỉ dùng được cho các tệp có nội dung tệp nhị phân trong Google Drive.
size

string (int64 format)

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

boolean

Không dùng nữa: Hãy sử dụng copyRequiresWriterPermission.
permissions[]

object (Permission)

Chỉ có đầu ra. Danh sách đầy đủ các quyền đối với tệp. Lựa chọn này chỉ xuất hiện nếu người dùng yêu cầu có thể chia sẻ tệp. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
hasThumbnail

boolean

Chỉ có đầu ra. Liệu 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.
spaces[]

string

Chỉ có đầu ra. Danh sách các không gian chứa tệp. Các giá trị hiện được hỗ trợ là "drive", "appDataFolder" và "photos".
folderColorRgb

string

Màu của thư mục hoặc lối tắt đến thư mục dưới dạng chuỗi thập lục phân RGB. Các màu được hỗ trợ được xuất bản trong trường folderColorPalette của tài nguyên Giới thiệu.

Nếu bạn chỉ định một màu không được hỗ trợ, thì màu gần nhất trong bảng màu sẽ được sử dụng.
id

string

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

string

Tên tệp. Mã này không nhất thiết phải là duy nhất trong một thư mục. Xin lưu ý rằng đối với các mục không thể thay đổi như thư mục cấp cao nhất của bộ nhớ dùng chung, thư mục gốc của Drive của tôi và thư mục Dữ liệu ứng dụng, tên sẽ không thay đổi.
description

string

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

boolean

Liệu người dùng có gắn dấu sao cho tệp hay không.
trashed

boolean

Liệu tệp đã bị chuyển vào thùng rác hay chưa, một cách rõ ràng hoặc từ một thư mục mẹ đã chuyển vào thùng rác. Chỉ chủ sở hữu mới có thể chuyển tệp vào thùng rác và người dùng khác không thể xem các tệp trong thùng rác của chủ sở hữu.
explicitlyTrashed

boolean

Chỉ có đầu ra. Liệu tệp đã được chuyển vào thùng rác một cách rõ ràng hay không, thay vì được chuyển vào thùng rác đệ quy từ một thư mục mẹ.
createdTime

string

Thời gian tạo tệp (ngày-giờ theo RFC 3339).
modifiedTime

string

Lần gần đây nhất bất kỳ ai sửa đổi tệp (ngày-giờ theo RFC 3339).

Xin lưu ý rằng việc đặt modifiedTime cũng sẽ cập nhật modifiedByMeTime cho người dùng.
modifiedByMeTime

string

Chỉ có đầu ra. Lần gần đây nhất người dùng sửa đổi tệp (ngày-giờ theo RFC 3339).
viewedByMeTime

string

Lần gần nhất người dùng xem tệp (ngày-giờ theo RFC 3339).
sharedWithMeTime

string

Chỉ có đầu ra. Thời gian chia sẻ tệp với người dùng (nếu có) (ngày-giờ theo RFC 3339).
quotaBytesUsed

string (int64 format)

Chỉ có đầu ra. Số byte hạn mức bộ nhớ mà tệp đã sử dụng. Trong đó có bản sửa đổi đầu cũng như các bản sửa đổi trước đó đã bật keepForever.
version

string (int64 format)

Chỉ có đầu ra. Số phiên bản tăng dần 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 không nhìn thấy.
originalFilename

string

Tên tệp gốc của nội dung đã tải lên (nếu có) hoặc giá trị gốc của trường name. Tính năng này chỉ dùng được cho các tệp có nội dung tệp nhị phân trong Google Drive.
ownedByMe

boolean

Chỉ có đầu ra. Liệu người dùng có sở hữu tệp đó hay không. Không được điền sẵn cho các mục trong bộ nhớ dùng chung.
fullFileExtension

string

Chỉ có đầu ra. Đuôi tệp đầy đủ được trích xuất từ trường name. Có thể chứa nhiều đuôi tệp nối tiếp nhau, chẳng hạn như "tar.gz". Tính năng này chỉ dùng được cho các tệp có nội dung tệp nhị phân trong Google Drive.

Trường này được tự động cập nhật khi trường name thay đổi, tuy nhiên, trường này sẽ không bị xoá nếu tên mới không chứa đuôi hợp lệ.
properties

map (key: string, value: value (Value format))

Một tập hợp các cặp khoá-giá trị tuỳ ý mà tất cả ứng dụng đều có thể thấy.

Các mục có giá trị rỗng sẽ bị xoá trong yêu cầu cập nhật và sao chép.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
appProperties

map (key: string, value: value (Value format))

Một tập hợp các cặp khoá-giá trị tuỳ ý chỉ dành riêng cho ứng dụng yêu cầu.

Các mục có giá trị rỗng sẽ bị xoá trong yêu cầu cập nhật và sao chép.

Bạn chỉ có thể truy xuất các thuộc tính này bằng một yêu cầu đã xác thực. Yêu cầu đã xác thực sử dụng mã truy cập được lấy bằng mã ứng dụng khách OAuth 2. Bạn không thể sử dụng khoá API để truy xuất các tài sản riêng tư.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
isAppAuthorized

boolean

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

string

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

object

Chỉ có đầu ra. Các quyền 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.canChangeViewersCanCopyContent
(deprecated)

boolean

Không dùng nữa: Chỉ có đầu ra.
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à sai 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 chứa tệp này 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 con không phải thư mục của mục này hay không, hoặc chính mục này nếu mục này 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. Liệu 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. Liệu người dùng hiện tại có thể xoá 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 sử dụng canDeleteChildren hoặc canTrashChildren.
capabilities.canRename

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Không dùng nữa: Chỉ có đầu ra. 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

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

boolean

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

boolean

Chỉ có đầu ra. Người dùng hiện tại có thể xoá thư mục con của thư mục này hay không. Giá trị này là sai 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

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

boolean

Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng canMoveChildrenWithinDrive.
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 của thư mục này vào thùng rác hay không. Giá trị này là sai 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 ổ này bằng cách thay đổi 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 đang được thêm.
capabilities.canAddMyDriveParent

boolean

Chỉ có đầu ra. Liệu người dùng hiện tại có thể thêm mục mẹ cho mục mà không cần xoá mục mẹ 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 mục mẹ khỏi mục mà không cần thêm một mục 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. Người dùng hiện tại có thể di chuyển mục này trong ổ này 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 đang được thêm và phần tử mẹ đang được 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ẻ của tệp này hay không.
capabilities.canMoveChildrenWithinDrive

boolean

Chỉ có đầu ra. 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 ổ này hay không. Giá trị này là sai khi mục không phải là thư mục. Xin lưu ý rằng yêu cầu di chuyển thư mục 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 thư mục 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 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 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à sai 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ác nhận 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 quy định hạn chế nội dung trên tệp bị hạn chế bởi trình chỉnh sửa 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 quy định 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 người dùng hiện tại có thể xoá giới hạn nội dung trên tệp hay không.
capabilities.canDisableInheritedPermissions

boolean

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

boolean

Liệu 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 trên 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ì 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.
thumbnailVersion

string (int64 format)

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

string

Chỉ có đầu ra. Thời gian mục đó được chuyển vào thùng rác (ngày-giờ theo RFC 3339). Chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
modifiedByMe

boolean

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

string

Chỉ xuất. files.list của mã nhận dạng quyền cho người dùng có quyền truy cập vào tệp này.
imageMediaMetadata

object

Chỉ có đầu ra. Siêu dữ liệu bổ sung về nội dung nghe nhìn hình ảnh (nếu có).
imageMediaMetadata.flashUsed

boolean

Chỉ có đầu ra. Liệu đèn flash có được dùng để tạo ảnh hay không.
imageMediaMetadata.meteringMode

string

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

string

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

string

Chỉ có đầu ra. Chế độ phơi sáng dùng để tạo ảnh.
imageMediaMetadata.colorSpace

string

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

string

Chỉ có đầu ra. Chế độ cân bằng trắng 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. Vĩ độ đượ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 gốc của hình ảnh.
imageMediaMetadata.time

string

Chỉ có đầu ra. Ngày và giờ chụp ảnh (EXIF DateTime).
imageMediaMetadata.cameraMake

string

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

string

Chỉ có đầu ra. Mẫu máy ảnh dùng để tạo ả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. Độ mở được dùng để tạo ảnh (số f).
imageMediaMetadata.focalLength

number

Chỉ có đầu ra. Độ dài tiêu cự dùng để tạo ảnh, tính bằng milimét.
imageMediaMetadata.isoSpeed

integer

Chỉ có đầu ra. Tốc độ ISO dùng để tạo ảnh.
imageMediaMetadata.exposureBias

number

Chỉ có đầu ra. Độ lệch 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ự dùng để tạo ảnh (giá trị APEX).
imageMediaMetadata.subjectDistance

integer

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

string

Chỉ có đầu ra. Ống kính dùng để tạo ảnh.
videoMediaMetadata

object

Chỉ có đầu ra. Siêu dữ liệu bổ sung về nội dung nghe nhìn dạng video. Tính năng này có thể chưa dùng được ngay sau khi tải lên.
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 trên các yêu cầu files.create.
shortcutDetails.targetId

string

Mã của tệp mà lối tắt này trỏ đến. Chỉ có thể đặt trên các yêu cầu files.create.
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à bản tổng quan nhanh về loại MIME của mục tiêu, được ghi lại khi tạo lối tắt.
shortcutDetails.targetResourceKey

string

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

object (ContentRestriction)

Các quy định hạn chế đối với việc truy cập vào nội dung của tệp. Chỉ được điền sẵn nếu có quy định hạn chế như vậy.
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 để cập nhật bảo mật hay không.
linkShareMetadata.securityUpdateEnabled

boolean

Chỉ có đầu ra. Liệu 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 trong tham số includeLabels. Theo mặc định, hệ thống sẽ không trả về nhãn nào.
sha1Checksum

string

Chỉ có đầu ra. Checksum SHA1 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. Checksum 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 được bật theo mặc định.

ContentRestriction

Hạn chế 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)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Trường
readOnly

boolean

Nội dung của tệp có ở chế độ chỉ có thể đọc hay không. Nếu một tệp chỉ có thể đọc, thì bạn không thể thêm bản sửa đổi 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 nội dung của tệp bị hạn chế. Giá trị này chỉ có thể thay đổi trên các yêu cầu cũng đặt readOnly=true.
type

string

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

object (User)

Chỉ có đầu ra. Người dùng đã đặt giới hạn nội dung. Chỉ được điền sẵn nếu readOnly là true.
restrictionTime

string

Chỉ có đầu ra. Thời điểm đặt giới hạn 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á quy định hạn chế nội dung hay không. Đối với các tệp trong bộ nhớ dùng chung, bất kỳ người dùng nào có quyền organizer đều có thể sửa đổi hoặc xoá quy định hạn chế nội dung này.
systemRestricted

boolean

Chỉ có đầu ra. Liệu 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 quy định hạn chế về nội dung bị hạn chế của hệ thống.

Phương thức

copy

 Tạo bản sao của một tệp và áp dụng mọi bản cập nhật được yêu cầu bằng ngữ nghĩa của bản vá.

create

Tạo tệp mới.

delete

 Xoá vĩnh viễn 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.

download

 Tải nội dung của một tệp xuống.

emptyTrash

 Xoá vĩnh viễn tất cả tệp trong thùng rác của người dùng.

export

 Xuất tài liệu 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ã tệp có thể được cung cấp trong các yêu cầu tạo hoặc sao chép.

get

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

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 tập hợp nhãn được áp dụng cho một tệp.

update

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

watch

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