Method: achievements.list

Lista o progresso de todas as conquistas do app para o jogador autenticado.

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 preferencial a ser usado para strings retornadas por esse método.
maxResults

integer

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

string

O token retornado pela solicitação anterior.
state

enum (State)

Informa ao servidor para retornar apenas conquistas com o estado especificado. Se esse parâmetro não for especificado, todos os prêmios serão retornados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de objetos de conquistas.

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 do 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

Enumerações
ALL Lista todas as conquistas. Esse é o padrão.
HIDDEN Listar apenas conquistas ocultas.
REVEALED Lista apenas conquistas reveladas.
UNLOCKED Listar apenas as 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

O ID da conquista.
currentSteps

integer

As etapas atuais de 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 no estado dessa conquista.
experiencePoints

string (int64 format)

Pontos de experiência ganhos com a conquista. Esse campo não está presente para conquistas que ainda não foram desbloqueadas e 0 para conquistas que foram desbloqueadas pelos testadores, mas não foram publicadas.

Estado

Define os estados possíveis de uma conquista.

Enumerações
HIDDEN A conquista está oculta.
REVEALED A conquista é revelada.
UNLOCKED A conquista foi desbloqueada.