Method: metagame.listCategoriesByPlayer

playerId에 해당하는 플레이어의 카테고리별로 집계된 재생 데이터를 나열합니다.

HTTP 요청

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

경로 매개변수

매개변수
playerId

string

플레이어 ID입니다. 인증된 플레이어의 ID 대신 me 값을 사용할 수 있습니다.

collection

enum (Collection)

데이터가 반환될 카테고리 모음입니다.

쿼리 매개변수

매개변수
language

string

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

maxResults

integer

페이징에 사용되는 응답에서 반환할 최대 카테고리 리소스 수입니다. 응답의 경우 반환된 실제 카테고리 리소스 수가 지정된 maxResults보다 적을 수 있습니다.

pageToken

string

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

요청 본문

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

응답 본문

서드 파티 목록 메타게임 카테고리 응답입니다.

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

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

string

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

nextPageToken

string

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

items[]

object (MetagameCategory)

사용 데이터가 있는 카테고리 목록입니다.

승인 범위

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

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

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

컬렉션

데이터가 반환될 카테고리를 정의합니다.

Enum
ALL 모든 카테고리의 데이터를 가져옵니다. 이는 기본값입니다.

MetagameCategory

개별 게임 카테고리와 관련된 데이터입니다.

JSON 표현
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
필드
kind

string

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

category

string

카테고리 이름입니다.

experiencePoints

string (int64 format)

이 카테고리에서 획득한 참여 점수입니다.