Method: players.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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. |
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Method: players.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPlayersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Collection](#Collection)\n- [Try it!](#try-it)\n\nGet the collection of players for the currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/me/players/{collection}`\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------|\n| `collection` | `enum (`[Collection](/games/services/web/api/rest/v1/players/list#Collection)`)` Collection of players being retrieved |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of player resources to return in the response, used for paging. For any response, the actual number of player resources returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party player list response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/players#Player) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[Player](/games/services/web/api/rest/v1/players#Player)`)` The players. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nCollection\n----------\n\n| Enums ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `CONNECTED` | Retrieve a list of players that are also playing this game in reverse chronological order. | The CONNECTED collection of G+ friends is deprecated, use the FRIENDS_ALL collection instead. |\n| `VISIBLE` | Retrieve a list of players in the user's social graph that are visible to this game. | The VISIBLE collection of G+ friends is deprecated, use the FRIENDS_ALL collection instead. |\n| `FRIENDS_ALL` | Retrieve a list of players who are friends of the user in alphabetical order. |"]]
