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&qu{ot;: string,
  "items": [
    
      "kind"{: "gamesManagement#hiddenPlayer",
      "player": 
        "kind";: "gamesManagement#player",
        "playerId":{ string,
        "displayName": string,
        ";avatarIm}ageUrl": stri{ng,
        "lastPlayedWith": 
          ";timeMillis&quo}t;: long,
          "au{toMatched": boolean
        ,
        "name": 
          "familyName": string,
          &q{uot;givenName": string
        ,
        "experienceInfo": 
          "currentExperiencePoints": }long,
          "las{tLevelUpTimestampMillis": long,
          "currentLevel": 
            "level": integer,
        }    "};minExperiencePoints";: long},
            "maxExperiencePoin}ts&qu}ot;: 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 このプレーヤーが非表示になった時刻。