Richiede l'autorizzazione
Recupera l'elenco dei player nascosti nell'applicazione specificata. Questo metodo è disponibile soltanto per gli account utente della tua console per gli sviluppatori.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
applicationId |
string |
L'ID applicazione di Google Play Console. |
Parametri di query facoltativi | ||
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.
I valori accettati sono compresi tra 1 e 15 .
|
pageToken |
string |
Il token restituito dalla richiesta precedente. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/games |
Corpo della richiesta
Non fornire il corpo di una richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
kind |
string |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
Il token di impaginazione per la pagina successiva dei risultati. | |
items[] |
list |
I giocatori. | |
items[].kind |
string |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
Le informazioni sul player. | |
items[].player.kind |
string |
Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa gamesManagement#player . |
|
items[].player.playerId |
string |
L'ID del player. | |
items[].player.displayName |
string |
Il nome da visualizzare per il player. | |
items[].player.avatarImageUrl |
string |
L'URL di base per l'immagine che rappresenta il player. | |
items[].player.lastPlayedWith |
nested object |
Dettagli sull'ultima volta che questo giocatore ha giocato a un gioco multiplayer con il giocatore attualmente autenticato. Compilato per i membri della raccolta giocatore PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
L'ultima volta che il giocatore ha giocato al gioco, in millisecondi dall'epoca (UTC). | |
items[].player.lastPlayedWith.autoMatched |
boolean |
True se è stata trovata una corrispondenza automatica del player con l'utente attualmente autenticato. | |
items[].player.name |
object |
Una rappresentazione oggetto dei singoli componenti del nome del player. Per alcuni giocatori, questi campi potrebbero non essere presenti. | |
items[].player.name.familyName |
string |
Il cognome del giocatore. In alcuni luoghi viene chiamato cognome. | |
items[].player.name.givenName |
string |
Il nome assegnato al giocatore. In alcuni luoghi viene chiamato nome. | |
items[].player.experienceInfo |
nested object |
Un oggetto che rappresenta le informazioni relative all'esperienza di gioco di Play per il giocatore. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Il numero attuale di punti esperienza per il player. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Il timestamp in cui il giocatore è salito di livello, in millisecondi dall'epoca di Unix (UTC). | |
items[].player.experienceInfo.currentLevel |
nested object |
Il livello corrente del player. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Il livello per l'utente. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Il numero minimo di punti esperienza per questo livello. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Il numero massimo di punti esperienza per questo livello. | |
items[].player.experienceInfo.nextLevel |
nested object |
Il livello successivo del player. Se il livello corrente è il livello massimo, deve essere uguale a quello attuale. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Il livello per l'utente. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Il numero minimo di punti esperienza per questo livello. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Il numero massimo di punti esperienza per questo livello. | |
items[].player.title |
string |
Il titolo del giocatore premiato per le sue attività di gioco. |