Method: players.list

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

HTTP-Anfrage

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

Pfadparameter

Parameter
collection

enum (Collection)

Sammlung von Spielern wird abgerufen

Abfrageparameter

Parameter
language

string

Die bevorzugte Sprache, die für Strings verwendet wird, 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 kleiner als die angegebene maxResults sein.

pageToken

string

Das von der vorherigen Anfrage zurückgegebene Token.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Drittanbieter-Spielerlisten-Antwort.

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

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

string

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

nextPageToken

string

Token, das der nächsten Ergebnisseite entspricht.

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, die dieses Spiel ebenfalls spielen, in umgekehrter chronologischer Reihenfolge ab.

VISIBLE

Ruft eine Liste der Spieler im Social Graph des Nutzers ab, die für dieses Spiel sichtbar sind.

FRIENDS_ALL Ruft eine alphabetische Liste von Spielern ab, die Freunde des Benutzers sind.