Achievements: list

Lista o progresso de todas as conquistas do aplicativo para o jogador autenticado no momento. Faça o teste agora.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
playerId string Um ID do jogador. Um valor de me pode ser usado no lugar do ID do player autenticado.
Parâmetros de consulta opcionais
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 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. Os valores aceitos são de 1 a 200, inclusive.
pageToken string O token retornado pela solicitação anterior.
state string Diz ao servidor para retornar apenas conquistas com o estado especificado. Se esse parâmetro não for especificado, todas as conquistas serão retornadas.

Os valores aceitáveis são:
  • "ALL": lista todas as conquistas. Esse é o padrão.
  • "HIDDEN": lista apenas as conquistas ocultas.
  • "REVEALED": lista apenas as conquistas reveladas.
  • "UNLOCKED": lista apenas as conquistas desbloqueadas.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
https://www.googleapis.com/auth/games

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "games#playerAchievementListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#playerAchievement",
      "id": string,
      "currentSteps": integer,
      "formattedCurrentStepsString": string,
      "achievementState": string,
      "lastUpdatedTimestamp": long,
      "experiencePoints": long
    }
  ]
}
Nome da propriedade Valor Descrição Observações
kind string Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa games#playerAchievementListResponse.
nextPageToken string Token correspondente à próxima página de resultados.
items[] list As conquistas.
items[].kind string Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa games#playerAchievement.
items[].id string ID da conquista.
items[].currentSteps integer As etapas atuais para uma conquista incremental.
items[].formattedCurrentStepsString string As etapas atuais para uma conquista incremental como uma string.
items[].achievementState string O estado da conquista.
Os valores possíveis são:
  • "HIDDEN": a conquista está oculta.
  • "REVEALED": a conquista é revelada.
  • "UNLOCKED": a conquista está desbloqueada.


Os valores aceitáveis são os seguintes:
  • "HIDDEN"
  • "REVEALED"
  • "UNLOCKED"
items[].lastUpdatedTimestamp long É o carimbo de data/hora da última modificação no estado desta conquista.
items[].experiencePoints long 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 publicadas.

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.