認証が必要です
指定されたアプリケーションで非表示のプレーヤーのリストを取得します。この方法は、Developer Console のユーザー アカウントでのみ使用できます。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
applicationId |
string |
Google Play Console のアプリケーション ID。 |
省略可能なクエリ パラメータ | ||
maxResults |
integer |
レスポンスで返すプレーヤー リソースの最大数。ページングに使用されます。どのようなレスポンスでも、返されるプレーヤー リソースの実際の数は、指定した maxResults より少なくなる可能性があります。
有効な値は 1 ~15 です。 |
pageToken |
string |
前のリクエストによって返されたトークン。 |
承認
このリクエストは、次のスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
スコープ |
---|
https://www.googleapis.com/auth/games |
リクエスト本文
このメソッドをリクエストの本文に含めないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
kind |
string |
このリソースのタイプを一意に識別します。値は常に固定文字列 gamesManagement#hiddenPlayerList です。 |
|
nextPageToken |
string |
結果の次のページのページ設定トークン。 | |
items[] |
list |
選手。 | |
items[].kind |
string |
このリソースのタイプを一意に識別します。値は常に固定文字列 gamesManagement#hiddenPlayer です。 |
|
items[].player |
nested object |
プレーヤー情報。 | |
items[].player.kind |
string |
このリソースのタイプを一意に識別します。値は常に固定文字列 gamesManagement#player です。 |
|
items[].player.playerId |
string |
プレーヤーの ID。 | |
items[].player.displayName |
string |
プレーヤーに表示する名前。 | |
items[].player.avatarImageUrl |
string |
プレーヤーを表す画像のベース URL。 | |
items[].player.lastPlayedWith |
nested object |
このプレーヤーが現在認証されているプレーヤーと最後にマルチプレーヤー ゲームをプレイした時間の詳細。PLAYED_WITH プレーヤー コレクション メンバーについて入力されます。 | |
items[].player.lastPlayedWith.timeMillis |
long |
プレーヤーが最後にゲームをプレイした時間(エポックからのミリ秒数)(UTC)。 | |
items[].player.lastPlayedWith.autoMatched |
boolean |
プレーヤーが現在認証されているユーザーと自動対戦していた場合は true。 | |
items[].player.name |
object |
プレーヤー名の個々のコンポーネントのオブジェクト表現。一部のプレーヤーでは、これらのフィールドが存在しない場合があります。 | |
items[].player.name.familyName |
string |
このプレーヤーの姓。姓と呼ばれることもあります。 | |
items[].player.name.givenName |
string |
このプレーヤーの名。名前はファーストネームと呼ばれることもあります。 | |
items[].player.experienceInfo |
nested object |
プレーヤーの Play ゲームのエクスペリエンス情報を表すオブジェクト。 | |
items[].player.experienceInfo.currentExperiencePoints |
long |
プレーヤーの現在の経験値。 | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
プレーヤーがレベルアップしたときのタイムスタンプ(Unix エポック UTC からのミリ秒数)。 | |
items[].player.experienceInfo.currentLevel |
nested object |
プレーヤーの現在のレベル。 | |
items[].player.experienceInfo.currentLevel.level |
integer |
ユーザーのレベル。 | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
このレベルでの最小経験値。 | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
このレベルでの最大経験値。 | |
items[].player.experienceInfo.nextLevel |
nested object |
プレーヤーの次のレベルです。現在のレベルが最大レベルである場合は、現在のレベルと同じである必要があります。 | |
items[].player.experienceInfo.nextLevel.level |
integer |
ユーザーのレベル。 | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
このレベルでの最小経験値。 | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
このレベルでの最大経験値。 | |
items[].player.title |
string |
ゲーム アクティビティの報酬がプレーヤーに支払われるタイトル。 |