REST Resource: snapshots
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Ảnh chụp nhanh
Đối tượng tổng quan nhanh.
Biểu diễn dưới dạng 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
} |
Trường |
id |
string
Mã của bản tổng quan nhanh.
|
driveId |
string
Mã của tệp làm cơ sở cho bản tổng quan nhanh này trong API Drive. Chỉ xuất hiện nếu ảnh chụp nhanh là một chế độ xem trên một tệp trên Drive và tệp đó thuộc sở hữu của phương thức gọi.
|
kind |
string
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#snapshot cố định.
|
type |
enum (SnapshotType )
Loại của bản tổng quan nhanh này.
|
title |
string
Tiêu đề của bản tổng quan nhanh này.
|
description |
string
Nội dung mô tả về ảnh chụp nhanh này.
|
lastModifiedMillis |
string (int64 format)
Dấu thời gian (tính bằng mili giây kể từ thời gian Unix) của lần sửa đổi gần đây nhất đối với bản tổng quan nhanh này.
|
durationMillis |
string (int64 format)
Thời lượng liên kết với ảnh chụp nhanh này, tính bằng mili giây.
|
coverImage |
object (SnapshotImage )
Ảnh bìa của ảnh chụp nhanh này. Có thể không hiển thị nếu không có hình ảnh.
|
uniqueName |
string
Tên duy nhất được cung cấp khi tạo bản tổng quan nhanh.
|
progressValue |
string (int64 format)
Giá trị tiến trình (số nguyên 64 bit do nhà phát triển đặt) liên kết với bản tổng quan nhanh này.
|
SnapshotType
Xác định các loại bản tổng quan nhanh được hỗ trợ.
Enum |
SAVE_GAME |
Ảnh chụp nhanh minh hoạ một trò chơi đã lưu. |
SnapshotImage
Hình ảnh tổng quan nhanh.
Biểu diễn dưới dạng JSON |
{
"width": integer,
"height": integer,
"mime_type": string,
"url": string,
"kind": string
} |
Trường |
width |
integer
Chiều rộng của hình ảnh.
|
height |
integer
Chiều cao của hình ảnh.
|
mime_type |
string
Loại MIME của hình ảnh.
|
url |
string
URL của hình ảnh. URL này có thể không hợp lệ bất cứ lúc nào và không nên được lưu vào bộ nhớ đệm.
|
kind |
string
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#snapshotImage cố định.
|
Phương thức |
|
Truy xuất siêu dữ liệu cho một mã bản tổng quan nhanh nhất định. |
|
Truy xuất danh sách ảnh chụp nhanh do ứng dụng của bạn tạo cho trình phát tương ứng với mã nhận dạng người chơi. |
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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. |"]]