このページは Cloud Translation API によって翻訳されました。

Players: list

現在認証されているユーザーのプレーヤーコレクションを取得します。実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/games/v1/players/me/players/collection

パラメータ

パラメータ名	値	説明
パスパラメータ
`collection`	`string`	取得されるプレーヤーのコレクション有効な値は次のとおりです。 "`connected`":（非推奨）このゲームもプレイしているプレーヤーのリストを新しい順で取得します。 `friends_all` : ユーザーの友だちであるアルファベット順のリストを取得します。 "`playedWith`":（非推奨）最近マルチプレーヤーゲーム（リアルタイムまたはターンベース）でプレイしたプレーヤーのリストを取得します。 "`played_with`":（非推奨）最近マルチプレーヤーゲーム（リアルタイムまたはターンベース）でプレイしたプレーヤーのリストを取得します。 "`visible`":（非推奨: Friends_ALL を使用してください）このゲームに表示される、ユーザーのソーシャルグラフ内のプレーヤーのリストを取得します。
省略可能なクエリパラメータ
`language`	`string`	このメソッドから返される文字列に使用する言語。
`maxResults`	`integer`	レスポンスで返すプレーヤーリソースの最大数。ページ設定に使用されます。どのようなレスポンスであっても、実際に返されるプレーヤーリソースの数は、指定した `maxResults` より少なくなる場合があります。有効な値は `1`～`50`（指定した値を含む）です。
`pageToken`	`string`	前のリクエストによって返されたトークン。

承認

このリクエストには、次のスコープによる認証が必要です。

範囲
`https://www.googleapis.com/auth/games`

詳細については、認証と承認のページをご覧ください。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "games#playerListResponse",
  "nextPageToken": string,
  "items": [
    players Resource
  ]
}

プロパティ名	値	説明
`kind`	`string`	このリソースの種類を一意に識別します。値は常に固定文字列の `games#playerListResponse` です。
`nextPageToken`	`string`	結果の次のページに対応するトークン。
`items[]`	`list`	プレーヤー。

実習

以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。