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 タイプ。これは、新しいコンテンツをアップロードするときのみ更新時に変更できます。このフィールドは空白のままにできます。mimetype はアップロードされたコンテンツの MIME タイプから判断されます。

driveId

string

出力のみ。ファイルが存在する共有ドライブの ID。共有ドライブ内のアイテムに対してのみデータが入力されます。

parents[]

object (ParentReference)

このファイルを含む親フォルダのコレクション。

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

appDataContents

boolean

出力のみ。このファイルがアプリケーション データ フォルダにあるかどうか。

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

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

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 を設定すると、日付を設定したユーザーの ModifiedByMe 日付も更新されます。

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 のリスト。

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 に設定されているショートカット ファイルに対してのみ入力されます。

shortcutDetails.targetId

string

このショートカットが指すファイルの ID。

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

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

Methods

copy

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

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

insert

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

list

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

listLabels

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

modifyLabels

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

patch

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

touch

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

trash

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

untrash

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

update

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

watch

ファイルの変更に対してサブスクライブします。