Google Play Games サービスを利用すると、デベロッパーはソーシャル リーダーボード、実績、ゲーム ステータス、Google によるログインなどでゲームを強化できます。
- REST リソース: AchieveDefinitions
- REST リソース: 実績
- REST リソース: アプリケーション
- REST リソース: イベント
- REST リソース: リーダーボード
- REST リソース: メタゲーム
- REST リソース: プレーヤー
- REST リソース: 再現
- REST リソース: リビジョン
- REST リソース: Score
- REST リソース: スナップショット
- REST リソース: stats
サービス: 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 現在認証されているユーザーの、このアプリでのエンゲージメントと費用の統計情報を返します。 |