Method: achievements.list

Indique la progression de toutes les réussites de votre application pour le joueur actuellement authentifié.

Requête HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

Paramètres de chemin

Paramètres
playerId

string

Un ID de joueur Vous pouvez utiliser la valeur me à la place de l'ID du joueur authentifié.

Paramètres de requête

Paramètres
language

string

Langue préférée à utiliser pour les chaînes renvoyées par cette méthode.
maxResults

integer

Nombre maximal de ressources de réussite à afficher dans la réponse. Utilisé pour la pagination. Pour chaque réponse, le nombre réel de ressources de réussite renvoyées peut être inférieur à la valeur maxResults spécifiée.
pageToken

string

Jeton renvoyé par la requête précédente.
state

enum (State)

Indique au serveur de ne renvoyer que les réussites dont l'état est spécifié. Si ce paramètre n'est pas spécifié, toutes les réussites sont renvoyées.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Une liste d'objets de réussite.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#playerAchievementListResponse.
nextPageToken

string

Jeton correspondant à la page de résultats suivante.
items[]

object (PlayerAchievement)

Les réussites.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

État

Enums
ALL Répertorier toutes les réussites Il s'agit de la valeur par défaut.
HIDDEN N'affichez que les réussites masquées.
REVEALED N'affichez que les réussites révélées.
UNLOCKED N'affichez que les réussites déverrouillées.

PlayerAchievement

Un objet de réussite.

Représentation JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#playerAchievement.
id

string

Identifiant de la réussite.
currentSteps

integer

Étapes actuelles d'un succès progressif.
formattedCurrentStepsString

string

Étapes actuelles d'un succès progressif sous forme de chaîne.
achievementState

enum (State)

État de la réussite.
lastUpdatedTimestamp

string (int64 format)

Le code temporel de la dernière modification de l'état de cette réussite.
experiencePoints

string (int64 format)

Points d'expérience gagnés pour la réussite. Ce champ est absent pour les réussites qui n'ont pas encore été déverrouillées et la valeur 0 pour les réussites qui ont été déverrouillées par les testeurs, mais qui ne sont pas publiées.

État

Définit les états possibles d'une réussite.

Enums
HIDDEN La réussite est masquée.
REVEALED La réussite est révélée.
UNLOCKED Réussite déverrouillée.