REST Resource: snapshots

資源:Snapshot

快照物件。

JSON 表示法
{
  "id": string,
  "driveId": string,
  "kind": string,
  "type": enum (SnapshotType),
  "title": string,
  "description": string,
  "lastModifiedMillis": string,
  "durationMillis": string,
  "coverImage": {
    object (SnapshotImage)
  },
  "uniqueName": string,
  "progressValue": string
}
欄位
id

string

快照的 ID。

driveId

string

這個快照在 Drive API 中的檔案 ID。只有在快照為雲端硬碟檔案檢視,且檔案為呼叫者所有時,才會顯示。

kind

string

專門識別這個資源的類型。值一律為固定字串 games#snapshot

type

enum (SnapshotType)

這張快照的類型。

title

string

這張快照的標題。

description

string

這張快照的說明。

lastModifiedMillis

string (int64 format)

這張快照上次修改時間的時間戳記 (以毫秒為單位,自 Unix 紀元開始起算)。

durationMillis

string (int64 format)

與這張快照相關聯的時間長度 (以毫秒為單位)。

coverImage

object (SnapshotImage)

這張快照的封面圖片。如果沒有圖片,則可能不會顯示。

uniqueName

string

建立快照時提供的專屬名稱。

progressValue

string (int64 format)

與這張快照相關聯的進度值 (開發人員設定的 64 位元整數)。

SnapshotType

定義支援的快照類型。

列舉
SAVE_GAME 代表遊戲進度存檔的快照。

SnapshotImage

快照的圖片。

JSON 表示法
{
  "width": integer,
  "height": integer,
  "mime_type": string,
  "url": string,
  "kind": string
}
欄位
width

integer

圖片的寬度。

height

integer

圖片的高度。

mime_type

string

圖片的 MIME 類型。

url

string

圖片的網址。這個網址隨時都可能失效,因此不應快取。

kind

string

專門識別這個資源的類型。值一律為固定字串 games#snapshotImage

方法

get

擷取指定快照 ID 的中繼資料。

list

擷取應用程式為對應玩家 ID 所建立的玩家快照清單。