Method: achievements.list

Lista o progresso de todas as conquistas do seu aplicativo para o jogador autenticado no momento.

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
playerId

string

Um ID do jogador. Um valor de me pode ser usado no lugar do ID do jogador autenticado.

Parâmetros de consulta

Parâmetros
language

string

O idioma preferido a ser usado para strings retornadas por este método.
maxResults

integer

O número máximo de recursos de conquista a serem retornados na resposta, usado para paginação. Para qualquer resposta, o número real de recursos de conquista retornados pode ser menor que o maxResults especificado.
pageToken

string

O token retornado pela solicitação anterior.
state

enum (State)

Diz ao servidor para retornar somente conquistas com o estado especificado. Se esse parâmetro não for especificado, todas as conquistas serão retornadas.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de objetos de conquista.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerAchievementListResponse.
nextPageToken

string

Token correspondente à próxima página de resultados.
items[]

object (PlayerAchievement)

As conquistas.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

Estado

Enums
ALL Listar todas as conquistas. Esse é o padrão.
HIDDEN Lista apenas conquistas ocultas.
REVEALED Listar somente conquistas reveladas.
UNLOCKED Listar somente conquistas desbloqueadas.

PlayerAchievement

Um objeto de conquista.

Representação JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Campos
kind

string

Identifica exclusivamente o tipo desse recurso. O valor é sempre a string fixa games#playerAchievement.
id

string

ID da conquista.
currentSteps

integer

As etapas atuais para uma conquista incremental.
formattedCurrentStepsString

string

As etapas atuais de uma conquista incremental como uma string.
achievementState

enum (State)

O estado da conquista.
lastUpdatedTimestamp

string (int64 format)

O carimbo de data/hora da última modificação do estado da conquista.
experiencePoints

string (int64 format)

Pontos de experiência ganhos pela conquista. Esse campo está ausente para conquistas que ainda não foram desbloqueadas e 0 para conquistas que foram desbloqueadas por testadores, mas não foram publicadas.

Estado

Define os estados possíveis de uma conquista.

Enums
HIDDEN A conquista está oculta.
REVEALED A conquista é revelada.
UNLOCKED A conquista está desbloqueada.