Files

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

如需了解此资源的方法列表，请参阅本页结尾部分。

资源表示形式

文件的元数据。

{
  "kind": "drive#file",
  "id": string,
  "etag": etag,
  "selfLink": string,
  "webContentLink": string,
  "webViewLink": string,
  "alternateLink": string,
  "embedLink": string,
  "openWithLinks": {
    (key): string
  },
  "defaultOpenWithLink": string,
  "iconLink": string,
  "hasThumbnail": boolean,
  "thumbnailLink": string,
  "thumbnailVersion": long,
  "thumbnail": {
    "image": bytes,
    "mimeType": string
  },
  "title": string,
  "mimeType": string,
  "description": string,
  "labels": {
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "restricted": boolean,
    "viewed": boolean,
    "modified": boolean
  },
  "copyRequiresWriterPermission": boolean,
  "createdDate": datetime,
  "modifiedDate": datetime,
  "modifiedByMeDate": datetime,
  "lastViewedByMeDate": datetime,
  "markedViewedByMeDate": datetime,
  "sharedWithMeDate": datetime,
  "version": long,
  "sharingUser": {
    "kind": "drive#user",
    "displayName": string,
    "picture": {
      "url": string
    },
    "isAuthenticatedUser": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "parents": [
    parents Resource
  ],
  "downloadUrl": string,
  "exportLinks": {
    (key): string
  },
  "indexableText": {
    "text": string
  },
  "userPermission": permissions Resource,
  "permissions": [
    permissions Resource
  ],
  "permissionIds": [
    string
  ],
  "hasAugmentedPermissions": boolean,
  "originalFilename": string,
  "fileExtension": string,
  "fullFileExtension": string,
  "md5Checksum": string,
  "sha1Checksum": string,
  "sha256Checksum": string,
  "fileSize": long,
  "quotaBytesUsed": long,
  "ownerNames": [
    string
  ],
  "owners": [
    {
      "kind": "drive#user",
      "displayName": string,
      "picture": {
        "url": string
      },
      "isAuthenticatedUser": boolean,
      "permissionId": string,
      "emailAddress": string
    }
  ],
  "teamDriveId": string,
  "driveId": string,
  "lastModifyingUserName": string,
  "lastModifyingUser": {
    "kind": "drive#user",
    "displayName": string,
    "picture": {
      "url": string
    },
    "isAuthenticatedUser": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "ownedByMe": boolean,
  "capabilities": {
    "canAcceptOwnership": boolean,
    "canAddChildren": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canChangeRestrictedDownload": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDelete": boolean,
    "canDeleteChildren": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canModifyContent": boolean,
    "canModifyContentRestriction": boolean,
    "canModifyLabels": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemWithinDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canReadLabels": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canReadDrive": boolean,
    "canRemoveChildren": boolean,
    "canRemoveMyDriveParent": boolean,
    "canRename": boolean,
    "canShare": boolean,
    "canTrash": boolean,
    "canTrashChildren": boolean,
    "canUntrash": boolean
  },
  "editable": boolean,
  "canComment": boolean,
  "canReadRevisions": boolean,
  "shareable": boolean,
  "copyable": boolean,
  "writersCanShare": boolean,
  "shared": boolean,
  "explicitlyTrashed": boolean,
  "trashingUser": {
    "kind": "drive#user",
    "displayName": string,
    "picture": {
      "url": string
    },
    "isAuthenticatedUser": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "trashedDate": datetime,
  "appDataContents": boolean,
  "headRevisionId": string,
  "properties": [
    properties Resource
  ],
  "folderColorRgb": string,
  "imageMediaMetadata": {
    "width": integer,
    "height": integer,
    "rotation": integer,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": float,
    "aperture": float,
    "flashUsed": boolean,
    "focalLength": float,
    "isoSpeed": integer,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "exposureBias": float,
    "maxApertureValue": float,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": long
  },
  "spaces": [
    string
  ],
  "isAppAuthorized": boolean,
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      "readOnly": boolean,
      "reason": string,
      "restrictingUser": {
        "kind": "drive#user",
        "displayName": string,
        "picture": {
          "url": string
        },
        "isAuthenticatedUser": boolean,
        "permissionId": string,
        "emailAddress": string
      },
      "restrictionDate": datetime,
      "type": string
    }
  ],
  "labelInfo": {
    "labels": [
      {
        "kind": "drive#label",
        "id": string,
        "revisionId": string,
        "fields": {
          (key): {
            "kind": "drive#labelField",
            "id": string,
            "valueType": string,
            "dateString": [
              date
            ],
            "integer": [
              long
            ],
            "selection": [
              string
            ],
            "text": [
              string
            ],
            "user": [
              {
                "kind": "drive#user",
                "displayName": string,
                "picture": {
                  "url": string
                },
                "isAuthenticatedUser": boolean,
                "permissionId": string,
                "emailAddress": string
              }
            ]
          }
        }
      }
    ]
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  }
}
属性名称 值 说明 备注
kind string 文件类型。始终为 drive#file。
id string 文件的 ID。 可写入
etag etag 文件的 ETag。
title string 此文件的标题。请注意，对于不可变内容（例如共享云端硬盘的顶级文件夹、“我的云端硬盘”根文件夹和“应用数据”文件夹），其标题是固定不变的。 可写入
mimeType string 文件的 MIME 类型。仅当上传新内容时，此设置才会更新。此字段可以留空，并且 MIME 类型将根据上传内容的 MIME 类型确定。 可写入
description string 文件的简短说明。 可写入
labels object 文件的标签组。
labels.starred boolean 此文件是否由用户加注星标。 可写入
labels.hidden boolean 已弃用。
labels.trashed boolean 文件是否已被移至回收站（无论是明确删除还是从已删除的父级文件夹删除）。只有所有者可以将文件移至回收站。凡是不归文件所有者所有的用户，都会从系统返回的所有 files.list 响应中排除回收站。不过，有权访问该文件的所有用户都可以在 API 响应中查看回收站中的元数据。拥有访问权限的所有用户都可以复制、下载、导出和共享文件。 可写入
createdDate datetime 为此文件创建时间（采用格式的 RFC 3339 时间戳）。
modifiedDate datetime 任何人上次修改此文件的时间（采用格式的 RFC 3339 时间戳）。仅当设置了 setModifiedDate 参数时，此值才会在更新时发生变化。 可写入
modifiedByMeDate datetime 用户上次修改此文件的时间（采用格式的 RFC 3339 时间戳）。请注意，设置 modifiedDate 也会更新设置日期的用户的 modifiedByMe 日期。
downloadUrl string 文件的短期下载网址。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
indexableText object 文件的可编入索引的文本属性（只能写入）。有关详情，请参阅管理文件元数据。
indexableText.text string 要为此文件编入索引的文本。 可写入
userPermission nested object 经过身份验证的用户对此文件的权限。
fileExtension string fullFileExtension 的最后一个组件，其尾随文本似乎未包含在扩展中。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
md5Checksum string 此文件内容的 MD5 校验和。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
fileSize long 文件内容的大小（以字节为单位）。对于在 Google 云端硬盘中存储二进制内容的文件和文档编辑器文件，系统将填充此字段；对于快捷方式或文件夹，系统不会填充此字段。
labels.restricted boolean 已弃用 - 请改用 copyRequiresWriterPermission。
labels.viewed boolean 用户是否查看过此文件。 可写入
sharedWithMeDate datetime 此文件共享给用户的时间（采用格式的 RFC 3339 时间戳）。
parents[] list 包含此文件的父级文件夹的集合。

如果您未在插入请求中指定该文件，则该文件将直接放入用户的“我的云端硬盘”文件夹中。如果未在复制请求中指定，则文件将沿用源文件的所有可发现父级。更新请求还可以使用 addParents 和 removeParents 参数来修改父级列表。

 可写入
exportLinks.(key) string 从导出格式到网址的映射
originalFilename string 所上传内容的原始文件名（如果有），否则为 title 字段的原始值。此选项仅适用于 Google 云端硬盘中具有二进制内容的文件。 可写入
quotaBytesUsed long 此文件使用的配额字节数。
ownerNames[] list 此文件所有者的姓名。对于共享云端硬盘中的内容，系统不会填充内容。
lastModifyingUserName string 修改此文件的最后一位用户的姓名。
editable boolean 已弃用：使用 capability/canEdit。
writersCanShare boolean 写入者是否可以与其他用户共享文档。对于共享云端硬盘中的内容，系统不会填充内容。 可写入
lastViewedByMeDate datetime 用户上次查看此文件的时间（采用格式的 RFC 3339 时间戳）。 可写入
explicitlyTrashed boolean 此文件是否已明确移至回收站，而不是以递归方式移至回收站。
imageMediaMetadata object 图片媒体的元数据。此属性仅适用于图片类型，其内容将取决于可通过图片内容解析的内容。
imageMediaMetadata.width integer 图片的宽度，以像素为单位。
imageMediaMetadata.height integer 图片的高度，以像素为单位。
imageMediaMetadata.rotation integer 从图片的原始方向应用的顺时针旋转 90 度的次数。
imageMediaMetadata.location object 图片中存储的地理位置信息。
imageMediaMetadata.location.latitude double 图片中存储的纬度。
imageMediaMetadata.location.longitude double 图片中存储的经度。
imageMediaMetadata.location.altitude double 图片中存储的海拔高度。
thumbnail object 文件的缩略图。仅在无法生成标准缩略图时使用。
thumbnail.image bytes 缩略图的采用网址安全 Base64 编码的字节。应符合 RFC 4648 第 5 条的规定。
thumbnail.mimeType string 缩略图的 MIME 类型。
imageMediaMetadata.date string 照片拍摄的日期和时间（EXIF 格式时间戳）。
imageMediaMetadata.cameraMake string 用于创建照片的相机品牌。
imageMediaMetadata.cameraModel string 用于创建照片的相机型号。
imageMediaMetadata.exposureTime float 曝光时长（以秒为单位）。
imageMediaMetadata.aperture float 照片的光圈（光圈值）。
imageMediaMetadata.flashUsed boolean 是否使用闪光灯创建照片。
imageMediaMetadata.focalLength float 用于创建照片的焦距，以毫米为单位。
imageMediaMetadata.isoSpeed integer 照片的 ISO 速度。
imageMediaMetadata.meteringMode string 用于创建照片的测光模式。
imageMediaMetadata.sensor string 用于创建照片的传感器。
imageMediaMetadata.exposureMode string 用于创建照片的曝光模式。
imageMediaMetadata.colorSpace string 照片的颜色空间。
imageMediaMetadata.whiteBalance string 用于创建照片的白平衡模式。
imageMediaMetadata.exposureBias float 照片的曝光偏差（APEX 值）。
imageMediaMetadata.maxApertureValue float 用于制作照片的焦距的最小 f 数（APEX 值）。
imageMediaMetadata.subjectDistance integer 与照片正文的距离（以米为单位）。
imageMediaMetadata.lens string 用于创建照片的镜头。
shared boolean 文件是否已共享。对于共享云端硬盘中的内容，系统不会填充内容。
owners[] list 此文件的所有者。只有某些旧版文件可以有多个所有者。对于此字段，系统不会为共享云端硬盘中的内容填充此字段。
owners[].kind string 始终为 drive#user。
owners[].displayName string 该用户的纯文本显示名称。
owners[].picture object 用户的个人资料照片。
owners[].picture.url string 指向该用户的个人资料照片的网址。
owners[].isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
owners[].permissionId string 权限集合中显示的用户 ID。
lastModifyingUser nested object 修改此文件的最后一位用户。
lastModifyingUser.kind string 始终为 drive#user。
lastModifyingUser.displayName string 该用户的纯文本显示名称。
lastModifyingUser.picture object 用户的个人资料照片。
lastModifyingUser.picture.url string 指向该用户的个人资料照片的网址。
lastModifyingUser.isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
lastModifyingUser.permissionId string 权限集合中显示的用户 ID。
appDataContents boolean 此文件是否位于 Application Data 文件夹中。
openWithLinks.(key) string
headRevisionId string 文件头修订的 ID。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
copyable boolean 已弃用：使用 capability/canCopy。
properties[] list 属性列表。 可写入
owners[].emailAddress string 用户的电子邮件地址。
lastModifyingUser.emailAddress string 用户的电子邮件地址。只有在最后一个修改用户是文件的所有者、提出请求的用户是所有者或是可以修改文件，或者最后一个修改用户的电子邮件地址可见时，系统才会返回此字段。
markedViewedByMeDate datetime 已弃用。
version long 文件的单调递增版本号。这些信息会体现对服务器上的文件所做的所有更改，包括那些发出请求的用户无法看到的更改。
sharingUser nested object 与当前用户共享内容（如果有）的用户。
sharingUser.kind string 始终为 drive#user。
sharingUser.displayName string 该用户的纯文本显示名称。
sharingUser.picture object 用户的个人资料照片。
sharingUser.picture.url string 指向该用户的个人资料照片的网址。
sharingUser.isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
sharingUser.permissionId string 权限集合中显示的用户 ID。
sharingUser.emailAddress string 用户的电子邮件地址。
permissions[] list 有权访问此文件的用户的权限列表。对于共享云端硬盘中的内容，系统不会填充内容。
videoMediaMetadata object 关于视频媒体的元数据。该参数仅适用于视频类型。
videoMediaMetadata.width integer 视频的宽度（以像素为单位）。
videoMediaMetadata.height integer 视频的高度（以像素为单位）。
videoMediaMetadata.durationMillis long 视频的时长（以毫秒为单位）。
folderColorRgb string 如果文件夹是文件夹或文件夹的快捷方式，则为 RGB 十六进制字符串的文件夹颜色。受支持的颜色列表位于“关于”资源的 folderColorPalette 字段中。如果指定了不受支持的颜色，该颜色会更改为调色板中最接近的颜色。 可写入
fullFileExtension string 完整的文件扩展名；从标题中提取。可能包含多个串联的扩展名，例如“tar.gz”。从标题中移除附加信息并不会清空此字段；但更改标题中的附加信息确实会更新此字段。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
ownedByMe boolean 文件是否归当前用户所有。对于共享云端硬盘中的内容，系统不会填充内容。
canComment boolean 已弃用：使用 capability/canComments。
shareable boolean 已弃用：使用 capability/canShare。
spaces[] list 包含该文件的聊天室列表。支持的值为“drive”、“appDataFolder”和“photos”。
canReadRevisions boolean 已弃用：使用 capability/canReadRevisions。
isAppAuthorized boolean 文件是由请求应用创建还是打开。
hasThumbnail boolean 此文件是否有缩略图。这并不表示发出请求的应用是否有权访问缩略图。要检查访问权限，请看看缩略图链接字段是否存在。
thumbnailVersion long 用于缩略图缓存失效操作的缩略图版本。
labels.modified boolean 文件是否由此用户修改。
hasAugmentedPermissions boolean 是否有直接拥有此文件的权限。此字段只会填充共享云端硬盘中的内容。
teamDriveId string 已弃用 - 请改用 driveId。
capabilities object 当前用户对此文件的权限。每项功能都对应于用户可能会执行的精细操作。
capabilities.canAddChildren boolean 当前用户是否可以添加文件夹至此文件夹。如果内容不是文件夹，则此值始终为 false。
capabilities.canComment boolean 当前用户是否可以对此文件发表评论。
capabilities.canCopy boolean 当前用户是否可以复制此文件。对于共享云端硬盘中的内容，当前用户能否复制此内容的非文件夹后代，如果该内容不是文件夹，则复制此内容本身。
capabilities.canDelete boolean 当前用户是否可以删除此文件。
capabilities.canDownload boolean 当前用户是否可以下载此文件。
capabilities.canEdit boolean 当前用户是否可以编辑此文件。其他因素可能限制用户对文件的更改类型。例如，请参阅 canChangeCopyRequiresWriterPermission 或 canModifyContent。
capabilities.canListChildren boolean 当前用户是否可以列出此文件夹的子文件夹。如果内容不是文件夹，则此值始终为 false。
capabilities.canMoveItemIntoTeamDrive boolean 已弃用 - 请改用 canMoveItemOutOfDrive。
capabilities.canMoveTeamDriveItem boolean 已弃用 - 请改用 canMoveItemWithinDrive 或 canMoveItemOutOfDrive。
capabilities.canReadRevisions boolean 当前用户是否可以读取此文件的修订版本资源。对于共享云端硬盘内容，无论该内容是文件夹的非子文件夹的修订版本，还是此项目本身（如果不是文件夹）的修订版本，都可以读取。
capabilities.canReadTeamDrive boolean 已弃用 - 请改用 canReadDrive。
capabilities.canRemoveChildren boolean 当前用户是否可以从此文件夹中移除儿童。如果内容不是文件夹，则此值始终为 false。对于共享云端硬盘中的文件夹，请改用 canDeleteChildren 或 canTrashChildren。
capabilities.canRename boolean 当前用户是否可以重命名此文件。
capabilities.canShare boolean 当前用户是否可以修改此文件的共享设置。
capabilities.canTrash boolean 当前用户是否可以将此文件移至回收站。
capabilities.canUntrash boolean 当前用户是否可以从回收站中恢复此文件。
trashingUser nested object 如果文件已被明确移至回收站，则会被移至回收站的用户。仅填充共享云端硬盘中的内容。
trashingUser.kind string 始终为 drive#user。
trashingUser.displayName string 该用户的纯文本显示名称。
trashingUser.picture object 用户的个人资料照片。
trashingUser.picture.url string 指向该用户的个人资料照片的网址。
trashingUser.isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
trashingUser.permissionId string 权限集合中显示的用户 ID。
trashingUser.emailAddress string 用户的电子邮件地址。
trashedDate datetime 内容移至回收站的时间（采用格式的 RFC 3339 时间戳）。仅填充共享云端硬盘中的内容。
capabilities.canChangeRestrictedDownload boolean 已弃用
permissionIds[] list 拥有此文件访问权限的用户的权限 ID 列表。
copyRequiresWriterPermission boolean 是否应为读者和评论者停用复制、打印或下载此文件的选项。 可写入
capabilities.canChangeCopyRequiresWriterPermission boolean 当前用户是否可以更改此文件的 copyRequiresWriterPermission 限制。
capabilities.canDeleteChildren boolean 当前用户是否可以删除此文件夹的子级。如果内容不是文件夹，则该值为 false。仅填充共享云端硬盘中的内容。
capabilities.canMoveChildrenOutOfTeamDrive boolean 已弃用 - 请改用 canMoveChildrenOutOfDrive。
capabilities.canMoveChildrenWithinTeamDrive boolean 已弃用 - 请改用 canMoveChildrenWithinDrive。
capabilities.canMoveItemOutOfTeamDrive boolean 已弃用 - 请改用 canMoveItemOutOfDrive。
capabilities.canMoveItemWithinTeamDrive boolean 已弃用 - 请改用 canMoveItemWithinDrive。
capabilities.canTrashChildren boolean 当前用户是否可以将此文件夹的子级移至回收站。如果内容不是文件夹，则该值为 false。仅填充共享云端硬盘中的内容。
driveId string 文件所在的共享云端硬盘的 ID。仅填充共享云端硬盘中的内容。
capabilities.canMoveChildrenOutOfDrive boolean 当前用户是否可以将此文件夹的子文件夹移出共享云端硬盘。如果内容不是文件夹，则该值为 false。仅填充共享云端硬盘中的内容。
capabilities.canMoveChildrenWithinDrive boolean 当前用户是否可以在此云端硬盘中移动此文件夹的子级。如果内容不是文件夹，则该值为 false。请注意，移动子项的请求可能仍会失败，具体取决于当前用户对子项和目标文件夹的访问权限。
capabilities.canMoveItemOutOfDrive boolean 当前用户是否可以通过更改其父级内容将此内容移出此云端硬盘。请注意，更改项的父级的请求可能仍会失败，具体取决于要添加的新父级。
capabilities.canMoveItemWithinDrive boolean 当前用户是否可以在此云端硬盘中移动此内容。请注意，更改项的父级的请求可能仍会失败，具体取决于要添加的新父级和要移除的父级。
capabilities.canReadDrive boolean 当前用户是否可以读取此文件所属的共享云端硬盘。仅填充共享云端硬盘中的内容。
capabilities.canModifyContent boolean 当前用户是否可以修改此文件的内容。
capabilities.canAddMyDriveParent boolean 当前用户是否可以为相应项添加父级，而无需在同一请求中移除现有父级。系统不会填充共享云端硬盘文件。
capabilities.canRemoveMyDriveParent boolean 当前用户是否可以从内容中移除父级，而无需在同一请求中添加其他父级。系统不会填充共享云端硬盘文件。
shortcutDetails object 快捷方式文件详细信息。仅为 mimeType 字段设置为 application/vnd.google-apps.shortcut 的快捷方式文件填充。
shortcutDetails.targetId string 此快捷方式指向的文件的 ID。 可写入
shortcutDetails.targetMimeType string 此快捷方式指向的文件的 MIME 类型。此字段的值是创建快捷方式时捕获的目标 MIME 类型的快照。
capabilities.canAddFolderFromAnotherDrive boolean 当前用户是否可以将其他共享云端硬盘（其他共享云端硬盘或“我的云端硬盘”）中的文件夹添加到此文件夹中。如果内容不是文件夹，则该值为 false。仅填充共享云端硬盘中的内容。
capabilities.canModifyContentRestriction boolean 当前用户是否可以修改此文件内容的限制。
contentRestrictions[] list 对文件内容访问的限制。仅当存在此类限制时填充。
contentRestrictions[].readOnly boolean 文件的内容是否为只读。如果某个文件是只读文件，则不可添加新的该文件修订版本、不可添加或修改注释，也不得修改文件标题。 可写入
contentRestrictions[].reason string 文件内容受限的原因。这仅对同时设置 readOnly=true 的请求是可变的。 可写入
contentRestrictions[].restrictingUser nested object 设置内容限制的用户。仅当 readOnly 为 true 时填充。
contentRestrictions[].restrictingUser.kind string 始终为 drive#user。
contentRestrictions[].restrictingUser.displayName string 该用户的纯文本显示名称。
contentRestrictions[].restrictingUser.picture object 用户的个人资料照片。
contentRestrictions[].restrictingUser.picture.url string 指向该用户的个人资料照片的网址。
contentRestrictions[].restrictingUser.isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
contentRestrictions[].restrictingUser.permissionId string 权限集合中显示的用户 ID。
contentRestrictions[].restrictingUser.emailAddress string 用户的电子邮件地址。
contentRestrictions[].restrictionDate datetime 设置内容限制的时间（采用格式的 RFC 3339 时间戳）。仅当 readOnly 为 true 时填充。
contentRestrictions[].type string 内容限制的类型。目前唯一可能的值是 globalContentRestriction。
capabilities.canChangeSecurityUpdateEnabled boolean 当前用户是否可以更改链接共享元数据中的 securityUpdateEnabled 字段。
shortcutDetails.targetResourceKey string 目标文件的 ResourceKey。
resourceKey string 通过共享链接访问该项所需的密钥。
linkShareMetadata object 包含客户端用于引用此项目的链接网址的详细信息。
linkShareMetadata.securityUpdateEligible boolean 文件是否符合安全更新的条件。
linkShareMetadata.securityUpdateEnabled boolean 此文件是否已启用安全更新。
capabilities.canAcceptOwnership boolean 当前用户是否为文件的受让所有者。系统不会填充共享云端硬盘文件。
capabilities.canModifyLabels boolean 当前用户是否可以修改此文件中的标签。
capabilities.canReadLabels boolean 当前用户是否可以读取此文件中的标签。
labelInfo object 文件的标签概览。
labelInfo.labels[] list 文件上的标签集，由 includeLabels 参数中的标签 ID 请求。默认情况下，系统不会返回任何标签。
labelInfo.labels[].kind string 始终为 drive#label
labelInfo.labels[].id string 标签的 ID。
labelInfo.labels[].revisionId string 标签的修订版本 ID。
labelInfo.labels[].fields object 由字段 ID 键控的标签字段映射。
labelInfo.labels[].fields.(key) nested object
labelInfo.labels[].fields.(key).kind string 始终为 drive#labelField。
labelInfo.labels[].fields.(key).id string 此字段的标识符。
labelInfo.labels[].fields.(key).valueType string 字段类型。虽然未来可能支持新值，但目前允许使用以下值：
  • 日期字符串
  • integer
  • 选择
  • text
  • 用户
labelInfo.labels[].fields.(key).dateString[] list 仅当 valueType 为 dateString 时才存在。RFC 3339 格式的日期：YYYY-MM-DD。
labelInfo.labels[].fields.(key).integer[] list 仅当 valueType 为 integer 时才存在。
labelInfo.labels[].fields.(key).selection[] list 仅当 valueType 为 selection 时才存在。
labelInfo.labels[].fields.(key).text[] list 仅当 valueType 为 text 时才存在。
labelInfo.labels[].fields.(key).user[] list 仅当 valueType 为 user 时才存在。
labelInfo.labels[].fields.(key).user[].kind string 始终为 drive#user。
labelInfo.labels[].fields.(key).user[].displayName string 该用户的纯文本显示名称。
labelInfo.labels[].fields.(key).user[].picture object 用户的个人资料照片。
labelInfo.labels[].fields.(key).user[].picture.url string 指向该用户的个人资料照片的网址。
labelInfo.labels[].fields.(key).user[].isAuthenticatedUser boolean 此用户是否为提出请求的经过身份验证的用户。
labelInfo.labels[].fields.(key).user[].permissionId string 权限集合中显示的用户 ID。
labelInfo.labels[].fields.(key).user[].emailAddress string 用户的电子邮件地址。
sha1Checksum string 与此文件关联的 SHA1 校验和（如果有）。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。
sha256Checksum string 与此文件关联的 SHA256 校验和（如果有）。此字段仅适用于在其中存储了 Google 云端硬盘的文件，而不适用于文档编辑器或快捷方式文件。

方法

get
根据 ID 获取文件的元数据或内容。
插入
插入新文件。
补丁程序
更新文件的元数据和/或内容。调用此方法时，请只填充您要修改的请求中的字段。更新字段时，某些字段可能会自动更改，例如修改后的日期。此方法支持补丁程序语义。
update
更新文件的元数据和/或内容。调用此方法时，请只填充您要修改的请求中的字段。更新字段时，某些字段可能会自动更改，例如修改后的日期。此方法支持补丁程序语义。
复制
创建指定文件的副本。无法复制文件夹。
delete
按 ID 永久删除文件。跳过回收站。目前已通过身份验证的用户必须是该文件的所有者，或者是该共享云端硬盘中父级文件组织者。
list
列出用户的文件。
触摸
将文件的更新时间设置为当前服务器时间。
回收站
将文件移至回收站。目前已通过身份验证的用户必须是该文件的所有者，或者是共享云端硬盘中至少一位父用户的文件整理者。只有所有者可以将文件移至回收站。凡是不归文件所有者所有的用户，都会从系统返回的所有 files.list 响应中排除回收站。不过，有权访问该文件的所有用户都可以在 API 响应中查看回收站中的元数据。拥有访问权限的所有用户都可以复制、下载、导出和共享文件。
取消回收站
恢复回收站中的文件。目前已通过身份验证的用户必须是该文件的所有者，或者是共享云端硬盘中至少一位父用户的文件整理者。只有所有者才能取消还原文件。
手表
订阅对文件的更改。虽然您可以为共享云端硬盘中的文件更改建立渠道，但更改共享云端硬盘文件不会创建通知。
进入“已删除邮件”文件夹
永久删除用户的所有已移至回收站的文件。
generateIds
生成一组可在插入或复制请求中提供的文件 ID。
导出
将 Google Workspace 文档导出到请求的 MIME 类型，并返回导出的字节内容。请注意，所导出的内容不得超过 10MB。
listLabels
列出文件的标签。
modifyLabels
修改文件上的标签集。