認証が必要です
指定されたアプリで非表示になっているプレーヤーのリストを取得します。この方法は、デベロッパー コンソールのユーザー アカウントでのみ使用できます。
リクエスト
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 |
ゲーム アクティビティに対して報酬が与えられるプレーヤーのタイトル。 |