Method: snapshots.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft eine Liste der von Ihrer Anwendung erstellten Snapshots für den Player ab, der der Spieler-ID entspricht.
HTTP-Anfrage
GET https://games.googleapis.com/games/v1/players/{playerId}/snapshots
Pfadparameter
| Parameter |
playerId |
string
Eine Spieler-ID. Anstelle der ID des authentifizierten Spielers kann der Wert me verwendet werden.
|
Abfrageparameter
| Parameter |
language |
string
Die bevorzugte Sprache für Strings, die von dieser Methode zurückgegeben werden.
|
maxResults |
integer
Die maximale Anzahl von Snapshot-Ressourcen, die in der Antwort zurückgegeben werden sollen; wird für die Seitenordnung verwendet. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Snapshot-Ressourcen unter dem angegebenen maxResults liegen.
|
pageToken |
string
Das von der vorherigen Anfrage zurückgegebene Token.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Snapshot-Antwort auf einer Drittanbieterliste.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (Snapshot)
}
]
} |
| Felder |
kind |
string
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#snapshotListResponse.
|
nextPageToken |
string
Token für die nächste Ergebnisseite. Wenn keine weiteren Ergebnisse vorhanden sind, wird das Token weggelassen.
|
items[] |
object (Snapshot)
Die Snapshots.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
