Google Play Game Services

Google Play Games サービスを利用すると、デベロッパーはソーシャル リーダーボード、実績、ゲーム ステータス、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
リクエストで指定された Recall セッション 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 リソース: リーダーボード

メソッド
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 Player に関連付けられている、リクエストされたすべてのゲームからリコール トークンを取得します。
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
指定されたリコール セッション ID でエンコードされた PGS Player に関連付けられているすべてのデベロッパー ゲームから、最後のリコール トークンを取得します。
linkPersona POST /games/v1/recall:linkPersona
指定されたリコール セッション ID にエンコードされた PGS プレーヤー プリンシパルをゲーム内アカウントに関連付けます。
resetPersona POST /games/v1/recall:resetPersona
特定のペルソナを任意のプレーヤーにリンクする Recall トークンをすべて削除します（プロフィールの有無は問いません）。
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
指定されたリコール セッション ID にエンコードされた PGS Player に関連付けられているすべてのリコール トークンを取得します。
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
現在認証されているユーザーについて、このアプリケーションでのエンゲージメントと費用の統計情報を返します。