Method: achievements.list

Indique la progression de tous les succès de votre application pour le lecteur 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 La valeur me peut être utilisée à la place de l'ID du joueur authentifié.

Paramètres de requête

Paramètres
language

string

Langue privilégiée pour les chaînes renvoyées par cette méthode.
maxResults

integer

Nombre maximal de ressources de succès à renvoyer dans la réponse. Utilisé pour la pagination. Pour toute 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 avec l'état 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 des 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 Affichez la liste de toutes les réussites. Il s'agit de la valeur par défaut.
HIDDEN Afficher uniquement les réussites masquées.
REVEALED Liste uniquement les succès révélés.
UNLOCKED Afficher uniquement 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'une réussite progressive.
formattedCurrentStepsString

string

Les étapes actuelles d'une réussite progressive sous forme de chaîne.
achievementState

enum (State)

État de la réussite
lastUpdatedTimestamp

string (int64 format)

Horodatage 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 n'est pas renseigné pour les réussites qui n'ont pas encore été déverrouillées, ni pour celles qui ont été déverrouillées par des testeurs, mais qui n'ont pas été publiées.

État

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

Enums
HIDDEN La réussite est masquée.
REVEALED La réussite s'affiche.
UNLOCKED Réussite déverrouillée.