Google Play Game Services

Le service de jeux Google Play permet aux développeurs d'améliorer leurs jeux en y ajoutant des classements sur les réseaux sociaux, des réussites, un état de jeu, la fonctionnalité de connexion avec Google, etc.

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, utilisez les 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 du 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 disposer de 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: achievementDefinitions

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

Ressource REST: succès

Méthodes
increment POST /games/v1/achievements/{achievementId}/increment
Incrémente les étapes du succès avec l'ID donné du joueur actuellement authentifié.
list GET /games/v1/players/{playerId}/achievements
Répertorie la progression de tous les succès 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 à suivre par le joueur actuellement authentifié pour déverrouiller un succès.
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 d'arrivée demandé.
played POST /games/v1/applications/played
Indique que l'utilisateur actuellement authentifié est en train de lire votre application.
verify GET /games/v1/applications/{applicationId}/verify
Vérifie que le jeton d'authentification fourni avec cette demande concerne l'application ayant 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
Renvoie la liste des définitions d'événements dans 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'identifiant donné.
list GET /games/v1/leaderboards
Répertorie toutes les métadonnées des classements 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}
Répertoriez les données de jeu agrégées par catégorie pour le joueur correspondant à playerId.

Ressource REST: players

Méthodes
get GET /games/v1/players/{playerId}
Récupère la ressource "Joueur" avec l'ID donné.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Récupère les ID de joueur de l'application pour le joueur actuellement authentifié, pour 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 limités pour l'utilisateur actuellement authentifié.
list GET /games/v1/players/me/players/{collection}
Récupère la collection de joueurs pour l'utilisateur actuellement authentifié.

Ressource REST: recall

Méthodes
linkPersona POST /games/v1/recall:linkPersona
Associer le compte principal de joueur PGS encodé dans l'ID de session de rappel fourni à un compte de jeu
resetPersona POST /games/v1/recall:resetPersona
Supprimez tous les jetons de rappel associant un persona donné à n'importe quel joueur (avec ou sans profil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Récupère tous les jetons de rappel associés au compte principal de joueur PGS encodé dans l'ID de session de rappel fourni.
unlinkPersona POST /games/v1/recall:unlinkPersona
Supprimez un jeton de rappel associant le compte principal de joueur PGS identifié par la session de rappel et un compte de jeu identifié soit par le "persona", soit 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 des classements dans les classements pour le joueur actuellement authentifié.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Répertorie les scores dans un classement, en partant du haut.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Répertorie les scores dans un classement en fonction de celui d'un joueur (inclus).
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Envoie un score pour le classement spécifié.
submitMultiple POST /games/v1/leaderboards/scores
Envoie plusieurs scores dans les 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 à son ID.

Ressource REST: stats

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