Google Play Game Services

Le service de jeux Google Play permet aux développeurs d'améliorer leurs jeux en y ajoutant des classements des réseaux sociaux, des réussites, l'état du jeu, la 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 des 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
Il génère un jeton d'API Play Grouping pour l'utilisateur PGS qui est identifié par les identifiants joints.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Il génère un jeton d'API Play Grouping pour l'utilisateur PGS qui est identifié par l'ID de session de rappel fourni dans la requête.

Ressource REST: achievementDefinitions

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

Ressource REST: achievements

Méthodes
increment POST /games/v1/achievements/{achievementId}/increment
Incrémente les étapes de la réussite avec l'ID donné pour le joueur actuellement authentifié.
list GET /games/v1/players/{playerId}/achievements
Indique la progression de tous les succès de votre application pour le lecteur actuellement authentifié.
reveal POST /games/v1/achievements/{achievementId}/reveal
Définit l'état de la réussite portant l'ID donné sur REVEALED pour le joueur actuellement authentifié.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Définit les étapes du joueur actuellement authentifié en vue du déverrouillage d'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 réussites 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
Indiquez que l'utilisateur actuellement authentifié lit votre application.
verify GET /games/v1/applications/{applicationId}/verify
Vérifie que le jeton d'authentification fourni avec cette demande correspond à l'application ayant l'identifiant spécifié, et renvoie l'identifiant du joueur pour lequel il a été accordé.

Ressource REST: events

Méthodes
listByPlayer GET /games/v1/events
Affiche 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'ID 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
Renvoyez les données de configuration de métajeu pour l'application appelante.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Répertorier les données de lecture 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 "Player" avec l'ID donné.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Obtenez les ID de joueur de l'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 des joueurs ciblés pour l'utilisateur actuellement authentifié.
list GET /games/v1/players/me/players/{collection}
Permet d'obtenir 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 de développement associés au joueur PGS encodé dans l'ID de session de rappel fourni.
linkPersona POST /games/v1/recall:linkPersona
Associez 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 qui associent le persona donné à n'importe quel joueur (avec ou sans profil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Récupérez tous les jetons de rappel associés au joueur PGS et encodés 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é par le "persona". ou la valeur du jeton.

Ressource REST: revisions

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

Ressource REST: scores

Méthodes
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Obtenez des scores élevés (et éventuellement des classements) dans les classements pour le joueur actuellement authentifié.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Liste les scores dans un classement, en partant du haut.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Liste les scores dans un classement autour (et incluant) le 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 lecteur en fonction de l'ID du joueur.

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é.