Applications: listHidden

認証が必要です

指定したアプリから非表示になっているプレーヤーのリストを取得します。この方法は、デベロッパー コンソールのユーザー アカウントでのみ使用できます。

リクエスト

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 Games エクスペリエンス情報を表すオブジェクト。
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 ゲーム アクティビティに対してプレーヤーに付与された称号。
items[].hiddenTimeMillis long このプレーヤーが非表示になった時刻。