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입니다. 스냅샷이 Drive 파일의 뷰이고 호출자가 파일을 소유한 경우에만 존재합니다.
|
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#snapshot 입니다.
|
type |
enum (SnapshotType )
이 스냅샷의 유형입니다.
|
title |
string
이 스냅샷의 제목입니다.
|
description |
string
이 스냅샷에 대한 설명입니다.
|
lastModifiedMillis |
string (int64 format)
이 스냅샷의 마지막 수정 타임스탬프 (Unix epoch 이후 밀리초)입니다.
|
durationMillis |
string (int64 format)
이 스냅샷과 연결된 시간입니다(단위: 밀리초).
|
coverImage |
object (SnapshotImage )
이 스냅샷의 표지 이미지입니다. 이미지가 없으면 없을 수 있습니다.
|
uniqueName |
string
스냅샷을 만들 때 제공된 고유한 이름입니다.
|
progressValue |
string (int64 format)
이 스냅샷과 연결된 진행률 값 (개발자가 설정한 64비트 정수)입니다.
|
SnapshotType
Enum |
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
이미지의 URL입니다. 이 URL은 언제든지 무효화될 수 있으므로 캐시해서는 안 됩니다.
|
kind |
string
이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#snapshotImage 입니다.
|
메서드 |
|
지정된 스냅샷 ID의 메타데이터를 가져옵니다. |
|
플레이어 ID에 해당하는 플레이어에 대해 애플리케이션에서 만든 스냅샷 목록을 검색합니다. |
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],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. |"]]