REST Resource: files

リソース: ファイル

ファイルのメタデータ。

一部のリソース メソッド(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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}
フィールド
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)

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

ファイルの親フォルダは 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 を設定すると、日付を設定したユーザーの 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

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

capabilities.canDisableInheritedPermissions

boolean

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

capabilities.canEnableInheritedPermissions

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

出力専用。写真の作成に使用された焦点距離におけるレンズの最小絞り値(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 ドライブにコンテンツが保存されているファイルにのみ値が入力されます。ドキュメント エディタやショートカット ファイルには値が入力されません。

inheritedPermissionsDisabled

boolean

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

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

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