Mit dem Google Play-Spieldienste können Entwickler ihre Spiele durch soziale Bestenlisten, Erfolge, den Spielstatus, die Anmeldung über Google und vieles mehr optimieren.
- REST-Ressource: accesstokens
- REST-Ressource: AchieveDefinitions
- REST-Ressource: success
- REST-Ressource: Applications
- REST-Ressource: events
- REST-Ressource: Leaderboards
- REST-Ressource: metagame
- REST-Ressource: player
- REST-Ressource: Recall
- REST-Ressource: revisions
- REST-Ressource: Scores
- REST-Ressource: Snapshots
- REST-Ressource: stats
Dienst: game.googleapis.com
Wir empfehlen, die von Google bereitgestellten Clientbibliotheken zu verwenden, um diesen Dienst aufzurufen. Wenn Ihre Anwendung Ihre eigenen Bibliotheken zum Aufrufen dieses Dienstes verwenden muss, verwenden Sie bei den API-Anfragen die folgenden Informationen.
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 Play-Spieldienste-Nutzer, der durch die angehängten Anmeldedaten identifiziert wird. |
generateRecallPlayGroupingApiToken |
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken Generiert ein Play Grouping API-Token für den Play-Spieldienste-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 derzeit authentifizierten Spieler. |
list |
GET /games/v1/players/{playerId}/achievements Listet den Fortschritt aller Erfolge Ihrer Anwendung für den derzeit authentifizierten Spieler auf. |
reveal |
POST /games/v1/achievements/{achievementId}/reveal Legt den Status des Erfolgs mit der angegebenen ID für den derzeit 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 Überprüft, ob das mit dieser Anfrage bereitgestellte Authentifizierungstoken für die Anwendung mit der angegebenen ID bestimmt ist, 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 zurück, die den aktuellen Fortschritt bei Ereignissen in dieser Anwendung für den derzeit authentifizierten Nutzer zeigt. |
listDefinitions |
GET /games/v1/eventDefinitions Gibt eine Liste der Ereignisdefinitionen in dieser Anwendung zurück. |
record |
POST /games/v1/events Zeichnet einen Batch von Änderungen auf, wie oft für den derzeit authentifizierten Nutzer dieser Anwendung Ereignisse aufgetreten sind. |
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 Metaspiel-Konfigurationsdaten für die aufrufende Anwendung zurück. |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} Listet Wiedergabedaten für den Player, der playerId entspricht, nach Kategorie zusammengefasste Wiedergabedaten auf. |
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 Spieler-IDs der Anwendung für den aktuell authentifizierten Spieler für alle angeforderten Spiele vom gleichen Entwickler wie die aufrufende Anwendung ab. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds Ruft die Spielerkennungen mit Bereichsbereich für den aktuell authentifizierten Nutzer ab. |
list |
GET /games/v1/players/me/players/{collection} Ruft die Sammlung der Spieler für den derzeit authentifizierten Nutzer ab. |
REST-Ressource: recall
Methoden | |
---|---|
gamesPlayerTokens |
GET /games/v1/recall/gamesPlayerTokens/{sessionId} Rufe die Recall-Tokens von allen angeforderten Spielen ab, die mit dem Play-Spieldienste-Spieler verknüpft sind, der in der angegebenen Recall-Sitzungs-ID codiert ist. |
lastTokenFromAllDeveloperGames |
GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId} Rufe das letzte Recall-Token von allen Entwicklerspielen ab, das mit dem Play-Spieldienste-Spieler verknüpft ist und in der angegebenen Recall-Sitzungs-ID codiert ist. |
linkPersona |
POST /games/v1/recall:linkPersona Verknüpfe das PGS-Hauptkonto, das in der angegebenen Recall-Sitzungs-ID codiert ist, mit einem In-Game-Konto |
resetPersona |
POST /games/v1/recall:resetPersona Alle Recall-Tokens löschen, die die jeweilige Persona mit einem beliebigen Spieler verknüpfen (mit oder ohne Profil). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} Rufe alle Recall-Tokens ab, die mit dem Play-Spieldienste-Spieler verknüpft sind und in der angegebenen Recall-Sitzungs-ID codiert sind. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona Lösche ein Recall-Token, das das in der Recall-Sitzung identifizierte PGS-Hauptkonto mit einem In-Game-Konto verknüpft, das entweder durch die „Persona“ identifiziert wurde oder anhand des Tokenwerts. |
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} Sie können Highscores und optional auch Ränge in Bestenlisten des derzeit authentifizierten Spielers abrufen. |
list |
GET /games/v1/leaderboards/{leaderboardId}/scores/{collection} Listet die Punktzahlen in einer Bestenliste auf, beginnend mit dem obersten Punkt. |
listWindow |
GET /games/v1/leaderboards/{leaderboardId}/window/{collection} Listet die Punktzahlen rund um den Punktestand eines Spielers in einer Bestenliste auf. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores Sendet eine Punktzahl an die angegebene Bestenliste. |
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 erstellten Snapshots für den Player ab, der der Spieler-ID entspricht. |
REST-Ressource: stats
Methoden | |
---|---|
get |
GET /games/v1/stats Gibt Interaktions- und Ausgabenstatistiken für den aktuell authentifizierten Nutzer in dieser Anwendung zurück. |