Method: players.list

현재 인증된 사용자의 플레이어 컬렉션을 가져옵니다.

HTTP 요청

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

경로 매개변수

매개변수
collection

enum (Collection)

가져오는 플레이어 컬렉션

쿼리 매개변수

매개변수
language

string

이 메서드가 반환하는 문자열에 사용할 기본 언어입니다.
maxResults

integer

페이징에 사용되고 응답에서 반환할 플레이어 리소스의 최대 개수입니다. 어떤 응답이든 반환되는 플레이어 리소스의 실제 개수는 지정된 maxResults보다 적을 수 있습니다.
pageToken

string

이전 요청에서 반환된 토큰입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

타사 플레이어 목록 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
필드
kind

string

이 리소스의 유형을 고유하게 식별합니다. 값은 항상 고정 문자열 games#playerListResponse입니다.
nextPageToken

string

결과의 다음 페이지에 해당하는 토큰입니다.
items[]

object (Player)

플레이어

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

자세한 내용은 OAuth 2.0 개요를 참고하세요.

컬렉션

열거형
CONNECTED

이 게임을 함께 하고 있는 플레이어 목록을 시간 역순으로 검색합니다.
VISIBLE

사용자의 소셜 그래프에서 이 게임에 표시되는 플레이어 목록을 검색합니다.
FRIENDS_ALL 사용자의 친구인 플레이어 목록을 알파벳순으로 검색합니다.