Google Play ゲームサービスを使用すると、デベロッパーはソーシャル リーダーボード、実績、ゲームの状態、Google でのログインなどの機能でゲームを強化できます。
- REST リソース: accesstokens
- REST リソース: achievementDefinitions
- REST リソース: achievements
- REST リソース: アプリケーション
- REST リソース: events
- REST リソース: leaderboards
- REST リソース: metagame
- REST リソース: playerGameEvents
- REST リソース: players
- REST リソース: recall
- REST リソース: revisions
- REST リソース: スコア
- REST リソース: スナップショット
- REST リソース: stats
サービス: 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 ユーザーの Google 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 リソース: playerGameEvents
| メソッド | |
|---|---|
batchRecordEvents |
POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents 特定のプレーヤーのプレーヤー ゲーム イベントのバッチを記録します。 |
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 プレーヤー プリンシパルと、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 現在認証されているユーザーのこのアプリケーションでのエンゲージメントと費用の統計情報を返します。 |