REST Resource: players

Risorsa: player

Una risorsa Player.

Rappresentazione JSON 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
Campi
kind

string

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

string

L'ID del player.
displayName

string

Il nome da visualizzare per il player.
avatarImageUrl

string

L'URL di base per l'immagine che rappresenta il player.
bannerUrlPortrait

string

L'URL dell'immagine del banner del player in modalità verticale.
bannerUrlLandscape

string

L'URL dell'immagine del banner del player in modalità Orizzontale.
originalPlayerId

string

L'ID giocatore utilizzato per la prima volta che il giocatore ha eseguito l'accesso al gioco in questione. Questo campo viene compilato solo per le chiamate a player.get per il player richiedente, solo se l'ID player è stato successivamente modificato e solo per i client che supportano la rimappatura degli ID player.
profileSettings

object (ProfileSettings)

Le impostazioni del profilo del giocatore. Controlla se il profilo del giocatore è visibile o meno agli altri giocatori.
name

object

Una rappresentazione oggetto dei singoli componenti del nome del player. Per alcuni giocatori, questi campi potrebbero non essere presenti.
name.familyName

string

Il cognome del giocatore. In alcuni luoghi viene chiamato cognome.
name.givenName

string

Il nome assegnato al giocatore. In alcuni luoghi viene chiamato nome.
experienceInfo

object (PlayerExperienceInfo)

Un oggetto che rappresenta le informazioni relative all'esperienza di gioco di Play per il giocatore.
title

string

Il titolo del giocatore premiato per le sue attività di gioco.
friendStatus

enum (FriendStatus)

Lo stato di amicizia del giocatore specificato, in relazione al richiedente. Non è impostato se il giocatore non condivide il suo elenco di amici con il gioco.
gamePlayerId

string

Identificatore univoco del player per applicazione.

ProfileSettings

Impostazioni del profilo

Rappresentazione JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Campi
kind

string

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

boolean

Se il profilo del giocatore è visibile al giocatore attualmente connesso.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Se l'elenco di amici del giocatore è visibile per questo gioco o può essere richiesto. Questo campo viene compilato solo per il player attualmente connesso.

Enum
VISIBLE L'elenco di amici è attualmente visibile per il gioco.
REQUEST_REQUIRED Lo sviluppatore non ha accesso all'elenco di amici, ma può chiamare l'API Android per mostrare una finestra di dialogo per il consenso.
UNAVAILABLE L'elenco di amici non è al momento disponibile per questo utente e non è possibile richiedere l'accesso in questo momento perché l'utente ha rifiutato definitivamente o perché la funzione relativa agli amici non è disponibile. In questo stato, qualsiasi tentativo di richiedere l'accesso all'elenco di amici non andrà a buon fine.

PlayerExperienceInfo

Metadati proprietari/di terze parti sull'esperienza del giocatore.

Rappresentazione JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Campi
kind

string

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

string (int64 format)

Il numero attuale di punti esperienza per il player.
lastLevelUpTimestampMillis

string (int64 format)

Il timestamp in cui il giocatore è salito di livello, in millisecondi dall'epoca di Unix (UTC).
currentLevel

object (PlayerLevel)

Il livello corrente del player.
nextLevel

object (PlayerLevel)

Il livello successivo del player. Se il livello corrente è il livello massimo, deve essere uguale a quello attuale.

PlayerLevel

Metadati proprietari/di terze parti sul livello di un utente.

Rappresentazione JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Campi
kind

string

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

integer

Il livello per l'utente.
minExperiencePoints

string (int64 format)

Il numero minimo di punti esperienza per questo livello.
maxExperiencePoints

string (int64 format)

Il numero massimo di punti esperienza per questo livello.

FriendStatus

Definisce i rapporti di amicizia tra i giocatori.

Enum
NO_RELATIONSHIP Non esiste alcuna relazione tra i giocatori.
FRIEND Il giocatore e il richiedente sono amici.

Metodi

get

 Recupera la risorsa Player con l'ID specificato.

getMultipleApplicationPlayerIds

 Ottieni gli ID player dell'applicazione per il player attualmente autenticato in tutti i giochi richiesti dallo stesso sviluppatore dell'applicazione di chiamata.

getScopedPlayerIds

 Recupera gli identificatori dei player con ambito per l'utente attualmente autenticato.

list

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