Method: achievementDefinitions.list

Lista todas as definições de conquista do seu app.

Solicitação HTTP

GET https://games.googleapis.com/games/v1/achievements

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.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de objetos de definição 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 (AchievementDefinition)
    }
  ]
}
Campos
kind

string

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

string

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

object (AchievementDefinition)

As definições da conquista.

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.

AchievementDefinition

Um objeto de definição de conquista.

Representação JSON 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
Campos
kind

string

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

string

ID da conquista.
name

string

Nome da conquista.
description

string

Descrição da conquista.
achievementType

enum (AchievementType)

O tipo da conquista.
totalSteps

integer

O total de passos para uma conquista incremental.
formattedTotalSteps

string

O total de passos de uma conquista incremental como uma string.
revealedIconUrl

string

É o URL da imagem do ícone de conquista revelada.
isRevealedIconUrlDefault

boolean

Indica se a imagem do ícone revelado que está sendo retornada é uma imagem padrão ou é fornecida pelo jogo.
unlockedIconUrl

string

É o URL da imagem do ícone de conquista desbloqueada.
isUnlockedIconUrlDefault

boolean

Indica se a imagem de ícone desbloqueada retornada é uma imagem padrão ou fornecida pelo jogo.
initialState

enum (InitialAchievementState)

O estado inicial da conquista.
experiencePoints

string (int64 format)

Pontos de experiência que serão ganhos ao desbloquear esta conquista.

AchievementType

Possíveis tipos de conquistas.

Enums
STANDARD A conquista está bloqueada ou desbloqueada.
INCREMENTAL A conquista é incremental.

InitialAchievementState

Estados iniciais possíveis de uma conquista.

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