REST Resource: files

リソース: File

ファイルのメタデータ。

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

JSON 表現
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
フィールド
ownerNames[]

string

出力専用。このファイルのオーナーの名前。共有ドライブ内のアイテムには入力されません。

parents[]

object (ParentReference)

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

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

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

owners[]

object (User)

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

properties[]

object (Property)

プロパティのリスト。

permissions[]

object (Permission)

出力専用。このファイルにアクセスできるユーザーの権限のリスト。共有ドライブ内のアイテムには入力されません。

spaces[]

string

出力専用。ファイルを含むスペースのリスト。サポートされる値は driveappDataFolderphotos です。

permissionIds[]

string

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

contentRestrictions[]

object (ContentRestriction)

ファイルの内容へのアクセスに関する制限。このような制限が存在する場合にのみ入力されます。

kind

string

出力専用。ファイルの種類。これは常に drive#file です。

userPermission

object (Permission)

出力専用。このファイルに対する認証済みユーザーの権限。

fileExtension

string

出力専用。末尾のテキストが拡張子の一部ではないと思われる fullFileExtension の最後のコンポーネント。このフィールドは、Google ドライブにコンテンツが保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルに対しては入力されません。

md5Checksum

string

出力専用。このファイルの内容の MD5 チェックサム。このフィールドは、Google ドライブにコンテンツが保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルに対しては入力されません。

lastModifyingUserName

string

出力専用。このファイルを最後に変更したユーザーの名前。

editable
(deprecated)

boolean

出力専用。非推奨: 代わりに、capabilities/canEdit を使用してください。

writersCanShare

boolean

ライターが他のユーザーとドキュメントを共有できるかどうか。共有ドライブ内のアイテムには入力されません。

downloadUrl

string

出力専用。ファイルの有効期間の短いダウンロード URL。このフィールドは、コンテンツが Google ドライブに保存されているファイルに対してのみ入力されます。Google ドキュメントやショートカット ファイルに対しては入力されません。

mimeType

string

ファイルの MIME タイプ。新しいコンテンツをアップロードする際の更新時にのみ変更可能です。このフィールドは空白のままにできます。その場合、アップロードされたコンテンツの MIME タイプから MIME タイプが決定されます。

driveId

string

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

appDataContents

boolean

出力専用。このファイルが Application Data フォルダにあるかどうか。

shared

boolean

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

lastModifyingUser

object (User)

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

headRevisionId

string

出力専用。ファイルのヘッド リビジョンの ID。このフィールドは、Google ドライブにコンテンツが保存されているファイルに対してのみ入力されます。ドキュメント エディタやショートカット ファイルに対しては入力されません。

copyable
(deprecated)

boolean

出力専用。非推奨: 代わりに、capabilities/canCopy を使用してください。

etag

string

出力専用。ファイルの ETag。

sharingUser

object (User)

出力専用。アイテムを現在のユーザーと共有したユーザー(利用可能な場合)。

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

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

hasThumbnail

boolean

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

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 タイムスタンプ形式)。共有ドライブ内のアイテムにのみ入力されます。

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

出力専用。写真の作成に使用された焦点距離におけるレンズの最小 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.insert リクエストでのみ設定できます。

shortcutDetails.targetId

string

このショートカットが指すファイルの ID。files.insert リクエストでのみ設定できます。

shortcutDetails.targetMimeType

string

出力専用。このショートカットが指すファイルの MIME タイプ。このフィールドの値は、ショートカットの作成時にキャプチャされたターゲットの MIME タイプのスナップショットです。

shortcutDetails.targetResourceKey

string

出力専用。ターゲット ファイルの ResourceKey。

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

ファイルへの変更の通知を受け取ります。