Google Play Game Services

Mit dem Google Play-Spieldienste können Entwickler ihre Spiele mit Bestenlisten in sozialen Netzwerken, Erfolgen, Spielstatus, Anmeldung über Google und vielem mehr verbessern.

Dienst: games.googleapis.com

Wir empfehlen, die von Google bereitgestellten Clientbibliotheken zu verwenden, um diesen Dienst aufzurufen. Wenn Ihre Anwendung zum Aufrufen dieses Dienstes Ihre eigenen Bibliotheken verwenden muss, verwenden Sie die folgenden Informationen für die API-Anfragen.

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: achievementDefinitions

Methoden
list GET /games/v1/achievements
Listet alle Erfolgsdefinitionen für deine App 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 App 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 derzeit 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
Zeigt an, dass der derzeit authentifizierte Nutzer Ihre Anwendung spielt.
verify GET /games/v1/applications/{applicationId}/verify
Überprüft, ob das mit dieser Anfrage angegebene Authentifizierungstoken für die Anwendung mit der angegebenen ID gilt, und gibt die ID des Players 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 von 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
Zeichnet einen Batch von Änderungen auf, die Aufschluss darüber gibt, wie oft Ereignisse für den derzeit authentifizierten Nutzer dieser Anwendung 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 App auf.

REST-Ressource: metagame

Methoden
getMetagameConfig GET /games/v1/metagameConfig
Gibt die Konfigurationsdaten des Metaspiels für die aufrufende Anwendung zurück.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Spieldaten auflisten, die nach Kategorie für den Spieler aggregiert sind, der playerId entspricht.

REST-Ressource: players

Methoden
get GET /games/v1/players/{playerId}
Ruft die Spielerressource mit der angegebenen ID ab.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Die Spieler-IDs der App für den derzeit authentifizierten Spieler für alle angeforderten Spiele vom selben Entwickler wie die aufrufende App abrufen
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Ruft auf einen Bereich reduzierte Spieler-IDs für den derzeit authentifizierten Nutzer ab.
list GET /games/v1/players/me/players/{collection}
Ruft die Sammlung der Spieler für den aktuell authentifizierten Nutzer ab

REST-Ressource: recall

Methoden
linkPersona POST /games/v1/recall:linkPersona
Verknüpfe das PGS-Spielerhauptkonto, das in der angegebenen Recall-Sitzungs-ID codiert ist, mit einem In-Game-Konto
resetPersona POST /games/v1/recall:resetPersona
Alle Rückruftokens löschen, die die jeweilige Persona mit einem Spieler (mit oder ohne Profil) verknüpfen.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Ruft alle Rückruftokens ab, die mit dem PGS-Player-Hauptkonto verknüpft sind, das in der angegebenen Recall-Sitzungs-ID codiert ist.
unlinkPersona POST /games/v1/recall:unlinkPersona
Lösche ein Rückruftoken, das das von der Rückrufsitzung identifizierte PGS-Spielerhauptkonto mit einem 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
Überprüft, ob der Spiele-Client veraltet ist.

REST-Ressource: scores

Methoden
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Du kannst Highscores und gegebenenfalls Ränge in Bestenlisten für den derzeit authentifizierten Spieler abrufen.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Listet die Punktzahlen in einer Bestenliste auf, beginnend von oben.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Listet die Punktzahlen in einer Bestenliste rund um die Punktzahl eines Spielers auf.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Sendet eine Punktzahl an die angegebene Bestenliste.
submitMultiple POST /games/v1/leaderboards/scores
Übermittelt 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 Snapshots ab, die von Ihrer Anwendung für den Player erstellt wurden, der der Spieler-ID entspricht.

REST-Ressource: stats

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