REST Resource: files

リソース: File

ファイルのメタデータ。

一部のリソース メソッド(files.update など)では fileId が必要です。files.list メソッドを使用して、ファイルの ID を取得します。

JSON 表現
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
フィールド
parents[]

string

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

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

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

owners[]

object (User)

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

permissions[]

object (Permission)

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

spaces[]

string

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

properties

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

すべてのアプリから見える任意の Key-Value ペアのコレクション。

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

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

appProperties

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

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

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

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

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

permissionIds[]

string

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

contentRestrictions[]

object (ContentRestriction)

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

kind

string

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

driveId

string

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

fileExtension

string

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

copyRequiresWriterPermission

boolean

閲覧者とコメント投稿者に対して、このファイルのコピー、印刷、ダウンロードのオプションを無効にするかどうか。

md5Checksum

string

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

contentHints

object

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

contentHints.indexableText

string

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

contentHints.thumbnail

object

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

contentHints.thumbnail.image

string (bytes format)

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

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

contentHints.thumbnail.mimeType

string

サムネイルの MIME タイプ。

writersCanShare

boolean

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

viewedByMe

boolean

出力専用。ファイルがこのユーザーによって閲覧されたかどうか。

mimeType

string

ファイルの MIME タイプ。

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

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

shared

boolean

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

lastModifyingUser

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

hasThumbnail

boolean

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

folderColorRgb

string

フォルダまたはフォルダへのショートカットの色。RGB 16 進数文字列で指定します。サポートされている色は、About リソースの 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)

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

version

string (int64 format)

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

originalFilename

string

アップロードされたコンテンツの元のファイル名(利用可能な場合)。利用できない場合は、name フィールドの元の値。これは、Google ドライブ内のバイナリ コンテンツを含むファイルでのみ使用できます。

ownedByMe

boolean

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

fullFileExtension

string

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

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

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

出力専用。現在のユーザーがこのファイルに対して持つ権限。各ケーパビリティは、ユーザーが実行する可能性のあるきめ細かいアクションに対応しています。

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

非推奨: 出力のみ。

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

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

非推奨: 出力のみ。canModifyEditorContentRestrictioncanModifyOwnerContentRestrictioncanRemoveContentRestriction のいずれかを使用します。

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

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

capabilities.canDisableInheritedPermissions

boolean

ユーザーが継承された権限を無効にできるかどうか。

capabilities.canEnableInheritedPermissions

boolean

ユーザーが継承された権限を再度有効にできるかどうか。

capabilities.canChangeItemDownloadRestriction

boolean

出力専用。現在のユーザーが、ファイルに適用されているオーナーまたは主催者によるダウンロード制限を変更できるかどうか。

hasAugmentedPermissions

boolean

出力専用。このファイルに直接権限が付与されているかどうか。このフィールドは、共有ドライブ内のアイテムにのみ入力されます。

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

出力専用。ファイルがこのユーザーによって変更されたかどうか。

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 DateTime)。

imageMediaMetadata.cameraMake

string

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

imageMediaMetadata.cameraModel

string

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

imageMediaMetadata.exposureTime

number

出力専用。露出時間(秒単位)。

imageMediaMetadata.aperture

number

出力専用。写真の作成に使用された絞り値(F 値)。

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 に設定されているショートカット ファイルに対してのみ値が入力されます。files.create リクエストでのみ設定できます。

shortcutDetails.targetId

string

このショートカットが指すファイルの ID。files.create リクエストでのみ設定できます。

shortcutDetails.targetMimeType

string

出力専用。このショートカットが指すファイルの MIME タイプ。このフィールドの値は、ショートカットの作成時にキャプチャされたターゲットの MIME タイプのスナップショットです。

shortcutDetails.targetResourceKey

string

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

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

出力専用。ファイルに設定されているラベルの概要。

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

inheritedPermissionsDisabled

boolean

このファイルで権限の継承が無効になっているかどうか。継承された権限はデフォルトで有効になっています。

downloadRestrictions

object (DownloadRestrictionsMetadata)

ファイルにダウンロードの制限が適用されています。

ContentRestriction

ファイルの内容へのアクセス制限。

JSON 表現
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
フィールド
readOnly

boolean

ファイルの内容が読み取り専用かどうか。ファイルが読み取り専用の場合、ファイルの新しいリビジョンを追加したり、コメントを追加または変更したり、ファイルのタイトルを変更したりすることはできません。

reason

string

ファイルの内容が制限されている理由。これは、readOnly=true も設定するリクエストでのみ変更可能です。

type

string

出力専用。コンテンツ制限のタイプ。現在、指定できる値は globalContentRestriction のみです。

restrictingUser

object (User)

出力専用。コンテンツ制限を設定したユーザー。readOnly が true の場合にのみ入力されます。

restrictionTime

string

出力専用。コンテンツ制限が設定された時刻(RFC 3339 タイムスタンプ形式)。readOnly が true の場合にのみ入力されます。

ownerRestricted

boolean

コンテンツの制限を、ファイルのオーナーのみが変更または削除できるかどうか。共有ドライブ内のファイルの場合、organizer の権限を持つユーザーは、このコンテンツ制限を変更または削除できます。

systemRestricted

boolean

出力専用。コンテンツの制限がシステムによって適用されたかどうか(電子署名など)。ユーザーは、システムで制限されたコンテンツの制限を変更または削除できません。

DownloadRestrictionsMetadata

ファイルにダウンロードの制限が適用されています。

JSON 表現
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
フィールド
itemDownloadRestriction

object (DownloadRestriction)

オーナーまたは主催者が直接適用したファイルのダウンロード制限。共有ドライブの設定や DLP ルールは考慮されません。

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

出力専用。このファイルに適用されている有効なダウンロード制限。すべての制限設定と DLP ルールが考慮されます。

DownloadRestriction

ファイルのコピーとダウンロードの制限。

JSON 表現
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
フィールド
restrictedForReaders

boolean

閲覧者に対してダウンロードとコピーが制限されているかどうか。

restrictedForWriters

boolean

編集者に対してダウンロードとコピーが制限されているかどうか。true の場合、読者によるダウンロードも制限されます。

メソッド

copy

ファイルのコピーを作成し、リクエストされた更新をパッチ セマンティクスで適用します。

create

新しいファイルを作成します。

delete

ファイルをゴミ箱に移動せずに、ユーザーが所有するファイルを完全に削除します。

download

ファイルの内容をダウンロードします。

emptyTrash

ユーザーのゴミ箱内のすべてのファイルを完全に削除します。

export

Google Workspace ドキュメントをリクエストされた MIME タイプにエクスポートし、エクスポートされたバイト コンテンツを返します。

generateIds

作成リクエストまたはコピー リクエストで指定できるファイル ID のセットを生成します。

get

ID を指定して、ファイルのメタデータまたはコンテンツを取得します。

list

ユーザーのファイルの一覧を取得します。

listLabels

ファイルに設定されているラベルを一覧表示します。

modifyLabels

ファイルに適用されているラベルのセットを変更します。

update

ファイルのメタデータまたはコンテンツを更新します。

watch

ファイルへの変更の通知を受け取ります。