Mit dem Google Play-Spieldienste können Entwickler ihre Spiele mit Bestenlisten in sozialen Netzwerken, Erfolgen, dem Spielstatus, der Anmeldung über Google und vielem mehr verbessern.
- REST-Ressource: successDefinitions
- REST-Ressource: Achievements
- REST-Ressource: Applications (Anwendungen)
- REST-Ressource: Ereignisse
- REST-Ressource: Bestenlisten
- REST-Ressource: metagame
- REST-Ressource: player
- REST-Ressource: Recall
- REST-Ressource: Überarbeitungen
- REST-Ressource: scores
- REST-Ressource: Snapshots
- REST-Ressource: stats
Dienst: games.googleapis.com
Um diesen Dienst aufzurufen, empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken verwenden muss, um diesen Dienst aufzurufen, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.
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: acievements
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 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 aktuell authentifizierte Nutzer Ihre Anwendung spielt. |
verify |
GET /games/v1/applications/{applicationId}/verify Überprüft, ob das in dieser Anfrage angegebene Authentifizierungstoken für die Anwendung mit der angegebenen ID gilt, und gibt die ID des Spielers zurück, für den sie 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 derzeit 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 einen Batch von Änderungen an der Häufigkeit, mit der 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 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 Wiedergabedaten nach Kategorie für den Player auf, 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 Ruft die Spieler-IDs der App für den derzeit authentifizierten Player für alle Spiele vom selben Entwickler wie die aufrufende Anwendung ab. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds Ruft auf einen Bereich reduzierte Spieler-IDs für den aktuell 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 Recall-Tokens löschen, die die angegebene Persona mit einem Spieler (mit oder ohne Profil) verknüpfen |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} Rufe alle Rückruftokens ab, die mit dem PGS-Spieler-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-Spieler-Hauptkonto mit einem In-Game-Konto verknüpft, das entweder durch die „Persona“ oder den Tokenwert identifiziert wird. |
REST-Ressource: revisions
Methoden | |
---|---|
check |
GET /games/v1/revisions/check Überprüft, ob der Spieleclient veraltet ist. |
REST-Ressource: scores
Methoden | |
---|---|
get |
GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan} Highscores und optionale 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 in einer Bestenliste die Punktzahlen rund um die Punktzahl eines Spielers auf. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores Übermittelt 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 von Ihrer Anwendung erstellten Momentaufnahmen für den Spieler ab, der der Spieler-ID entspricht. |
REST-Ressource: stats
Methoden | |
---|---|
get |
GET /games/v1/stats Gibt Statistiken zu Interaktionen und Ausgaben in dieser Anwendung für den aktuell authentifizierten Nutzer zurück. |