Method: achievements.list

Отображает прогресс всех достижений вашего приложения для текущего аутентифицированного игрока.

HTTP-запрос

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

Параметры пути

Параметры
playerId

string

Идентификатор игрока. Вместо идентификатора аутентифицированного игрока можно использовать значение me .

Параметры запроса

Параметры
language

string

Предпочтительный язык для строк, возвращаемых этим методом.

maxResults

integer

Максимальное количество ресурсов достижений, возвращаемых в ответе, используемых для пейджинга. Для любого ответа фактическое количество возвращаемых ресурсов достижений может быть меньше указанного maxResults .

pageToken

string

Токен, возвращенный предыдущим запросом.

state

enum ( State )

Указывает серверу возвращать только достижения с указанным состоянием. Если этот параметр не указан, возвращаются все достижения.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Список объектов достижений.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
Поля
kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#playerAchievementListResponse .

nextPageToken

string

Токен, соответствующий следующей странице результатов.

items[]

object ( PlayerAchievement )

Достижения.

Области авторизации

Требуется одна из следующих областей OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Состояние

Перечисления
ALL Перечислите все достижения. Это значение по умолчанию.
HIDDEN Перечисляйте только скрытые достижения.
REVEALED Перечислите только выявленные достижения.
UNLOCKED Список только разблокированных достижений.

ИгрокДостижение

Объект достижения.

JSON-представление
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Поля
kind

string

Уникально определяет тип этого ресурса. Значением всегда является фиксированная строка games#playerAchievement .

id

string

Идентификатор достижения.

currentSteps

integer

Текущие шаги для постепенного достижения.

formattedCurrentStepsString

string

Текущие шаги для дополнительного достижения в виде строки.

achievementState

enum ( State )

Состояние достижения.

lastUpdatedTimestamp

string ( int64 format)

Временная метка последнего изменения состояния этого достижения.

experiencePoints

string ( int64 format)

За достижение можно получить очки опыта. Это поле отсутствует для достижений, которые еще не разблокированы, и 0 для достижений, которые были разблокированы тестировщиками, но не опубликованы.

Состояние

Определяет возможные состояния достижения.

Перечисления
HIDDEN Достижение скрыто.
REVEALED Достижение раскрыто.
UNLOCKED Достижение разблокировано.