Google Play Game Services

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

サービス: games.googleapis.com

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

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

ディスカバリ ドキュメントは、REST API を記述および使用するための仕様を機械可読形式で表したものです。これは、クライアント ライブラリや IDE プラグインなど、Google API とやり取りするツールを作成するために使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

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

  • 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 リソース: 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 の Player リソースを取得します。
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
指定されたペルソナをプレイヤー（プロフィールありまたはなし）にリンクしているすべての Recall トークンを削除します。
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
指定されたリコール セッション ID にエンコードされた PGS プレーヤーに関連付けられているすべてのリコール トークンを取得します。
unlinkPersona POST /games/v1/recall:unlinkPersona
リコール セッションで識別された PGS プレーヤー プリンシパルと、「ペルソナ」またはトークン値で識別されたゲーム内アカウントをリンクするリコール トークンを削除します。

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
現在認証されているユーザーの、このアプリでのエンゲージメントと費用の統計情報を返します。