Method: players.list

Pobieranie kolekcji odtwarzaczy dla obecnie uwierzytelnionego użytkownika.

Żądanie HTTP

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

Parametry ścieżki

Parametry
collection

enum (Collection)

Pobieram kolekcję graczy

Parametry zapytania

Parametry
language

string

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

maxResults

integer

Maksymalna liczba zasobów odtwarzacza do zwrócenia w odpowiedzi, używanych na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów odtwarzacza może być mniejsza od określonej wartości maxResults.

pageToken

string

Token zwrócony przez poprzednie żądanie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź z listą 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ścią jest zawsze stały ciąg 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 protokołu 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óre są dla niej widoczne.

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