- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Estado
- PlayerAchievement
- Estado
- Faça um teste
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 |
Um ID de jogador. Um valor de |
Parâmetros de consulta
Parâmetros | |
---|---|
language |
O idioma preferido a ser usado para strings retornadas por esse método. |
maxResults |
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 |
pageToken |
O token retornado pela solicitação anterior. |
state |
Instrui o servidor a 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 ( |
Campos | |
---|---|
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
nextPageToken |
Token correspondente à próxima página de resultados. |
items[] |
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
Enums | |
---|---|
ALL |
Lista todas as conquistas. Esse é o padrão. |
HIDDEN |
Listar apenas conquistas ocultas. |
REVEALED |
Lista apenas as conquistas reveladas. |
UNLOCKED |
Listar apenas conquistas desbloqueadas. |
PlayerAchievement
Um objeto de conquista.
Representação JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
Campos | |
---|---|
kind |
Identifica exclusivamente o tipo deste recurso. O valor é sempre a string fixa |
id |
ID da conquista. |
currentSteps |
As etapas atuais para uma conquista incremental. |
formattedCurrentStepsString |
As etapas atuais para uma conquista incremental como uma string. |
achievementState |
O estado da conquista. |
lastUpdatedTimestamp |
O carimbo de data/hora da última modificação no estado dessa conquista. |
experiencePoints |
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 pelos testadores, mas não publicadas. |
Estado
Define os possíveis estados de uma conquista.
Enums | |
---|---|
HIDDEN |
A conquista está oculta. |
REVEALED |
A conquista é revelada. |
UNLOCKED |
A conquista está desbloqueada. |