REST Resource: snapshots
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:快照
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 位元整數)。
|
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 。
|
方法 |
|
擷取指定快照 ID 的中繼資料。 |
|
針對與玩家 ID 相對應的玩家,擷取應用程式建立的快照清單。 |
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# REST Resource: snapshots\n\n- [Resource: Snapshot](#Snapshot)\n - [JSON representation](#Snapshot.SCHEMA_REPRESENTATION)\n- [SnapshotType](#SnapshotType)\n- [SnapshotImage](#SnapshotImage)\n - [JSON representation](#SnapshotImage.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Snapshot\n------------------\n\nAn snapshot object.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"driveId\": string, \"kind\": string, \"type\": enum (/games/services/web/api/rest/v1/snapshots#SnapshotType), \"title\": string, \"description\": string, \"lastModifiedMillis\": string, \"durationMillis\": string, \"coverImage\": { object (/games/services/web/api/rest/v1/snapshots#SnapshotImage) }, \"uniqueName\": string, \"progressValue\": string } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` The ID of the snapshot. |\n| `driveId` | `string` The ID of the file underlying this snapshot in the Drive API. Only present if the snapshot is a view on a Drive file and the file is owned by the caller. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#snapshot`. |\n| `type` | `enum (`[SnapshotType](/games/services/web/api/rest/v1/snapshots#SnapshotType)`)` The type of this snapshot. |\n| `title` | `string` The title of this snapshot. |\n| `description` | `string` The description of this snapshot. |\n| `lastModifiedMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The timestamp (in millis since Unix epoch) of the last modification to this snapshot. |\n| `durationMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The duration associated with this snapshot, in millis. |\n| `coverImage` | `object (`[SnapshotImage](/games/services/web/api/rest/v1/snapshots#SnapshotImage)`)` The cover image of this snapshot. May be absent if there is no image. |\n| `uniqueName` | `string` The unique name provided when the snapshot was created. |\n| `progressValue` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The progress value (64-bit integer set by developer) associated with this snapshot. |\n\nSnapshotType\n------------\n\nDefine supported snapshot types.\n\n| Enums ||\n|-------------|--------------------------------------|\n| `SAVE_GAME` | A snapshot representing a save game. |\n\nSnapshotImage\n-------------\n\nAn image of a snapshot.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------|\n| ``` { \"width\": integer, \"height\": integer, \"mime_type\": string, \"url\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-------------|-----------------------------------------------------------------------------------------------------------------|\n| `width` | `integer` The width of the image. |\n| `height` | `integer` The height of the image. |\n| `mime_type` | `string` The MIME type of the image. |\n| `url` | `string` The URL of the image. This URL may be invalidated at any time and should not be cached. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#snapshotImage`. |\n\n| Methods ------- ||\n|------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| ### [get](/games/services/web/api/rest/v1/snapshots/get) | Retrieves the metadata for a given snapshot ID. |\n| ### [list](/games/services/web/api/rest/v1/snapshots/list) | Retrieves a list of snapshots created by your application for the player corresponding to the player ID. |"]]