Method: achievements.list

Muestra el progreso de todos los logros de tu aplicación para el jugador autenticado actualmente.

Solicitud HTTP

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

Parámetros de ruta de acceso

Parámetros
playerId

string

Un ID de jugador. Se puede usar un valor de me en lugar del ID del jugador autenticado.

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.
state

enum (State)

Le indica al servidor que devuelva solo los logros con el estado especificado. Si no se especifica este parámetro, se muestran todos los logros.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una lista de objetos 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 (PlayerAchievement)
    }
  ]
}
Campos
kind

string

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

string

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

object (PlayerAchievement)

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.

State

Enums
ALL Muestra una lista de todos los logros. Es el valor predeterminado.
HIDDEN Muestra solo los logros ocultos.
REVEALED Solo se muestran los logros revelados.
UNLOCKED Muestra solo los logros desbloqueados.

PlayerAchievement

Un objeto de logro.

Representación JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Campos
kind

string

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

string

Es el ID del logro.
currentSteps

integer

Los pasos actuales para un logro incremental
formattedCurrentStepsString

string

Los pasos actuales para un logro incremental como una cadena.
achievementState

enum (State)

Es el estado del logro.
lastUpdatedTimestamp

string (int64 format)

Es la marca de tiempo de la última modificación del estado de este logro.
experiencePoints

string (int64 format)

Son los puntos de experiencia que se obtuvieron por el logro. Este campo no está presente para los logros que aún no se desbloquean y es 0 para los logros que los verificadores desbloquearon, pero que no se publicaron.

State

Define los estados posibles de un logro.

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