Method: achievementDefinitions.list

Enumera todas las definiciones de logros para tu aplicación.

Solicitud HTTP

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

Parámetros de consulta

Parámetros
language

string

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

integer

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

string

El token que muestra la solicitud anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

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

El token correspondiente a la siguiente página de resultados.
items[]

object (AchievementDefinition)

Las definiciones de los logros

Permisos de autorización

Se necesita uno de los siguientes alcances 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

Indica el total de pasos para un logro incremental.
formattedTotalSteps

string

Indica el total de pasos para un logro incremental como una cadena.
revealedIconUrl

string

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

boolean

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

string

URL de la imagen para el ícono de logro desbloqueado.
isUnlockedIconUrlDefault

boolean

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

enum (InitialAchievementState)

Es el estado inicial del logro.
experiencePoints

string (int64 format)

Los puntos de experiencia que se ganarán al desbloquear este logro.

AchievementType

Tipos de logros posibles.

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

InitialAchievementState

Posibles estados iniciales de un logro

Enumeradores
HIDDEN El logro está oculto.
REVEALED Se revela el logro.
UNLOCKED El logro está desbloqueado.