REST Resource: files

リソース: File

API にアップロードされたファイル。

JSON 表現
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string
}
フィールド
name

string

変更不可。ID。File リソース名。ID(「files/」接頭辞を除いた名前)の最大文字数は 40 文字で、小文字の英数字またはダッシュ(-)です。ID の先頭または末尾をダッシュにすることはできません。作成時に名前が空の場合、一意の名前が生成されます。例: files/123-456

displayName

string

省略可。File の人が読める形式の表示名。表示名は、スペースを含めて 512 文字以下にする必要があります。例: 「ウェルカム画像」

mimeType

string

出力のみ。ファイルの MIME タイプ。

sizeBytes

string (int64 format)

出力のみ。ファイルのサイズ(バイト単位)。

createTime

string (Timestamp format)

出力のみ。File が作成されたときのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

出力のみ。File が最後に更新されたときのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

expirationTime

string (Timestamp format)

出力のみ。File が削除されるときのタイムスタンプ。File の有効期限が予定されている場合にのみ設定されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

sha256Hash

string (bytes format)

出力のみ。アップロードされたバイトの SHA-256 ハッシュ。

Base64 でエンコードされた文字列。

uri

string

出力のみ。File の URI。

Methods

delete

File を削除します。

get

指定された File のメタデータを取得します。

list

リクエスト元のプロジェクトが所有する File のメタデータを一覧表示します。