本頁面由 Cloud Translation API 翻譯而成。

REST Resource: files

資源：檔案
- JSON 表示法
  - JSON 表示法
  - JSON 表示法
- ContentRestriction
  - JSON 表示法
方法

資源：檔案

檔案的中繼資料。

部分資源方法 (例如 files.update) 需要 fileId。使用 files.list 方法擷取檔案 ID。

JSON 表示法

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 }, "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 }

{
  "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
  },
  "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
}

欄位
`kind`	`string` 僅供輸出。指出資源的類型。值：固定字串 `"drive#file"`。
`driveId`	`string` 僅供輸出。檔案所屬共用雲端硬碟的 ID。只有共用雲端硬碟中的項目才會填入資料。
`fileExtension`	`string` 僅供輸出。`fullFileExtension` 的最終元件。這項功能僅適用於 Google 雲端硬碟中含有二進位內容的檔案。
`copyRequiresWriterPermission`	`boolean` 設定是否要為讀者和加註者停用複製、列印或下載這個檔案的選項。
`md5Checksum`	`string` 僅供輸出。檔案內容的 MD5 總和檢查碼。這僅適用於 Google 雲端硬碟中含有二進位內容的檔案。
`contentHints`	`object` 檔案內容的其他資訊。這些欄位一律不會填入回應。
`contentHints.indexableText`	`string` 要為檔案建立索引的文字，以改善全文查詢。大小上限為 128 KB，可能含有 HTML 元素。
`contentHints.thumbnail`	`object` 檔案的縮圖。這個選單僅適用於 Google 雲端硬碟無法產生標準縮圖時。
`contentHints.thumbnail.image`	`string (bytes format)` 使用網址安全 Base64 編碼的縮圖資料 (RFC 4648 第 5 節)。 Base64 編碼的字串。
`contentHints.thumbnail.mimeType`	`string` 縮圖的 MIME 類型。
`writersCanShare`	`boolean` 是否只有「`writer`」權限的使用者才能修改檔案權限。系統不會為共用雲端硬碟中的項目填入資料。
`viewedByMe`	`boolean` 僅供輸出。使用者是否看過檔案。
`mimeType`	`string` 檔案的 MIME 類型。如果未提供任何值，Google 雲端硬碟會嘗試自動偵測上傳內容中的適當值。必須上傳新修訂版本，才能變更這個值。如果使用 Google 文件的 MIME 類型建立檔案，系統會盡可能匯入使用者上傳的內容。支援的匯入格式會在「關於」資源中發布。
`exportLinks`	`map (key: string, value: string)` 僅供輸出。以特定格式匯出文件編輯器檔案的連結。這個物件中包含 `"key": value` 組合的清單，例如：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` 包含檔案的上層資料夾 ID。如果建立要求時未指定檔案，系統會將檔案直接放在使用者的「我的雲端硬碟」資料夾中。如未在複製要求中指定，檔案會繼承來源檔案所有可搜尋的父項。file.update 要求必須使用 `addParents` 和 `removeParents` 參數修改父項清單。
`thumbnailLink`	`string` 僅供輸出。檔案的縮圖線上連結 (如有)。通常以小時順序為準。只有在要求的應用程式可存取檔案內容時，才會填入資料。如果檔案未公開共用，則必須使用憑證要求來擷取 `Files.thumbnailLink` 中傳回的網址。
`iconLink`	`string` 僅供輸出。檔案圖示的未驗證靜態連結。
`shared`	`boolean` 僅供輸出。檔案是否已共用。系統不會為共用雲端硬碟中的項目填入資料。
`lastModifyingUser`	`object (User)` 僅供輸出。最後一個修改檔案的使用者。
`owners[]`	`object (User)` 僅供輸出。這個檔案的擁有者。只有特定舊版檔案可以有多位擁有者。這個欄位不會針對共用雲端硬碟中的項目填入資料。
`headRevisionId`	`string` 僅供輸出。檔案首修訂版本的 ID。這項功能目前僅適用於 Google 雲端硬碟中含有二進位內容的檔案。
`sharingUser`	`object (User)` 僅供輸出。與提出要求的使用者共用檔案的使用者 (如適用)。
`webViewLink`	`string` 僅供輸出。透過連結，即可在相關的 Google 編輯器或檢視器中開啟檔案。
`webContentLink`	`string` 僅供輸出。在瀏覽器中下載檔案內容的連結。這項功能僅適用於 Google 雲端硬碟中含有二進位內容的檔案。
`size`	`string (int64 format)` 僅供輸出。blob 和第一方編輯器檔案的大小 (以位元組為單位)。如果是沒有大小限制的檔案 (例如捷徑和資料夾)，則不會自動填入。
`viewersCanCopyContent (deprecated)`	`boolean` 這個項目現已淘汰！已淘汰：請改用 `copyRequiresWriterPermission`。
`permissions[]`	`object (Permission)` 僅供輸出。檔案的完整權限清單。只有在提出要求的使用者可共用檔案時，才能使用此功能。系統不會為共用雲端硬碟中的項目填入資料。
`hasThumbnail`	`boolean` 僅供輸出。這個檔案是否有縮圖。但這並不代表提出要求的應用程式是否能存取縮圖。如要確認存取權，請檢查是否有縮圖連結欄位。
`spaces[]`	`string` 僅供輸出。包含該檔案的聊天室清單。目前支援的值為「drive」、「appDataFolder」和「photos」。
`folderColorRgb`	`string` 以 RGB 十六進位字串表示的資料夾或資料夾捷徑顏色。支援的顏色會列在關於資源的 `folderColorPalette` 欄位中。如果指定不支援的顏色，會改用調色盤中最接近的顏色。
`id`	`string` 檔案的 ID。
`name`	`string` 檔案名稱。這在資料夾中不一定是唯一的。請注意，對於不可變更的項目，例如共用雲端硬碟的頂層資料夾、「我的雲端硬碟」根資料夾和「應用程式資料」資料夾，名稱會維持不變。
`description`	`string` 關於檔案的簡要說明。
`starred`	`boolean` 使用者是否為檔案加上星號。
`trashed`	`boolean` 檔案已移至垃圾桶 (明確位置或從移至垃圾桶的上層資料夾)。只有擁有者可以將檔案移至垃圾桶，其他使用者無法查看擁有者垃圾桶中的檔案。
`explicitlyTrashed`	`boolean` 僅供輸出。檔案是否已明確移至垃圾桶，而非從上層資料夾遞迴移至垃圾桶。
`createdTime`	`string` 檔案建立時間 (RFC 3339 日期時間)。
`modifiedTime`	`string` 上次任何人修改檔案的時間 (RFC 3339 日期時間)。請注意，設定 `modifiedTime` 也會為使用者更新 `modifiedByMeTime`。
`modifiedByMeTime`	`string` 僅供輸出。使用者上次修改檔案的時間 (RFC 3339 日期時間)。
`viewedByMeTime`	`string` 使用者上次檢視檔案的時間 (RFC 3339 日期時間)。
`sharedWithMeTime`	`string` 僅供輸出。與使用者共用檔案的時間 (如適用，RFC 3339 日期時間)。
`quotaBytesUsed`	`string (int64 format)` 僅供輸出。檔案使用的儲存空間配額位元組數。包括前端修訂版本和已啟用 `keepForever` 的先前修訂版本。
`version`	`string (int64 format)` 僅供輸出。檔案的單調遞增版本號碼。這項資訊反映了伺服器上的所有檔案變更，包括使用者看不到的這些變更。
`originalFilename`	`string` 上傳內容的原始檔案名稱 (如有)，或 `name` 欄位的原始值。這項功能僅適用於 Google 雲端硬碟中含有二進位內容的檔案。
`ownedByMe`	`boolean` 僅供輸出。使用者是否擁有檔案。系統不會為共用雲端硬碟中的項目填入資料。
`fullFileExtension`	`string` 僅供輸出。從 `name` 欄位擷取的完整副檔名。可能包含多個串連的擴充功能，例如「tar.gz」。這項功能僅適用於 Google 雲端硬碟中含有二進位內容的檔案。當 `name` 欄位變更時，系統會自動更新這項資訊，但如果新名稱不含有效的副檔名，系統不會清除這個欄位。
`properties`	`map (key: string, value: value (Value format))` 所有應用程式都會顯示的任意鍵/值組合。如果項目為空值，系統會在更新和複製要求中清除。這個物件中包含 `"key": value` 組合的清單，例如：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`appProperties`	`map (key: string, value: value (Value format))` 任意鍵/值組合的集合，僅供要求應用程式使用。如果項目為空值，系統會在更新和複製要求中清除。這些屬性只能透過經過驗證的要求擷取。經過驗證的要求會使用以 OAuth 2 用戶端 ID 取得的存取權杖。您無法使用 API 金鑰擷取不公開屬性。這個物件中包含 `"key": value` 組合的清單，例如：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`isAppAuthorized`	`boolean` 僅供輸出。該檔案是由要求應用程式建立或開啟。
`teamDriveId (deprecated)`	`string` 這個項目現已淘汰！已淘汰：僅限輸出。請改用 `driveId`。
`capabilities`	`object` 僅供輸出。目前使用者擁有這個檔案的功能。每項功能都對應到使用者可能採取的細部動作。
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` 已淘汰：僅限輸出。
`capabilities.canMoveChildrenOutOfDrive`	`boolean` 僅供輸出。目前的使用者能否將這個資料夾的子項移至共用雲端硬碟外。如果項目不是資料夾，則為「false」。只有共用雲端硬碟中的項目才會填入資料。
`capabilities.canReadDrive`	`boolean` 僅供輸出。目前的使用者是否能讀取這個檔案所屬的共用雲端硬碟。只有共用雲端硬碟中的項目才會填入資料。
`capabilities.canEdit`	`boolean` 僅供輸出。目前的使用者是否能編輯這個檔案。其他因素可能會限制使用者能對檔案進行的變更類型。例如，請參閱 `canChangeCopyRequiresWriterPermission` 或 `canModifyContent`。
`capabilities.canCopy`	`boolean` 僅供輸出。目前的使用者是否能複製這個檔案。針對共用雲端硬碟中的某個項目，目前使用者是否能複製這個項目的非資料夾子系；如果該項目不是資料夾，則會複製該項目本身。
`capabilities.canComment`	`boolean` 僅供輸出。目前的使用者是否能對這個檔案加註。
`capabilities.canAddChildren`	`boolean` 僅供輸出。目前的使用者能否在這個資料夾中新增子項。如果項目不是資料夾，則這個屬性一律為 false。
`capabilities.canDelete`	`boolean` 僅供輸出。目前的使用者能否刪除這個檔案。
`capabilities.canDownload`	`boolean` 僅供輸出。目前使用者是否能夠下載這個檔案。
`capabilities.canListChildren`	`boolean` 僅供輸出。目前的使用者是否能列出這個資料夾的子項。如果項目不是資料夾，則這個屬性一律為 false。
`capabilities.canRemoveChildren`	`boolean` 僅供輸出。目前的使用者能否移除這個資料夾中的子項。如果項目不是資料夾，則這個屬性一律為 false。如果是共用雲端硬碟中的資料夾，請改用 `canDeleteChildren` 或 `canTrashChildren`。
`capabilities.canRename`	`boolean` 僅供輸出。目前的使用者是否能重新命名這個檔案。
`capabilities.canTrash`	`boolean` 僅供輸出。目前的使用者是否能將這個檔案移至垃圾桶。
`capabilities.canReadRevisions`	`boolean` 僅供輸出。目前的使用者是否能讀取這個檔案的修訂版本資源。可以讀取共用雲端硬碟項目的非資料夾子系修訂版本，或這個項目本身 (如果不是資料夾) 可以讀取。
`capabilities.canReadTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canReadDrive`。
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveItemWithinDrive` 或 `canMoveItemOutOfDrive`。
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` 僅供輸出。指定目前的使用者是否能變更這個檔案的 `copyRequiresWriterPermission` 限制。
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveItemOutOfDrive`。
`capabilities.canUntrash`	`boolean` 僅供輸出。指定目前的使用者是否能從垃圾桶還原這個檔案。
`capabilities.canModifyContent`	`boolean` 僅供輸出。目前的使用者是否能修改這個檔案的內容。
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveItemWithinDrive`。
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveItemOutOfDrive`。
`capabilities.canDeleteChildren`	`boolean` 僅供輸出。目前的使用者能否刪除這個資料夾的子項。如果項目不是資料夾，則為「false」。只有共用雲端硬碟中的項目才會填入資料。
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveChildrenOutOfDrive`。
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` 已淘汰：僅限輸出。請改用 `canMoveChildrenWithinDrive`。
`capabilities.canTrashChildren`	`boolean` 僅供輸出。目前的使用者是否能將此資料夾的子項移至垃圾桶。如果項目不是資料夾，則為「false」。只有共用雲端硬碟中的項目才會填入資料。
`capabilities.canMoveItemOutOfDrive`	`boolean` 僅供輸出。指定目前使用者是否能透過變更父項，將這個項目移出這個雲端硬碟。請注意，視新增的父項而定，變更項目父項的要求可能仍會失敗。
`capabilities.canAddMyDriveParent`	`boolean` 僅供輸出。目前的使用者是否能在同一個要求中為項目新增父項，而不需移除現有的父項。系統不會為共用雲端硬碟檔案填入資料。
`capabilities.canRemoveMyDriveParent`	`boolean` 僅供輸出。目前的使用者是否可以在同一個要求中移除父項，而不用新增另一個父項。系統不會為共用雲端硬碟檔案填入資料。
`capabilities.canMoveItemWithinDrive`	`boolean` 僅供輸出。目前使用者是否能在這個雲端硬碟中移動這個項目。請注意，視新增的父項和被移除的父項而定，變更項目父項的要求可能仍會失敗。
`capabilities.canShare`	`boolean` 僅供輸出。目前的使用者是否能修改這個檔案的共用設定。
`capabilities.canMoveChildrenWithinDrive`	`boolean` 僅供輸出。目前使用者是否能在這個雲端硬碟中移動這個資料夾的子項。如果項目不是資料夾，則為「false」。請注意，視目前使用者的子項和目的地資料夾的存取權而定，移動子項的要求可能仍會失敗。
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` 已淘汰：僅限輸出。請使用 `canModifyEditorContentRestriction`、`canModifyOwnerContentRestriction` 或 `canRemoveContentRestriction` 其中之一。
`capabilities.canAddFolderFromAnotherDrive`	`boolean` 僅供輸出。目前的使用者是否能將其他雲端硬碟 (不同共用雲端硬碟或「我的雲端硬碟」) 的資料夾新增至這個資料夾。如果項目不是資料夾，則為「false」。只有共用雲端硬碟中的項目才會填入資料。
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` 僅供輸出。指定目前的使用者是否可以變更連結共用中繼資料的 securityUpdateEnabled 欄位。
`capabilities.canAcceptOwnership`	`boolean` 僅供輸出。目前的使用者是否為檔案邀請對象。系統不會為共用雲端硬碟檔案填入資料。
`capabilities.canReadLabels`	`boolean` 僅供輸出。是否可讀取檔案上的標籤。
`capabilities.canModifyLabels`	`boolean` 僅供輸出。目前使用者是否能夠修改檔案的標籤。
`capabilities.canModifyEditorContentRestriction`	`boolean` 僅供輸出。目前使用者是否可在受編輯者限制的檔案中新增或修改內容限制。
`capabilities.canModifyOwnerContentRestriction`	`boolean` 僅供輸出。是否能新增或修改僅限擁有者存取的內容限制。
`capabilities.canRemoveContentRestriction`	`boolean` 僅供輸出。檔案是否設有可由目前使用者移除的內容限制。
`hasAugmentedPermissions`	`boolean` 僅供輸出。你是否直接擁有這個檔案的權限。這個欄位只會針對共用雲端硬碟中的項目填入資料。
`trashingUser`	`object (User)` 僅供輸出。如果檔案已明確移至垃圾桶，即為移至垃圾桶的使用者。只有共用雲端硬碟中的項目才會填入資料。
`thumbnailVersion`	`string (int64 format)` 僅供輸出。用於撤銷縮圖快取的縮圖版本。
`trashedTime`	`string` 僅供輸出。項目移至垃圾桶的時間 (RFC 3339 日期時間)。只有共用雲端硬碟中的項目才會填入資料。
`modifiedByMe`	`boolean` 僅供輸出。使用者是否修改過檔案。
`permissionIds[]`	`string` 僅限輸出。file.list 權限 ID 適用於擁有此檔案存取權的使用者。
`imageMediaMetadata`	`object` 僅供輸出。圖片媒體的其他中繼資料 (如有)。
`imageMediaMetadata.flashUsed`	`boolean` 僅供輸出。相片是否使用閃光燈。
`imageMediaMetadata.meteringMode`	`string` 僅供輸出。用於製作相片的測光模式。
`imageMediaMetadata.sensor`	`string` 僅供輸出。用於製作相片的感應器類型。
`imageMediaMetadata.exposureMode`	`string` 僅供輸出。用於製作相片的曝光模式。
`imageMediaMetadata.colorSpace`	`string` 僅供輸出。相片的色域。
`imageMediaMetadata.whiteBalance`	`string` 僅供輸出。用於製作相片的白平衡模式。
`imageMediaMetadata.width`	`integer` 僅供輸出。圖片的寬度 (以像素為單位)。
`imageMediaMetadata.height`	`integer` 僅供輸出。圖片的高度 (以像素為單位)。
`imageMediaMetadata.location`	`object` 僅供輸出。儲存在圖片中的地理位置資訊。
`imageMediaMetadata.location.latitude`	`number` 僅供輸出。圖片中儲存的緯度。
`imageMediaMetadata.location.longitude`	`number` 僅供輸出。圖片中儲存的經度。
`imageMediaMetadata.location.altitude`	`number` 僅供輸出。儲存在圖片中的海拔高度。
`imageMediaMetadata.rotation`	`integer` 僅供輸出。從圖片原始方向套用的順時針旋轉 90 度的次數。
`imageMediaMetadata.time`	`string` 僅供輸出。相片的拍攝日期和時間 (EXIF 日期時間)。
`imageMediaMetadata.cameraMake`	`string` 僅供輸出。用來製作相片的相機鏡頭。
`imageMediaMetadata.cameraModel`	`string` 僅供輸出。用於製作相片的相機模型。
`imageMediaMetadata.exposureTime`	`number` 僅供輸出。曝光的時間長度 (以秒為單位)。
`imageMediaMetadata.aperture`	`number` 僅供輸出。用於製作相片的光圈 (f-number)。
`imageMediaMetadata.focalLength`	`number` 僅供輸出。用於建立相片的焦距 (公釐)。
`imageMediaMetadata.isoSpeed`	`integer` 僅供輸出。用於製作相片的 ISO 速度。
`imageMediaMetadata.exposureBias`	`number` 僅供輸出。相片的曝光偏差 (APEX 值)。
`imageMediaMetadata.maxApertureValue`	`number` 僅供輸出。用於建立相片的焦距最小 f 數 (APEX 值)。
`imageMediaMetadata.subjectDistance`	`integer` 僅供輸出。相片主體的距離 (以公尺為單位)。
`imageMediaMetadata.lens`	`string` 僅供輸出。用來製作相片的鏡頭。
`videoMediaMetadata`	`object` 僅供輸出。影片媒體的其他中繼資料。相片上傳後可能不會立即顯示。
`videoMediaMetadata.width`	`integer` 僅供輸出。影片的寬度 (以像素為單位)。
`videoMediaMetadata.height`	`integer` 僅供輸出。影片的高度 (以像素為單位)。
`videoMediaMetadata.durationMillis`	`string (int64 format)` 僅供輸出。影片的時間長度 (以毫秒為單位)。
`shortcutDetails`	`object` 捷徑檔案詳細資料。僅針對 mimeType 欄位設為 `application/vnd.google-apps.shortcut` 的捷徑檔案填入資料。
`shortcutDetails.targetId`	`string` 這個捷徑指向的檔案 ID。
`shortcutDetails.targetMimeType`	`string` 僅供輸出。這個捷徑指向的檔案的 MIME 類型。這個欄位的值是捷徑建立時擷取的目標 MIME 類型快照。
`shortcutDetails.targetResourceKey`	`string` 僅供輸出。目標檔案的 ResourceKey。
`contentRestrictions[]`	`object (ContentRestriction)` 存取檔案內容的相關限制。只有在這類限制存在時才會填入。
`resourceKey`	`string` 僅供輸出。必須透過共用連結存取項目所需的金鑰。
`linkShareMetadata`	`object` 僅供輸出。LinkShare 的相關詳細資料。包含客戶用來參照這個項目的連結網址的詳細資料。
`linkShareMetadata.securityUpdateEligible`	`boolean` 僅供輸出。檔案是否符合安全性更新的資格。
`linkShareMetadata.securityUpdateEnabled`	`boolean` 僅供輸出。這個檔案是否已啟用安全性更新。
`labelInfo`	`object` 僅供輸出。檔案標籤的總覽。
`labelInfo.labels[]`	`object (Label)` 僅供輸出。依據 `includeLabels` 參數中的標籤 ID 要求，在檔案中提交的一組標籤。根據預設，系統不會傳回任何標籤。
`sha1Checksum`	`string` 僅供輸出。與這個檔案相關聯的 SHA1 總和檢查碼 (如果有的話)。這個欄位只會針對儲存在 Google 雲端硬碟中的檔案填入內容，系統不會針對文件編輯器或捷徑檔案填入資料。
`sha256Checksum`	`string` 僅供輸出。與這個檔案相關聯的 SHA256 總和檢查碼 (如果有的話)。這個欄位只會針對儲存在 Google 雲端硬碟中的檔案填入內容，系統不會針對文件編輯器或捷徑檔案填入資料。

ContentRestriction

存取檔案內容的限制。

JSON 表示法
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionTime": string, "ownerRestricted": boolean }

欄位
`readOnly`	`boolean` 檔案內容是否為唯讀狀態。如果檔案為唯讀狀態，則可能無法新增該檔案的修訂版本、註解可能無法新增或修改，且檔案標題也可能無法修改。
`reason`	`string` 檔案內容受限原因。只有在要求也設定 `readOnly=true` 時，才需要變動內容。
`type`	`string` 僅供輸出。內容限制的類型。目前唯一可能的值為 `globalContentRestriction`。
`restrictingUser`	`object (User)` 僅供輸出。負責設定內容限制的使用者。只有在 `readOnly` 為 true 時才會填入。
`restrictionTime`	`string` 僅供輸出。內容限制的設定時間 (格式化 RFC 3339 時間戳記)。只有在 `readOnly` 為 true 時才會填入。
`ownerRestricted`	`boolean` 內容限制是否只能由擁有檔案的使用者修改或移除。針對共用雲端硬碟中的檔案，凡是具備 `organizer` 權限的使用者，都可以修改或移除這項內容限制。

方法
`copy`	建立檔案副本，並使用 Patch 語意套用所有要求的更新。
`create`	建立新檔案。
`delete`	永久刪除使用者擁有的檔案，但不會將檔案移至垃圾桶。
`emptyTrash`	永久刪除使用者移至垃圾桶的所有檔案。
`export`	將 Google Workspace 文件匯出至要求的 MIME 類型，然後傳回匯出的位元組內容。
`generateIds`	產生一組檔案 ID，可在建立或複製要求中提供。
`get`	依 ID 取得檔案的中繼資料或內容。
`list`	列出使用者的檔案。
`listLabels`	列出檔案的標籤。
`modifyLabels`	修改套用至檔案的標籤組合。
`update`	更新檔案的中繼資料和/或內容。
`watch`	訂閱檔案變更。

REST Resource: files

資源：檔案

ContentRestriction

方法

`copy`

`create`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`