Method: achievements.list

Enumera 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. Puedes usar un valor de me en lugar del ID del jugador autenticado.

Parámetros de consulta

Parámetros
language

string

El idioma preferido para las strings que muestra este método.
maxResults

integer

La cantidad máxima de recursos de logros que se muestran en la respuesta, que 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 mostró la solicitud anterior.
state

enum (State)

Indica al servidor que muestre solo 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 exclusiva el tipo de este recurso. El valor es siempre la string fija games#playerAchievementListResponse.
nextPageToken

string

Token que corresponde a la siguiente página de resultados.
items[]

object (PlayerAchievement)

Los logros.

Permisos de la 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.

Estado

Enumeradores
ALL Enumera todos los logros. Esta es la opción predeterminada.
HIDDEN Enumera solo los logros ocultos.
REVEALED Enumera solo los logros revelados.
UNLOCKED Enumera solo los logros desbloqueados.

Logro del jugador

Es 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 exclusiva el tipo de este recurso. El valor es siempre la string fija games#playerAchievement.
id

string

Es el ID del logro.
currentSteps

integer

Los pasos actuales para un logro incremental.
formattedCurrentStepsString

string

Son los pasos actuales de 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)

Puntos de experiencia ganados por el logro. Este campo no está disponible para los logros que aún no se desbloquearon y 0 para los que los verificadores hayan desbloqueado, pero no publicados.

Estado

Define los estados posibles de un logro.

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