Method: players.list

Recupera la raccolta di giocatori per l'utente attualmente autenticato.

Richiesta HTTP

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

Parametri del percorso

Parametri
collection

enum (Collection)

Raccolta di giocatori in fase di recupero

Parametri di query

Parametri
language

string

La lingua preferita da utilizzare per le stringhe restituite da questo metodo.

maxResults

integer

Il numero massimo di risorse del player da restituire nella risposta, utilizzato per il paging. Per qualsiasi risposta, il numero effettivo di risorse del player restituite potrebbe essere inferiore al valore maxResults specificato.

pageToken

string

Il token restituito dalla richiesta precedente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta relativa all'elenco di player di terze parti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#playerListResponse.

nextPageToken

string

Token corrispondente alla pagina successiva dei risultati.

items[]

object (Player)

I giocatori.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

Collezione

Enum
CONNECTED

Recupera un elenco dei giocatori che stanno giocando a questo gioco in ordine cronologico inverso.

VISIBLE

Recupera un elenco di giocatori nel grafo sociale dell'utente visibili a questo gioco.

FRIENDS_ALL Recupera un elenco alfabetico dei giocatori che sono amici dell'utente.