Method: achievementDefinitions.list

Muestra una lista de todas las definiciones de logros de tu aplicación.

Solicitud HTTP

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

Parámetros de consulta

Parámetros
language

string

Es el idioma preferido para usar en las cadenas que muestra este método.
maxResults

integer

Es la cantidad máxima de recursos de logros que se mostrarán en la respuesta, que se usa para la paginación. Para cualquier respuesta, la cantidad real de recursos de logros que se muestra puede ser menor que el maxResults especificado.
pageToken

string

Es el token que muestra la solicitud anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una lista de objetos de definición de logros.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#achievementDefinitionsListResponse.
nextPageToken

string

Es el token que corresponde a la siguiente página de resultados.
items[]

object (AchievementDefinition)

Las definiciones de los logros.

Permisos de autorización

Se requiere uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

AchievementDefinition

Un objeto de definición de logro.

Representación 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
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#achievementDefinition.
id

string

Es el ID del logro.
name

string

Es el nombre del logro.
description

string

Es la descripción del logro.
achievementType

enum (AchievementType)

Es el tipo de logro.
totalSteps

integer

Es la cantidad total de pasos para un logro incremental.
formattedTotalSteps

string

Es la cadena que indica el total de pasos para un logro incremental.
revealedIconUrl

string

Es la URL de la imagen del ícono del logro revelado.
isRevealedIconUrlDefault

boolean

Indica si la imagen del ícono revelada que se muestra es una imagen predeterminada o si la proporciona el juego.
unlockedIconUrl

string

Es la URL de la imagen del ícono del logro desbloqueado.
isUnlockedIconUrlDefault

boolean

Indica si la imagen del ícono desbloqueado que se muestra es una imagen predeterminada o proporcionada por el juego.
initialState

enum (InitialAchievementState)

Es el estado inicial del logro.
experiencePoints

string (int64 format)

Son los puntos de experiencia que se ganarán cuando se desbloquee este logro.

AchievementType

Posibles tipos de logros.

Enums
STANDARD El logro está bloqueado o desbloqueado.
INCREMENTAL El logro es incremental.

InitialAchievementState

Posibles estados iniciales de un logro.

Enums
HIDDEN Se oculta el logro.
REVEALED Se revela el logro.
UNLOCKED Se desbloqueó el logro.