REST Resource: files

リソース: File

ファイルのメタデータ。

一部のリソース メソッド(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
  },
  "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

フルテキスト クエリを改善するために、ファイルのインデックスに登録されるテキスト。長さは 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 つのファイルに設定できる親フォルダは 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 進文字列)。サポートされている色は、概要リソースの 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 に設定されているショートカット ファイルに対してのみ入力されます。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 ドライブに保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルには挿入されません。

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

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

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

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

modifyLabels

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

update

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

watch

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