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