Google Play Games Services API

Le service de jeux Google Play permet aux développeurs d'améliorer les jeux grâce à des classements sociaux, des succès, l'état du jeu, la connexion avec Google et plus encore.

Service : games.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, conformez-vous aux informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut posséder plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://games.googleapis.com

Ressource REST : accesstokens

Méthodes
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Génère un jeton d'API Play Grouping pour l'utilisateur PGS identifié par les identifiants associés.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Génère un jeton de l'API Play Grouping pour l'utilisateur PGS identifié par l'ID de session Recall fourni dans la requête.

Ressource REST : achievementDefinitions

Méthodes
list GET /games/v1/achievements
Répertorie toutes les définitions de succès pour votre application.

Ressource REST : achievements

Méthodes
increment POST /games/v1/achievements/{achievementId}/increment
Incrémente les étapes du succès avec l'ID donné pour le joueur actuellement authentifié.
list GET /games/v1/players/{playerId}/achievements
Affiche la progression de toutes les réussites de votre application pour le joueur actuellement authentifié.
reveal POST /games/v1/achievements/{achievementId}/reveal
Définit l'état du succès avec l'ID donné sur REVEALED pour le joueur actuellement authentifié.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Définit les étapes pour le joueur actuellement authentifié afin de déverrouiller une réussite.
unlock POST /games/v1/achievements/{achievementId}/unlock
Déverrouille cette réussite pour le joueur actuellement authentifié.
updateMultiple POST /games/v1/achievements/updateMultiple
Met à jour plusieurs succès pour le joueur actuellement authentifié.

Ressource REST : applications

Méthodes
get GET /games/v1/applications/{applicationId}
Récupère les métadonnées de l'application avec l'ID donné.
getEndPoint POST /games/v1/applications/getEndPoint
Renvoie une URL pour le type de point de terminaison demandé.
played POST /games/v1/applications/played
Indique que l'utilisateur actuellement authentifié joue à votre application.
verify GET /games/v1/applications/{applicationId}/verify
Vérifie que le jeton d'authentification fourni avec cette requête est destiné à l'application avec l'ID spécifié et renvoie l'ID du joueur pour lequel il a été accordé.

Ressource REST : events

Méthodes
listByPlayer GET /games/v1/events
Renvoie une liste indiquant la progression actuelle des événements dans cette application pour l'utilisateur actuellement authentifié.
listDefinitions GET /games/v1/eventDefinitions
Affiche la liste des définitions d'événements de cette application.
record POST /games/v1/events
Enregistre un lot de modifications du nombre de fois où des événements se sont produits pour l'utilisateur actuellement authentifié de cette application.

Ressource REST : leaderboards

Méthodes
get GET /games/v1/leaderboards/{leaderboardId}
Récupère les métadonnées du classement avec l'ID donné.
list GET /games/v1/leaderboards
Liste toutes les métadonnées du classement pour votre application.

Ressource REST : metagame

Méthodes
getMetagameConfig GET /games/v1/metagameConfig
Renvoie les données de configuration du métajeu pour l'application appelante.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Liste les données de lecture agrégées par catégorie pour le lecteur correspondant à playerId.

Ressource REST : playerGameEvents

Méthodes
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Enregistre un lot d'événements de jeu pour un joueur spécifique.

Ressource REST : players

Méthodes
get GET /games/v1/players/{playerId}
Récupère la ressource Player avec l'ID donné.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Obtenez les ID de lecteur d'application pour le joueur actuellement authentifié dans tous les jeux demandés par le même développeur que l'application appelante.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Récupère les identifiants de joueur à portée limitée pour l'utilisateur actuellement authentifié.
list GET /games/v1/players/me/players/{collection}
Obtenez la collection de joueurs pour l'utilisateur actuellement authentifié.

Ressource REST : recall

Méthodes
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Récupérez les jetons de rappel de tous les jeux demandés associés au joueur PGS encodé dans l'ID de session de rappel fourni.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Récupérez le dernier jeton de rappel de tous les jeux du développeur associés au joueur PGS encodé dans l'ID de session de rappel fourni.
linkPersona POST /games/v1/recall:linkPersona
Associez le compte principal du joueur PGS encodé dans l'ID de session de rappel fourni à un compte dans le jeu.
resetPersona POST /games/v1/recall:resetPersona
Supprime tous les jetons de rappel associant la persona donnée à un joueur (avec ou sans profil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Récupère tous les jetons de rappel associés au joueur PGS encodé dans l'ID de session de rappel fourni.
unlinkPersona POST /games/v1/recall:unlinkPersona
Supprime un jeton de rappel associant le principal du joueur PGS identifié par la session de rappel et un compte de jeu identifié par le "persona" ou par la valeur du jeton.

Ressource REST : revisions

Méthodes
check GET /games/v1/revisions/check
Vérifie si le client de jeux est obsolète.

Ressource REST : scores

Méthodes
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Obtenez les meilleurs scores et, éventuellement, les rangs dans les classements pour le joueur actuellement authentifié.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Affiche les scores dans un classement, en commençant par le haut.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Liste les scores d'un classement autour (et y compris) du score d'un joueur.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Envoie un score au classement spécifié.
submitMultiple POST /games/v1/leaderboards/scores
Envoie plusieurs scores aux classements.

Ressource REST : snapshots

Méthodes
get GET /games/v1/snapshots/{snapshotId}
Récupère les métadonnées pour un ID d'instantané donné.
list GET /games/v1/players/{playerId}/snapshots
Récupère la liste des instantanés créés par votre application pour le joueur correspondant à l'ID de joueur.

Ressource REST : stats

Méthodes
get GET /games/v1/stats
Renvoie les statistiques d'engagement et de dépenses dans cette application pour l'utilisateur actuellement authentifié.