Google Play Games Services API

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

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

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

Документ об обнаружении

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

конечная точка сервиса

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

  • https://games.googleapis.com

REST-ресурс: accesstokens

Методы
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Генерирует токен API для группировки игровых ситуаций (Play Grouping API) для пользователя PGS, идентифицированного с помощью прикрепленных учетных данных.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Генерирует токен API для группировки игр для пользователя PGS, идентифицированного по идентификатору сессии Recall, указанному в запросе.

REST-ресурс: achievementDefinitions

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

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

Методы
increment POST /games/v1/achievements/{achievementId}/increment
Увеличивает количество шагов достижения для указанного ID текущего авторизованного игрока.
list GET /games/v1/players/{playerId}/achievements
Отображает прогресс выполнения всех достижений вашего приложения для текущего авторизованного игрока.
reveal POST /games/v1/achievements/{achievementId}/reveal
Устанавливает статус достижения с заданным ID в значение 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-ресурс: playerGameEvents

Методы
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Записывает пакет игровых событий для конкретного игрока.

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

Методы
get GET /games/v1/players/{playerId}
Получает ресурс Player с заданным ID.
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, закодированный в предоставленном идентификаторе сессии отзыва.
linkPersona POST /games/v1/recall:linkPersona
Свяжите учетную запись игрока PGS, закодированную в предоставленном идентификаторе сессии, с внутриигровой учетной записью.
resetPersona POST /games/v1/recall:resetPersona
Удалите все токены «Recall», связывающие данную персону с любым игроком (с профилем или без него).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Получите все токены отзыва, связанные с проигрывателем PGS, закодированные в предоставленном идентификаторе сессии отзыва.
unlinkPersona POST /games/v1/recall:unlinkPersona
Удалите токен Recall, связывающий субъект PGS Player, идентифицированный в сессии Recall, и внутриигровую учетную запись, идентифицированную либо по «персоне», либо по значению токена.

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
Возвращает статистику активности и расходов в этом приложении для текущего авторизованного пользователя.