Google Play Game Services

Google Play Games サービスを利用すると、デベロッパーはソーシャル リーダーボード、実績、ゲーム ステータス、Google によるログインなどでゲームを強化できます。

サービス: game.googleapis.com

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

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

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

サービス エンドポイント

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

  • https://games.googleapis.com

REST リソース: achievementDefinitions

Methods
list GET /games/v1/achievements
アプリのすべての実績の定義をリストします。

REST リソース: achievements

Methods
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

Methods
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

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

REST リソース: リーダーボード

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

REST リソース: metagame

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

REST リソース: players

Methods
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

Methods
linkPersona POST /games/v1/recall:linkPersona
提供されたリコール セッション ID でエンコードされている PGS プレーヤー プリンシパルをゲーム内アカウントに関連付けます
resetPersona POST /games/v1/recall:resetPersona
特定のペルソナと任意のプレーヤー（プロフィールの有無にかかわらず）をリンクするリコール トークンをすべて削除します。
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
指定されたリコール セッション ID でエンコードされている PGS プレーヤー プリンシパルに関連付けられた Recall トークンをすべて取得します。
unlinkPersona POST /games/v1/recall:unlinkPersona
リコール セッションで識別される PGS プレーヤー プリンシパルと、「ペルソナ」またはトークン値によって識別されるゲーム内アカウントをリンクするリコール トークンを削除します。

REST リソース: リビジョン

Methods
check GET /games/v1/revisions/check
ゲーム クライアントが古くなっているかどうかを確認します。

REST リソース: scores

Methods
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

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

REST リソース: stats

Methods
get GET /games/v1/stats
現在認証されているユーザーの、このアプリでのエンゲージメントと費用の統計情報を返します。