Google Play Games サービスでは、ソーシャル リーダーボード、実績、ゲーム ステータス、Google でログインなど、さまざまな機能を利用してゲームの機能を強化できます。
- REST リソース: AssessmentDefinitions
- REST リソース: 実績
- REST リソース: applications
- REST リソース: events
- REST リソース: リーダーボード
- REST リソース: metagame
- REST リソース: player
- REST リソース: 再現率
- REST リソース: リビジョン
- REST リソース: score
- REST リソース: スナップショット
- REST リソース: stats
サービス: Games.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 現在認証されているユーザーのスコープ設定されたプレーヤー識別子を取得します。 |
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 特定のペルソナと任意のプレーヤー（プロフィールの有無にかかわらず）をリンクする Recall トークンをすべて削除します。 |
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 現在認証されているユーザーについて、このアプリでのエンゲージメントと費用の統計情報を返します。 |