Method: snapshots.list
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.
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.
Yêu cầu HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/snapshots
Tham số đường dẫn
| Tham số |
playerId |
string
Mã nhận dạng người chơi. Bạn có thể sử dụng giá trị của me thay cho mã nhận dạng của người chơi đã xác thực.
|
Tham số truy vấn
| Tham số |
language |
string
Ngôn ngữ ưu tiên sử dụng cho các chuỗi được phương thức này trả về.
|
maxResults |
integer
Số lượng tài nguyên tổng quan nhanh tối đa cần trả về trong phản hồi, dùng để phân trang. Đối với mọi phản hồi, số lượng tài nguyên tổng quan nhanh được trả về có thể nhỏ hơn maxResults được chỉ định.
|
pageToken |
string
Mã thông báo do yêu cầu trước đó trả về.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi ảnh chụp nhanh danh sách của bên thứ ba.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Snapshot)
}
]
} |
| Trường |
kind |
string
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#snapshotListResponse cố định.
|
nextPageToken |
string
Mã thông báo tương ứng với trang kết quả tiếp theo. Nếu không có kết quả nào khác thì mã thông báo sẽ bị bỏ qua.
|
items[] |
object (Snapshot)
Ảnh chụp nhanh.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
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,["# Method: snapshots.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListSnapshotsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves a list of snapshots created by your application for the player corresponding to the player ID.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/snapshots`\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of snapshot resources to return in the response, used for paging. For any response, the actual number of snapshot resources returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party list snapshots response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/snapshots#Snapshot) } ] } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#snapshotListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. If there are no more results, the token is omitted. |\n| `items[]` | `object (`[Snapshot](/games/services/web/api/rest/v1/snapshots#Snapshot)`)` The snapshots. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
