Method: players.list

Pobierz kolekcję graczy dla aktualnie uwierzytelnionego użytkownika.

Żądanie HTTP

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

Parametry ścieżki

Parametry
collection

enum (Collection)

Kolekcja graczy, które są pobierane

Parametry zapytania

Parametry
language

string

Preferowany język używany w przypadku ciągów tekstowych zwracanych przez tę metodę.

maxResults

integer

Maksymalna liczba zasobów odtwarzacza do zwrócenia w odpowiedzi używanej na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów graczy może być mniejsza niż podana wartość maxResults.

pageToken

string

Token zwrócony przez poprzednie żądanie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dotycząca listy graczy innej firmy.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#playerListResponse.

nextPageToken

string

Token odpowiadający następnej stronie wyników.

items[]

object (Player)

Gracze.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Kolekcja

Wartości w polu enum
CONNECTED

Pobierz listę graczy, którzy również grają w tę grę, w odwrotnej kolejności chronologicznej.

VISIBLE

Pobierz listę graczy z wykresu społecznościowego użytkownika, którzy są widoczni w tej grze.

FRIENDS_ALL Pobierz listę graczy, którzy są znajomymi użytkownika, w kolejności alfabetycznej.