REST Resource: files

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

string

出力専用。リソースの種類を指定します。値: 固定文字列 "drive#file"。

string

出力専用。ファイルがある共有ドライブの ID。共有ドライブ内のアイテムに対してのみ入力されます。

string

出力専用。fullFileExtension の最後のコンポーネント。この機能は、Google ドライブ内のバイナリ コンテンツを含むファイルでのみ利用できます。

boolean

閲覧者や閲覧者（コメント可）に対して、このファイルをコピー、印刷、ダウンロードするオプションを無効にするかどうかを指定します。

string

出力専用。ファイルの内容に対する MD5 チェックサムこれは、Google ドライブ内のバイナリ コンテンツを含むファイルにのみ適用されます。

object

ファイルの内容に関する追加情報。これらのフィールドにレスポンスが挿入されることはありません。

string

フルテキスト クエリを改善するために、ファイルのインデックスに登録されるテキスト。長さは 128 KB に制限されており、HTML 要素を含めることができます。

object

ファイルのサムネイル。Google ドライブで標準のサムネイルを生成できない場合にのみ使用されます。

string (bytes format)

URL セーフの Base64（RFC 4648 セクション 5）でエンコードされたサムネイル データ。

Base64 でエンコードされた文字列。

string

サムネイルの MIME タイプ。

boolean

writer 権限のみを持つユーザーに、ファイルの権限の変更を許可するかどうか。共有ドライブ内のアイテムにはデータが入力されません。

boolean

出力専用。このユーザーがファイルを閲覧したかどうか。

string

ファイルの MIME タイプ。

値が指定されていない場合、Google ドライブはアップロードされたコンテンツから適切な値を自動的に検出しようとします。この値を変更するには、新しいリビジョンをアップロードする必要があります。

Google ドキュメントの MIME タイプでファイルを作成した場合、可能であれば、アップロードされたコンテンツがインポートされます。サポートされているインポート形式は、概要リソースで公開されています。

map (key: string, value: string)

出力専用。ドキュメント エディタ ファイルを特定の形式にエクスポートするためのリンク。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

string

ファイルを含む親フォルダの ID。

1 つのファイルに設定できる親フォルダは 1 つのみです。複数の親を指定することはできません。

作成リクエストで指定されていない場合、ファイルはユーザーの [マイドライブ] フォルダに直接配置されます。コピー リクエストで指定されていない場合、ファイルは、ソースファイルの検出可能な親を継承します。files.update リクエストでは、addParents パラメータと removeParents パラメータを使用して親リストを変更する必要があります。

string

出力専用。ファイルのサムネイルへの有効期間の短いリンク（利用可能な場合）。通常、数時間程度で終了します。クロスオリジン リソース シェアリング（CORS）ポリシーのため、ウェブ アプリケーションで直接使用することは想定されていません。プロキシ サーバーの使用を検討してください。リクエスト元のアプリがファイルのコンテンツにアクセスできる場合にのみ入力されます。ファイルが一般公開で共有されていない場合、Files.thumbnailLink で返される URL は、認証されたリクエストを使用して取得する必要があります。

string

出力専用。ファイルのアイコンへの未認証の静的なリンク。

boolean

出力専用。ファイルが共有されているかどうか。共有ドライブ内のアイテムにはデータが入力されません。

object (User)

出力専用。ファイルを変更した最後のユーザー。このフィールドは、ログイン ユーザーによって最終更新が行われた場合にのみ入力されます。

object (User)

出力専用。このファイルのオーナー。複数のオーナーを設定できるのは、以前の特定のファイルのみです。共有ドライブ内のアイテムでは、このフィールドに値は入力されません。

string

出力専用。ファイルのヘッド リビジョンの ID。現在のところ、この機能は Google ドライブ内のバイナリ コンテンツを含むファイルでのみ利用できます。

object (User)

出力専用。リクエスト元のユーザーとファイルを共有したユーザー（該当する場合）。

string

出力専用。関連する Google エディタまたはブラウザのビューアでファイルを開くためのリンク。

string

出力専用。ブラウザでファイルのコンテンツをダウンロードするためのリンク。この機能は、Google ドライブ内のバイナリ コンテンツを含むファイルでのみ利用できます。

string (int64 format)

出力専用。blob とファーストパーティ エディタ ファイルのサイズ（バイト単位）。ショートカットやフォルダなど、サイズのないファイルにはデータが入力されません。

boolean

非推奨: 代わりに copyRequiresWriterPermission を使用してください。

object (Permission)

出力専用。ファイルの権限の完全なリスト。この操作は、リクエスト元のユーザーがファイルを共有できる場合にのみ使用できます。共有ドライブ内のアイテムにはデータが入力されません。

boolean

出力専用。このファイルにサムネイルがあるかどうか。リクエスト元のアプリがサムネイルにアクセスできるかどうかを示すものではありません。アクセス権を確認するには、ThumbnailLink フィールドを探します。

string

出力専用。ファイルを含むスペースのリスト。現在サポートされている値は「drive」、「appDataFolder」です。「photos」などです。

string

フォルダまたはフォルダへのショートカットの色（RGB 16 進文字列）。サポートされている色は、概要リソースの folderColorPalette フィールドで公開されています。

サポートされていない色が指定された場合、パレット内で最も近い色が代わりに使用されます。

string

ファイルの ID。

string

ファイルの名前。フォルダ内で一意であるとは限りません。共有ドライブの最上位フォルダ、マイドライブのルートフォルダ、アプリケーション データ フォルダなど、不変のアイテムの名前は不変であることにご注意ください。

string

ファイルの簡単な説明。

boolean

ユーザーがファイルにスターを付けたかどうか。

boolean

ファイルが明示的にゴミ箱に移動したか、ゴミ箱内の親フォルダからゴミ箱に移動したか。ファイルをゴミ箱に移動できるのはオーナーのみであり、他のユーザーはオーナーのゴミ箱内のファイルを表示できません。

boolean

出力専用。ファイルが親フォルダから再帰的にゴミ箱に移動したかどうかではなく、明示的にゴミ箱に移動したかどうか。

string

ファイルが作成された時刻（RFC 3339 の日時）。

string

いずれかのユーザーが最後にファイルを変更した時刻（RFC 3339 の日時）。

modifiedTime を設定すると、ユーザーの modifiedByMeTime も更新されることに注意してください。

string

出力専用。ユーザーによってファイルが最後に変更された時刻（RFC 3339 の日時）。

string

ユーザーが最後にファイルを閲覧した時刻（RFC 3339 の日時）。

string

出力専用。ファイルがユーザーと共有された時刻（該当する場合、RFC 3339 の日時）。

string (int64 format)

出力専用。ファイルで使用されている保存容量のバイト数。これには、ヘッド リビジョンと、keepForever を有効にした以前のリビジョンが含まれます。

string (int64 format)

出力専用。単調に増加するファイルのバージョン番号。サーバー上のファイルに加えられたすべての変更が反映されます。これには、ユーザーには表示されない変更も含まれます。

string

アップロードされたコンテンツの元のファイル名（存在する場合）、または name フィールドの元の値。この機能は、Google ドライブ内のバイナリ コンテンツを含むファイルでのみ利用できます。

boolean

出力専用。ユーザーがファイルを所有しているかどうか。共有ドライブ内のアイテムにはデータが入力されません。

string

出力専用。name フィールドから抽出された完全なファイル拡張子。「tar.gz」のように複数の拡張機能が連結されている場合があります。この機能は、Google ドライブ内のバイナリ コンテンツを含むファイルでのみ利用できます。

これは、name フィールドが変更されると自動的に更新されますが、新しい名前に有効な拡張子が含まれていない場合はクリアされません。

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

すべてのアプリに表示される任意の Key-Value ペアのコレクション。

null 値を含むエントリは、更新リクエストとコピー リクエストでクリアされます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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

リクエスト元のアプリ専用の任意の Key-Value ペアのコレクション。

null 値を含むエントリは、更新リクエストとコピー リクエストでクリアされます。

これらのプロパティは、認証済みのリクエストでのみ取得できます。認証済みリクエストでは、OAuth 2 クライアント ID で取得したアクセス トークンを使用します。API キーを使用して非公開プロパティを取得することはできません。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

boolean

出力専用。ファイルがリクエスト元のアプリによって作成または開かれたかどうかを示します。

string

非推奨: 出力のみ。driveId を代わりに使用してください。

object

出力専用。このファイルに対して現在のユーザーが持っている機能。各ケーパビリティは、ユーザーが行うことができるきめ細かいアクションに対応しています。

boolean

非推奨: 出力のみ。

boolean

出力専用。現在のユーザーがこのフォルダの子を共有ドライブ外に移動できるかどうか。アイテムがフォルダでない場合は false です。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

出力専用。現在のユーザーが、このファイルが属する共有ドライブを読み取ることができるかどうか。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

出力専用。現在のユーザーがこのファイルを編集できるかどうか。ユーザーがファイルに対して行える変更の種類は、他の要因によって制限されることがあります。たとえば、canChangeCopyRequiresWriterPermission や canModifyContent をご覧ください。

boolean

出力専用。現在のユーザーがこのファイルをコピーできるかどうか。共有ドライブ内のアイテムについて、現在のユーザーがこのアイテムのフォルダ以外の子孫をコピーできるかどうか、フォルダ以外の場合はこのアイテム自体をコピーできるかどうか。

boolean

出力専用。現在のユーザーがこのファイルにコメントできるかどうか。

boolean

出力専用。現在のユーザーがこのフォルダに子を追加できるかどうか。アイテムがフォルダでない場合、常に false になります。

boolean

出力専用。現在のユーザーがこのファイルを削除できるかどうか。

boolean

出力専用。現在のユーザーがこのファイルをダウンロードできるかどうか。

boolean

出力専用。現在のユーザーがこのフォルダの子を一覧表示できるかどうか。アイテムがフォルダでない場合、常に false になります。

boolean

出力専用。現在のユーザーがこのフォルダから子を削除できるかどうか。アイテムがフォルダでない場合、常に false になります。共有ドライブ内のフォルダの場合は、代わりに canDeleteChildren または canTrashChildren を使用します。

boolean

出力専用。現在のユーザーがこのファイルの名前を変更できるかどうか。

boolean

出力専用。現在のユーザーがこのファイルをゴミ箱に移動できるかどうかを指定します。

boolean

出力専用。現在のユーザーがこのファイルのリビジョン リソースを読み取れるかどうか。共有ドライブ内のアイテムについては、このアイテムのフォルダ以外の子孫の版、またはフォルダ以外の場合はこのアイテム自体の版も読み取ることができます。

boolean

非推奨: 出力のみ。canReadDrive を代わりに使用してください。

boolean

非推奨: 出力のみ。代わりに canMoveItemWithinDrive または canMoveItemOutOfDrive を使用してください。

boolean

出力専用。現在のユーザーがこのファイルの copyRequiresWriterPermission 制限を変更できるかどうか。

boolean

非推奨: 出力のみ。canMoveItemOutOfDrive を代わりに使用してください。

boolean

出力専用。現在のユーザーがこのファイルをゴミ箱から復元できるかどうか。

boolean

出力専用。現在のユーザーがこのファイルの内容を変更できるかどうか。

boolean

非推奨: 出力のみ。canMoveItemWithinDrive を代わりに使用してください。

boolean

非推奨: 出力のみ。canMoveItemOutOfDrive を代わりに使用してください。

boolean

出力専用。現在のユーザーがこのフォルダの子を削除できるかどうか。アイテムがフォルダでない場合は false です。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

非推奨: 出力のみ。canMoveChildrenOutOfDrive を代わりに使用してください。

boolean

非推奨: 出力のみ。canMoveChildrenWithinDrive を代わりに使用してください。

boolean

出力専用。現在のユーザーがこのフォルダの子をゴミ箱に移動できるかどうか。アイテムがフォルダでない場合は false です。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

出力専用。現在のユーザーが、親を変更することでこのアイテムをこのドライブの外に移動できるかどうか。追加する新しい親によっては、アイテムの親の変更リクエストが失敗する場合があります。

boolean

出力専用。同じリクエストで既存の親を削除せずに、現在のユーザーがアイテムの親を追加できるかどうか。共有ドライブのファイルには入力されません。

boolean

出力専用。同じリクエストで別の親を追加せずに、現在のユーザーがアイテムから親を削除できるかどうか。共有ドライブのファイルには入力されません。

boolean

出力専用。現在のユーザーがこのドライブ内でこのアイテムを移動できるかどうか。追加する新しい親や削除する親によっては、アイテムの親の変更リクエストが失敗する場合があります。

boolean

出力専用。現在のユーザーがこのファイルの共有設定を変更できるかどうか。

boolean

出力専用。現在のユーザーが、このドライブ内でこのフォルダの子を移動できるかどうか。アイテムがフォルダでない場合は false です。子と移動先フォルダに対する現在のユーザーのアクセス権によっては、子の移動リクエストが失敗する場合があります。

boolean

非推奨: 出力のみ。canModifyEditorContentRestriction、canModifyOwnerContentRestriction、canRemoveContentRestriction のいずれかを使用します。

boolean

出力専用。現在のユーザーが、別のドライブ（別の共有ドライブまたはマイドライブ）からこのフォルダにフォルダを追加できるかどうか。アイテムがフォルダでない場合は false です。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

出力専用。現在のユーザーがリンク共有メタデータの securityUpdateEnabled フィールドを変更できるかどうか。

boolean

出力専用。現在のユーザーがファイルの保留中のオーナーであるかどうか共有ドライブのファイルには入力されません。

boolean

出力専用。現在のユーザーがファイルのラベルを読み取れるかどうか。

boolean

出力専用。現在のユーザーがファイルのラベルを変更できるかどうか。

boolean

出力専用。編集者による制限を受けているファイルのコンテンツ制限を現在のユーザーが追加または変更できるかどうか。

boolean

出力専用。所有者による制限付きコンテンツの制限を現在のユーザーが追加または変更できるかどうか。

boolean

出力専用。現在のユーザーが削除できるコンテンツの制限がファイルにあるかどうか。

boolean

出力専用。このファイルに直接権限があるかどうか。この項目は、共有ドライブ内のアイテムに対してのみ入力されます。

object (User)

出力専用。ファイルが明示的にゴミ箱に移動した場合は、そのファイルをゴミ箱に移動したユーザー。共有ドライブ内のアイテムに対してのみ入力されます。

string (int64 format)

出力専用。サムネイル キャッシュの無効化に使用するサムネイルのバージョン。

string

出力専用。アイテムがゴミ箱に移動された時刻（RFC 3339 の日付時刻）。共有ドライブ内のアイテムに対してのみ入力されます。

boolean

出力専用。このユーザーがファイルを変更したかどうか。

string

出力専用。このファイルにアクセスできるユーザーの権限 ID の files.list。

object

出力専用。画像メディアに関する追加のメタデータ（利用可能な場合）。

boolean

出力専用。写真の作成にフラッシュを使用したかどうか。

string

出力専用。写真の作成に使用された測光モード。

string

出力専用。写真の作成に使用されたセンサーのタイプ。

string

出力専用。写真の作成に使用された露出モード。

string

出力専用。写真の色空間。

string

出力専用。写真の作成に使用するホワイト バランス モード。

integer

出力専用。画像の幅（ピクセル単位）。

integer

出力専用。画像の高さ（ピクセル単位）。

object

出力専用。画像に保存されている地理的な位置情報。

number

出力専用。画像に格納されている緯度。

number

出力専用。画像に保存されている経度。

number

出力専用。画像に格納されている高度。

integer

出力専用。画像の元の向きから時計回りに 90 度回転した回数。

string

出力専用。写真の撮影日時（EXIF DateTime）。

string

出力専用。写真の作成に使用されたカメラのメーカー。

string

出力専用。写真の作成に使用されたカメラのモデル。

number

出力専用。露出の長さ（秒単位）。

number

出力専用。写真の作成に使用する絞り値（F 値）。

number

出力専用。写真の作成に使用されたレンズ焦点距離（ミリメートル単位）。

integer

出力専用。写真の作成に使用する ISO 速度。

number

出力専用。写真の露出バイアス（APEX 値）。

number

出力専用。写真の作成に使用された焦点距離におけるレンズの最小 f 番号（APEX 値）。

integer

出力専用。写真の被写体までの距離（メートル単位）。

string

出力専用。写真の作成に使用されたレンズ。

object

出力専用。動画メディアに関する追加のメタデータ。アップロード後すぐには利用できない場合があります。

integer

出力専用。動画の幅（ピクセル単位）。

integer

出力専用。動画の高さ（ピクセル単位）。

string (int64 format)

出力専用。動画の再生時間（ミリ秒単位）。

object

ショートカット ファイルの詳細。mimeType フィールドが application/vnd.google-apps.shortcut に設定されているショートカット ファイルに対してのみ入力されます。files.create リクエストに対してのみ設定できます。

string

このショートカットが参照するファイルの ID。files.create リクエストに対してのみ設定できます。

string

出力専用。このショートカットが参照するファイルの MIME タイプ。このフィールドの値は、ショートカットの作成時に取得される、ターゲットの MIME タイプのスナップショットです。

string

出力専用。ターゲット ファイルの ResourceKey。

object (ContentRestriction)

ファイルのコンテンツへのアクセスに関する制限。このような制限が存在する場合にのみ入力されます。

string

出力専用。共有リンク経由でアイテムにアクセスするために必要なキー。

object

出力専用。LinkShare 関連の詳細情報。クライアントがこのアイテムを参照するために使用しているリンク URL の詳細が含まれます。

boolean

出力専用。ファイルがセキュリティ アップデートの対象かどうか

boolean

出力専用。このファイルのセキュリティ アップデートが有効になっているかどうか。

object

出力専用。ファイルのラベルの概要。

object (Label)

出力専用。includeLabels パラメータのラベル ID によってリクエストされた、ファイル上のラベルのセット。デフォルトでは、ラベルは返されません。

string

出力専用。このファイルに関連付けられた SHA1 チェックサム（利用可能な場合）。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

string

出力専用。このファイルに関連付けられている SHA256 チェックサム（利用可能な場合）。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。