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 ゲームのエクスペリエンス情報を表すオブジェクト。
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 このプレーヤーが非表示になった時刻。