REST Resource: files

リソース: ファイル

ファイルのメタデータ。

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

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
  },
  "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
}
フィールド
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 タイプで作成されている場合、アップロードしたコンテンツは可能な限りインポートされます。サポートされているインポート形式は [概要] リソースで公開されています。

parents[]

string

ファイルが格納されている親フォルダの ID。

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

shared

boolean

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

lastModifyingUser

object (User)

出力のみ。ファイルを変更する最後のユーザー。

owners[]

object (User)

出力のみ。このファイルのオーナー。以前のオーナーのファイルのみ複数のオーナーになる場合があります。このフィールドは、共有ドライブ内のアイテムに対して入力されていません。

headRevisionId

string

出力のみ。ファイルの head リビジョンの ID。現在のところ、Google ドライブでバイナリ コンテンツを使用しているファイルにのみ利用できます。

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

permissions[]

object (Permission)

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

hasThumbnail

boolean

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

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)

出力のみ。ファイルによって使用されるストレージ割り当てバイト数。これには、ヘッド リビジョンと、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

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

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

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

コンテンツの制限

ファイルのコンテンツへのアクセスに関する制限。

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

boolean

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

reason

string

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

type

string

出力のみ。コンテンツの制限の種類。現在、有効な値は globalContentRestriction のみです。

restrictingUser

object (User)

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

restrictionTime

string

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

ownerRestricted

boolean

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

Methods

copy

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

create

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

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

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

modifyLabels

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

update

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

watch

ファイルの変更に登録します。