Method: achievementDefinitions.list

Répertorie toutes les définitions de réussite pour votre application.

Requête HTTP

GET https://games.googleapis.com/games/v1/achievements

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.

Corps de la requête

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

Corps de la réponse

Liste des objets de définition des réussites.

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 (AchievementDefinition)
    }
  ]
}
Champs
kind

string

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

string

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

object (AchievementDefinition)

Définition des 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.

AchievementDefinition

Objet de définition d'une réussite.

Représentation JSON 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
Champs
kind

string

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

string

Identifiant de la réussite.
name

string

Nom de la réussite.
description

string

Description de la réussite.
achievementType

enum (AchievementType)

Type de réussite.
totalSteps

integer

Nombre total d'étapes pour une réussite progressive.
formattedTotalSteps

string

Nombre total d'étapes pour une réussite progressive, sous forme de chaîne.
revealedIconUrl

string

URL de l'image de l'icône de réussite révélée.
isRevealedIconUrlDefault

boolean

Indique si l'image d'icône révélée renvoyée est une image par défaut ou si elle est fournie par le jeu.
unlockedIconUrl

string

URL de l'icône de la réussite déverrouillée
isUnlockedIconUrlDefault

boolean

Indique si l'image de l'icône déverrouillée renvoyée est une image par défaut ou si elle a été fournie par le jeu.
initialState

enum (InitialAchievementState)

État initial de la réussite
experiencePoints

string (int64 format)

Points d'expérience que vous gagnerez si vous débloquez cette réussite.

AchievementType

Types de réussites possibles.

Enums
STANDARD La réussite est soit verrouillée, soit déverrouillée.
INCREMENTAL Les réussites sont progressives.

InitialAchievementState

États initiaux 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.