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

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

出力のみ。ファイルのヘッド リビジョンの 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 進文字列で指定します)。サポートされている色は、概要リソースの 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 のリスト。

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 ドライブに保存されているコンテンツを含むファイルのみです。ドキュメント エディタやショートカット ファイルについては入力されません。

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

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

Methods

copy

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

create

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

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

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

modifyLabels

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

update

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

watch

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