Method: snapshots.list
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves a list of snapshots created by your application for the player corresponding to the player ID.
HTTP request
GET https://games.googleapis.com/games/v1/players/{playerId}/snapshots
Path parameters
| Parameters |
playerId |
string
A player ID. A value of me may be used in place of the authenticated player's ID.
|
Query parameters
| Parameters |
language |
string
The preferred language to use for strings returned by this method.
|
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.
|
pageToken |
string
The token returned by the previous request.
|
Request body
The request body must be empty.
Response body
A third party list snapshots response.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Snapshot)
}
]
} |
| Fields |
kind |
string
Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotListResponse.
|
nextPageToken |
string
Token corresponding to the next page of results. If there are no more results, the token is omitted.
|
items[] |
object (Snapshot)
The snapshots.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
For more information, see the OAuth 2.0 Overview.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-10-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-28 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)."]]
