Method: players.list

Ruft die Sammlung der Spieler für den derzeit authentifizierten Nutzer ab.

HTTP-Anfrage

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

Pfadparameter

Parameter
collection

enum (Collection)

Sammlung von Spielern, die abgerufen werden

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache für Strings, die von dieser Methode zurückgegeben werden.

maxResults

integer

Die maximale Anzahl von Player-Ressourcen, die in der Antwort zurückgegeben werden sollen; wird für die Seitenordnung verwendet. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Spielerressourcen unter dem angegebenen maxResults liegen.

pageToken

string

Das von der vorherigen Anfrage zurückgegebene Token.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Antwort auf die Playerliste eines Drittanbieters.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
Felder
kind

string

Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#playerListResponse.

nextPageToken

string

Token für die nächste Ergebnisseite.

items[]

object (Player)

Die Spieler.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

Sammlung

Enums
CONNECTED

Rufen Sie eine Liste der Spieler ab, die dieses Spiel ebenfalls spielen, in umgekehrter chronologischer Reihenfolge.

VISIBLE

Liste der Spieler im Social Graph des Nutzers abrufen, die für dieses Spiel sichtbar sind

FRIENDS_ALL Rufe eine alphabetisch geordnete Liste der Spieler ab, die mit dem Nutzer befreundet sind.