Google Play Games Services API

Mit den Google Play-Spieldiensten können Entwickler Spiele mit sozialen Bestenlisten, Erfolgen, Spielstatus, Anmeldung mit Google und mehr optimieren.

Dienst: games.googleapis.com

Wir empfehlen, diesen Dienst mit den von Google bereitgestellten Clientbibliotheken aufzurufen. Wenn Ihre Anwendung diesen Dienst mit Ihren eigenen Bibliotheken aufrufen muss, sollten Sie die folgenden Informationen verwenden, wenn Sie die API-Anfragen senden.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://games.googleapis.com

REST-Ressource: accesstokens

Methoden
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Generiert ein Play Grouping API-Token für den PGS-Nutzer, der durch die angehängten Anmeldedaten identifiziert wird.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Generiert ein Play Grouping API-Token für den PGS-Nutzer, der durch die in der Anfrage angegebene Recall-Sitzungs-ID identifiziert wird.

REST-Ressource: achievementDefinitions

Methoden
list GET /games/v1/achievements
Listet alle Erfolgsdefinitionen für Ihre Anwendung auf.

REST-Ressource: achievements

Methoden
increment POST /games/v1/achievements/{achievementId}/increment
Erhöht die Schritte des Erfolgs mit der angegebenen ID für den aktuell authentifizierten Spieler.
list GET /games/v1/players/{playerId}/achievements
Listet den Fortschritt für alle Erfolge Ihrer Anwendung für den aktuell authentifizierten Spieler auf.
reveal POST /games/v1/achievements/{achievementId}/reveal
Legt den Status der Errungenschaft mit der angegebenen ID für den aktuell authentifizierten Spieler auf REVEALED fest.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Legt die Schritte für den aktuell authentifizierten Spieler zum Freischalten eines Erfolgs fest.
unlock POST /games/v1/achievements/{achievementId}/unlock
Schaltet diesen Erfolg für den derzeit authentifizierten Spieler frei.
updateMultiple POST /games/v1/achievements/updateMultiple
Aktualisiert mehrere Erfolge für den derzeit authentifizierten Spieler.

REST-Ressource: applications

Methoden
get GET /games/v1/applications/{applicationId}
Ruft die Metadaten der Anwendung mit der angegebenen ID ab.
getEndPoint POST /games/v1/applications/getEndPoint
Gibt eine URL für den angeforderten Endpunkttyp zurück.
played POST /games/v1/applications/played
Gibt an, dass der aktuell authentifizierte Nutzer Ihre Anwendung spielt.
verify GET /games/v1/applications/{applicationId}/verify
Prüft, ob das mit dieser Anfrage bereitgestellte Auth-Token für die Anwendung mit der angegebenen ID gilt, und gibt die ID des Spielers zurück, für den es gewährt wurde.

REST-Ressource: events

Methoden
listByPlayer GET /games/v1/events
Gibt eine Liste mit dem aktuellen Fortschritt bei Ereignissen in dieser Anwendung für den aktuell authentifizierten Nutzer zurück.
listDefinitions GET /games/v1/eventDefinitions
Gibt eine Liste der Ereignisdefinitionen in dieser Anwendung zurück.
record POST /games/v1/events
Erfasst eine Reihe von Änderungen an der Anzahl der Ereignisse für den aktuell authentifizierten Nutzer dieser Anwendung.

REST-Ressource: leaderboards

Methoden
get GET /games/v1/leaderboards/{leaderboardId}
Ruft die Metadaten der Bestenliste mit der angegebenen ID ab.
list GET /games/v1/leaderboards
Listet alle Bestenlisten-Metadaten für Ihre Anwendung auf.

REST-Ressource: metagame

Methoden
getMetagameConfig GET /games/v1/metagameConfig
Gibt die Metagame-Konfigurationsdaten für die aufrufende Anwendung zurück.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Listet die nach Kategorie zusammengefassten Play-Daten für den Spieler auf, der playerId entspricht.

REST-Ressource: playerGameEvents

Methoden
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Erfasst eine Reihe von Spielerereignissen für einen bestimmten Spieler.

REST-Ressource: players

Methoden
get GET /games/v1/players/{playerId}
Ruft die Player-Ressource mit der angegebenen ID ab.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Ruft die Anwendungs-Spieler-IDs für den aktuell authentifizierten Spieler in allen angeforderten Spielen desselben Entwicklers wie die aufrufende Anwendung ab.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Ruft bereichsbezogene Spieler-IDs für den derzeit authentifizierten Nutzer ab.
list GET /games/v1/players/me/players/{collection}
Rufe die Sammlung von Spielern für den aktuell authentifizierten Nutzer ab.

REST-Ressource: recall

Methoden
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Ruft die Speicherdaten-Tokens aus allen angeforderten Spielen ab, die dem in der bereitgestellten Speicherdaten-Sitzungs-ID codierten PGS-Spieler zugeordnet sind.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Das letzte Speicherdaten-Token aus allen Entwicklerspielen abrufen, das mit dem in der bereitgestellten Speicherdaten-Sitzungs-ID codierten PGS-Spieler verknüpft ist.
linkPersona POST /games/v1/recall:linkPersona
Den in der bereitgestellten Speicherdaten-Sitzungs-ID codierten PGS-Spieler-Principal mit einem In-Game-Konto verknüpfen
resetPersona POST /games/v1/recall:resetPersona
Löschen Sie alle Recall-Tokens, die die angegebene Persona mit einem beliebigen Spieler (mit oder ohne Profil) verknüpfen.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Ruft alle Speicherdaten-Tokens ab, die dem in der angegebenen Speicherdaten-Sitzungs-ID codierten PGS-Spieler zugeordnet sind.
unlinkPersona POST /games/v1/recall:unlinkPersona
Löschen Sie ein Speicherdaten-Token, das das durch die Speicherdaten-Sitzung identifizierte PGS-Spieler-Prinzip und ein In-Game-Konto verknüpft, das entweder durch die „Persona“ oder durch den Tokenwert identifiziert wird.

REST-Ressource: revisions

Methoden
check GET /games/v1/revisions/check
Prüft, ob der Spieleclient veraltet ist.

REST-Ressource: scores

Methoden
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Highscores und optional Ränge in Bestenlisten für den aktuell authentifizierten Spieler abrufen.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Listet die Ergebnisse in einer Bestenliste auf, beginnend mit dem besten Ergebnis.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Listet die Punktzahlen in einer Bestenliste um (und einschließlich) der Punktzahl eines Spielers auf.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Reicht einen Punktestand für die angegebene Bestenliste ein.
submitMultiple POST /games/v1/leaderboards/scores
Sendet mehrere Punktzahlen an Bestenlisten.

REST-Ressource: snapshots

Methoden
get GET /games/v1/snapshots/{snapshotId}
Ruft die Metadaten für eine bestimmte Snapshot-ID ab.
list GET /games/v1/players/{playerId}/snapshots
Ruft eine Liste der von Ihrer Anwendung für den Spieler mit der entsprechenden Spieler-ID erstellten Snapshots ab.

REST-Ressource: stats

Methoden
get GET /games/v1/stats
Gibt Statistiken zu Interaktionen und Ausgaben in dieser Anwendung für den derzeit authentifizierten Nutzer zurück.