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 player in fase di recupero

Parametri di ricerca

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

Risposta di un 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 dei risultati successiva.

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.

Raccolta

Enum
CONNECTED

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

VISIBLE

Recupera nel grafico sociale dell'utente un elenco dei giocatori che sono visibili per questo gioco.

FRIENDS_ALL Recupera un elenco dei giocatori amici dell'utente in ordine alfabetico.