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 個半形字元，使用小寫英數字元或破折號 (-)，且開頭或結尾不得為連字號。如果建立時沒有名稱，系統會產生不重複的名稱。範例：files/123-456
displayName

string

選用設定。File 的使用者可理解的顯示名稱。顯示名稱的長度不得超過 512 個半形字元 (包含空格)。例如：「歡迎圖片」
mimeType

string

僅供輸出。檔案的 MIME 類型。
sizeBytes

string (int64 format)

僅供輸出。檔案大小 (以位元組為單位)。
createTime

string (Timestamp format)

僅供輸出。File 的建立時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。File 上次更新時的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
expirationTime

string (Timestamp format)

僅供輸出。刪除 File 的時間戳記。只有在 File 已排定到期時才會設定。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
sha256Hash

string (bytes format)

僅供輸出。已上傳位元組的 SHA-256 雜湊。

Base64 編碼的字串。
uri

string

僅供輸出。File 的 URI。

方法

delete

 刪除 File。

get

 取得指定 File 的中繼資料。

list

 列出要求專案擁有的 File 中繼資料。