Google Play Games Services API

Google Play ゲームサービスを使用すると、デベロッパーはソーシャル リーダーボード、実績、ゲームの状態、Google ログインなどの機能でゲームを強化できます。

サービス: games.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストの際に次の情報を使用してください。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械で読み取り可能仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://games.googleapis.com

REST リソース: accesstokens

メソッド
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
添付の認証情報で識別される PGS ユーザーの Play Grouping API トークンを生成します。
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
リクエストで指定されたリコール セッション ID で識別される PGS ユーザーの Play Grouping API トークンを生成します。

REST リソース: achievementDefinitions

メソッド
list GET /games/v1/achievements
アプリケーションのすべての実績定義を一覧表示します。

REST リソース: achievements

メソッド
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 リソース: applications

メソッド
get GET /games/v1/applications/{applicationId}
指定された ID のアプリケーションのメタデータを取得します。
getEndPoint POST /games/v1/applications/getEndPoint
リクエストされた目的地の URL を返します。
played POST /games/v1/applications/played
現在認証されているユーザーがアプリケーションをプレイしていることを示します。
verify GET /games/v1/applications/{applicationId}/verify
このリクエストで指定された認証トークンが、指定された ID のアプリケーションのものであることを確認し、そのトークンが付与されたプレーヤーの ID を返します。

REST リソース: events

メソッド
listByPlayer GET /games/v1/events
現在認証されているユーザーについて、このアプリケーションのイベントの現在の進捗状況を示すリストを返します。
listDefinitions GET /games/v1/eventDefinitions
このアプリケーションのイベント定義のリストを返します。
record POST /games/v1/events
このアプリケーションの現在認証されているユーザーについて、イベントの発生回数の変更をバッチで記録します。

REST リソース: gameStats

メソッド
batchRecordEvents POST /games/v1/players/{playerId}/gameStats:batchRecordEvents
特定のプレーヤーのプレーヤー ゲーム イベントをバッチで記録します。

REST リソース: leaderboards

メソッド
get GET /games/v1/leaderboards/{leaderboardId}
指定された ID のリーダーボードのメタデータを取得します。
list GET /games/v1/leaderboards
アプリケーションのすべてのリーダーボード メタデータを一覧表示します。

REST リソース: metagame

メソッド
getMetagameConfig GET /games/v1/metagameConfig
呼び出し元のアプリケーションのメタゲーム構成データを返します。
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
playerId に対応するプレーヤーについて、カテゴリごとに集計されたプレイデータを一覧表示します。

REST リソース: players

メソッド
get GET /games/v1/players/{playerId}
指定された ID のプレーヤー リソースを取得します。
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
呼び出し元のアプリケーションと同じデベロッパーのすべてのリクエストされたゲームについて、現在認証されているプレーヤーのアプリケーション プレーヤー ID を取得します。
getScopedPlayerIds GET /games/v1/players/me/scopedIds
現在認証されているユーザーのスコープ付きプレーヤー ID を取得します。
list GET /games/v1/players/me/players/{collection}
現在認証されているユーザーのプレーヤーのコレクションを取得します。

REST リソース: recall

メソッド
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
指定されたリコール セッション ID でエンコードされた PGS プレーヤーに関連付けられている、リクエストされたすべてのゲームからリコール トークンを取得します。
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
指定されたリコール セッション ID でエンコードされた PGS プレーヤーに関連付けられている、デベロッパーのすべてのゲームから最後のリコール トークンを取得します。
linkPersona POST /games/v1/recall:linkPersona
指定されたリコール セッション ID でエンコードされた PGS プレーヤー プリンシパルをゲーム内アカウントに関連付けます。
resetPersona POST /games/v1/recall:resetPersona
指定されたペルソナをプレーヤー（プロフィールの有無を問わず）にリンクするすべてのリコール トークンを削除します。
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
指定されたリコール セッション ID でエンコードされた PGS プレーヤーに関連付けられているすべてのリコール トークンを取得します。
unlinkPersona POST /games/v1/recall:unlinkPersona
リコール セッションで識別される PGS プレーヤー プリンシパルと、'persona' またはトークン値で識別されるゲーム内アカウントをリンクするリコール トークンを削除します。

REST リソース: revisions

メソッド
check GET /games/v1/revisions/check
ゲーム クライアントが最新かどうかを確認します。

REST リソース: scores

メソッド
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 リソース: snapshots

メソッド
get GET /games/v1/snapshots/{snapshotId}
指定されたスナップショット ID のメタデータを取得します。
list GET /games/v1/players/{playerId}/snapshots
プレーヤー ID に対応するプレーヤーについて、アプリケーションで作成されたスナップショットのリストを取得します。

REST リソース: stats

メソッド
get GET /games/v1/stats
現在認証されているユーザーについて、このアプリケーションのエンゲージメントと支出の統計情報を返します。