REST Resource: files

リソース: ファイル

ファイルのメタデータ。

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

JSON 表現
{
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}
フィールド
kind

string

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

driveId

string

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

fileExtension

string

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

copyRequiresWriterPermission

boolean

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

md5Checksum

string

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

contentHints

object

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

contentHints.indexableText

string

全文検索のクエリの精度を高めるために、ファイルにインデックスを付けるテキスト。長さは 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 タイプで作成されている場合、アップロードされたコンテンツは可能であればインポートされます。サポートされているインポート形式については、概要リソースをご覧ください。

parents[]

string

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

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

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

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

permissions[]

object (Permission)

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

hasThumbnail

boolean

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

spaces[]

string

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

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

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

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

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

permissionIds[]

string

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

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

出力専用。写真の作成に使用された焦点距離におけるレンズの最小絞り値(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。

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)
  },
  "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

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

メソッド

copy

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

create

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

delete

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

download

ファイルのコンテンツをダウンロードします。

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

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

modifyLabels

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

update

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

watch

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