REST Resource: files

リソース: File

ファイルのメタデータ。

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

JSON 表現
{
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": 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)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": 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 です。

userPermission

object (Permission)

出力専用。このファイルに対する認証済みユーザーの権限。

fileExtension

string

出力専用。拡張機能の一部ではないと思われる末尾のテキストを含む fullFileExtension の最後のコンポーネントを削除しました。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

md5Checksum

string

出力専用。このファイルの内容の MD5 チェックサム。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

ownerNames[]

string

出力専用。このファイルのオーナーの名前。共有ドライブ内のアイテムにはデータが入力されません。

lastModifyingUserName

string

出力専用。このファイルを変更した最後のユーザーの名前。

editable
(deprecated)

boolean

出力専用。非推奨: 代わりに capabilities/canEdit を使用してください。

writersCanShare

boolean

ライターが他のユーザーとドキュメントを共有できるかどうか。共有ドライブ内のアイテムにはデータが入力されません。

downloadUrl

string

出力専用。ファイルの有効期間の短いダウンロード URL。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。Google ドキュメントやショートカット ファイルでは入力されません。

mimeType

string

ファイルの MIME タイプ。これは、新しいコンテンツをアップロードするときの更新時にのみ変更できます。このフィールドは空白のままにできます。その場合、MIME タイプは、アップロードされたコンテンツの MIME タイプから決定されます。

driveId

string

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

parents[]

object (ParentReference)

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

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

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

appDataContents

boolean

出力専用。このファイルが Application Data フォルダ内にあるかどうか。

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

出力専用。ファイルのヘッド リビジョンの ID。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

properties[]

object (Property)

プロパティのリスト。

copyable
(deprecated)

boolean

出力専用。非推奨: 代わりに capabilities/canCopy を使用してください。

etag

string

出力専用。ファイルの ETag。

sharingUser

object (User)

出力専用。現在のユーザーとアイテムを共有したユーザー(利用可能な場合)。

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

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

permissions[]

object (Permission)

出力専用。このファイルにアクセスできるユーザーの権限のリスト。共有ドライブ内のアイテムにはデータが入力されません。

hasThumbnail

boolean

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

spaces[]

string

出力専用。ファイルを含むスペースのリスト。サポートされる値は driveappDataFolderphotos です。

folderColorRgb

string

ファイルがフォルダまたはフォルダへのショートカットの場合は、フォルダの色(RGB 16 進文字列)。サポートされている色のリストは、About リソースの folderColorPalette フィールドから入手できます。サポートされていない色を指定すると、パレット内で最も近い色に変更されます。

id

string

ファイルの ID。

title

string

このファイルのタイトル。共有ドライブの最上位フォルダ、マイドライブのルートフォルダ、アプリケーション データ フォルダなど、不変のアイテムの場合、タイトルは固定されます。

description

string

ファイルの簡単な説明。

labels

object

ファイルのラベルのグループ。

labels.viewed

boolean

このユーザーがこのファイルを閲覧済みかどうか。

labels.restricted
(deprecated)

boolean

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

labels.starred

boolean

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

labels.hidden
(deprecated)

boolean

出力専用。サポート終了。

labels.trashed

boolean

このファイルがゴミ箱に移動されているかどうか。このラベルは、ファイルにアクセスするすべてのユーザーに適用されます。ファイルを表示、ゴミ箱から復元できるのはオーナーのみです。

labels.modified

boolean

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

explicitlyTrashed

boolean

出力専用。このファイルが再帰的ではなく、明示的にゴミ箱に移動されたかどうか。

createdDate

string

出力専用。このファイルの作成時刻(フォーマットされた RFC 3339 タイムスタンプ)。

modifiedDate

string

このファイルが最後に変更された時刻(フォーマットされた RFC 3339 タイムスタンプ)。これは、setModifiedDate パラメータが設定されている更新時にのみ変更できます。

modifiedByMeDate

string

出力専用。ユーザーがこのファイルを最後に変更した時刻(形式の RFC 3339 タイムスタンプ)。なお、ModifiedDate を設定すると、その日付を設定したユーザーの ModifyedByMe 日付も更新されます。

lastViewedByMeDate

string

ユーザーがこのファイルを最後に閲覧した時刻(フォーマットされた RFC 3339 タイムスタンプ)。

markedViewedByMeDate
(deprecated)

string

出力専用。サポート終了。

sharedWithMeDate

string

出力専用。このファイルがユーザーと共有された時刻(RFC 3339 タイムスタンプの形式)。

quotaBytesUsed

string (int64 format)

出力専用。このファイルで使用されている割り当てバイト数。

version

string (int64 format)

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

indexableText

object

インデックス登録可能なファイルのテキスト属性(書き込みのみ可能)

indexableText.text

string

このファイルに対してインデックス登録されるテキスト。

originalFilename

string

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

ownedByMe

boolean

出力専用。ファイルのオーナーが現在のユーザーかどうか。共有ドライブ内のアイテムにはデータが入力されません。

canComment
(deprecated)

boolean

出力専用。非推奨: 代わりに capabilities/canComment を使用してください。

shareable
(deprecated)

boolean

出力専用。非推奨: 代わりに capabilities/canShare を使用してください。

fullFileExtension

string

出力専用。完全なファイル拡張子。表示されます。「tar.gz」のように複数の拡張機能が連結されている場合があります。タイトルから拡張機能を削除しても、このフィールドはクリアされません。ただし、タイトルの拡張子を変更するとこのフィールドが更新されます。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeRestrictedDownload
(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

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

canReadRevisions
(deprecated)

boolean

出力専用。非推奨: 代わりに capabilities/canReadRevisions を使用してください。

thumbnailVersion

string (int64 format)

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

trashedDate

string

出力専用。商品アイテムがゴミ箱に移動した時刻(RFC 3339 形式のタイムスタンプ)。共有ドライブ内のアイテムに対してのみ入力されます。

permissionIds[]

string

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

thumbnail

object

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

thumbnail.image

string (bytes format)

サムネイル画像の URL 用 Base64 でエンコードされたバイト。RFC 4648 セクション 5 に準拠している必要があります。

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

thumbnail.mimeType

string

サムネイルの MIME タイプ。

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.date

string

出力専用。写真の撮影日時(EXIF 形式のタイムスタンプ)。

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.insert リクエストに対してのみ設定できます。

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

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

contentRestrictions[]

object (ContentRestriction)

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

resourceKey

string

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

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)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
フィールド
readOnly

boolean

ファイルのコンテンツが読み取り専用かどうか。ファイルが読み取り専用の場合、ファイルの新しいリビジョンの追加、コメントの追加や変更、ファイルのタイトルの変更はできません。

reason

string

ファイルのコンテンツが制限されている理由。これを変更できるのは、readOnly=true も設定しているリクエストでのみです。

type

string

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

restrictingUser

object (User)

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

restrictionDate

string

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

ownerRestricted

boolean

コンテンツの制限を変更、削除できるのは、ファイルを所有しているユーザーのみかどうかを指定します。共有ドライブ内のファイルについては、organizer 権限を持つユーザーは誰でも、このコンテンツの制限を変更または解除できます。

systemRestricted

boolean

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

メソッド

copy

指定されたファイルのコピーを作成します。

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

insert

新しいファイルを挿入します。

list

ユーザーのファイルを一覧表示します。

listLabels

ファイルのラベルを一覧表示します。

modifyLabels

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

patch

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

touch

ファイルの更新時刻を現在のサーバー時刻に設定します。

trash

ファイルをゴミ箱に移動します。

untrash

ゴミ箱からファイルを復元します。

update

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

watch

ファイルの変更を通知します。