Google Play Game Services

Игровой сервис Google Play позволяет разработчикам улучшать игры с помощью социальных таблиц лидеров, достижений, состояния игры, входа в систему с помощью Google и многого другого.

Сервис: games.googleapis.com.

Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.

Документ открытия

Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:

  • https://games.googleapis.com

Ресурс REST: токены доступа

Методы
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Создает токен API группировки Play для пользователя PGS, идентифицируемого прикрепленными учетными данными.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Создает токен API группировки воспроизведения для пользователя PGS, идентифицируемого идентификатором сеанса отзыва, указанным в запросе.

Ресурс REST: достиженияОпределения

Методы
list GET /games/v1/achievements
Перечисляет все определения достижений для вашего приложения.

Ресурс REST: достижения

Методы
increment POST /games/v1/achievements/{achievementId}/increment
Увеличивает количество шагов достижения с заданным идентификатором для текущего аутентифицированного игрока.
list GET /games/v1/players/{playerId}/achievements
Отображает прогресс всех достижений вашего приложения для текущего аутентифицированного игрока.
reveal POST /games/v1/achievements/{achievementId}/reveal
Устанавливает состояние достижения с данным идентификатором на REVEALED для текущего аутентифицированного игрока.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Устанавливает шаги для текущего аутентифицированного игрока для разблокировки достижения.
unlock POST /games/v1/achievements/{achievementId}/unlock
Открывает это достижение для текущего аутентифицированного игрока.
updateMultiple POST /games/v1/achievements/updateMultiple
Обновляет несколько достижений для текущего аутентифицированного игрока.

Ресурс REST: приложения

Методы
get GET /games/v1/applications/{applicationId}
Получает метаданные приложения с заданным идентификатором.
getEndPoint POST /games/v1/applications/getEndPoint
Возвращает URL-адрес запрошенного типа конечной точки.
played POST /games/v1/applications/played
Укажите, что текущий аутентифицированный пользователь играет в вашем приложении.
verify GET /games/v1/applications/{applicationId}/verify
Проверяет, что токен аутентификации, предоставленный в этом запросе, предназначен для приложения с указанным идентификатором, и возвращает идентификатор игрока, для которого он был предоставлен.

Ресурс REST: события

Методы
listByPlayer GET /games/v1/events
Возвращает список, показывающий текущий прогресс событий в этом приложении для текущего аутентифицированного пользователя.
listDefinitions GET /games/v1/eventDefinitions
Возвращает список определений событий в этом приложении.
record POST /games/v1/events
Записывает пакет изменений количества событий, произошедших для текущего аутентифицированного пользователя этого приложения.

Ресурс REST: таблицы лидеров

Методы
get GET /games/v1/leaderboards/{leaderboardId}
Получает метаданные таблицы лидеров с заданным идентификатором.
list GET /games/v1/leaderboards
Перечисляет все метаданные таблицы лидеров для вашего приложения.

Ресурс REST: метагейм

Методы
getMetagameConfig GET /games/v1/metagameConfig
Верните данные конфигурации метаигры для вызывающего приложения.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Список игровых данных, агрегированных по категориям для игрока, соответствующего playerId .

Ресурс REST: игроки

Методы
get GET /games/v1/players/{playerId}
Получает ресурс Player с заданным идентификатором.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Получите идентификаторы игрока приложения для текущего аутентифицированного игрока во всех запрошенных играх того же разработчика, что и вызывающее приложение.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Извлекает идентификаторы игроков для текущего аутентифицированного пользователя.
list GET /games/v1/players/me/players/{collection}
Получите коллекцию игроков для текущего аутентифицированного пользователя.

Ресурс REST: отзыв

Методы
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Получите токены отзыва из всех запрошенных игр, связанных с проигрывателем PGS, закодированных в предоставленном идентификаторе сеанса отзыва.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Получите последний токен отзыва из всех игр разработчиков, который связан с проигрывателем PGS Player, закодированный в предоставленном идентификаторе сеанса отзыва.
linkPersona POST /games/v1/recall:linkPersona
Свяжите участника PGS Player, закодированного в предоставленном идентификаторе сеанса отзыва, с внутриигровой учетной записью.
resetPersona POST /games/v1/recall:resetPersona
Удалите все жетоны отзыва, связывающие данный персонаж с любым игроком (с профилем или без него).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Получите все токены отзыва, связанные с проигрывателем PGS, закодированные в предоставленном идентификаторе сеанса отзыва.
unlinkPersona POST /games/v1/recall:unlinkPersona
Удалите токен отзыва, связывающий участника PGS Player, идентифицированного сеансом отзыва, и внутриигровую учетную запись, идентифицируемую либо по «персонажу», либо по значению токена.

Ресурс REST: изменения

Методы
check GET /games/v1/revisions/check
Проверяет, не устарел ли клиент игры.

Ресурс REST: баллы

Методы
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Получите высокие баллы и, при необходимости, места в таблицах лидеров для текущего аутентифицированного игрока.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Перечисляет результаты в таблице лидеров, начиная сверху.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Перечисляет результаты в таблице лидеров вокруг (и включая) очков игрока.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Отправляет результат в указанную таблицу лидеров.
submitMultiple POST /games/v1/leaderboards/scores
Отправляет несколько результатов в списки лидеров.

Ресурс REST: снимки

Методы
get GET /games/v1/snapshots/{snapshotId}
Извлекает метаданные для заданного идентификатора снимка.
list GET /games/v1/players/{playerId}/snapshots
Получает список снимков, созданных вашим приложением для игрока, соответствующего идентификатору игрока.

Ресурс REST: статистика

Методы
get GET /games/v1/stats
Возвращает статистику участия и расходов в этом приложении для текущего аутентифицированного пользователя.