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 mostrare per il player.
avatarImageUrl

string

L'URL di base dell'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 il giocatore la prima volta che ha eseguito l'accesso al gioco in questione. Il campo viene compilato solo per le chiamate al player.get per il player che ha inviato la richiesta, solo se l'ID player è stato modificato in un secondo momento, e solo per i client che supportano la rimappatura degli ID giocatore.
profileSettings

object (ProfileSettings)

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

object

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

string

Il cognome di questo giocatore. In alcuni luoghi è noto come cognome.
name.givenName

string

Il nome di questo giocatore. In alcuni luoghi è noto come nome.
experienceInfo

object (PlayerExperienceInfo)

Un oggetto che rappresenta le informazioni sull'esperienza del gioco di Google Play per il giocatore.
title

string

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

enum (FriendStatus)

Lo stato di amico del giocatore specificato rispetto al richiedente. Il valore non viene 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

Indica se il profilo del giocatore è visibile al giocatore che ha eseguito l'accesso.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Indica 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 Al momento, l'elenco di amici è 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 al momento non è possibile richiedere l'accesso perché l'utente ha rifiutato in modo permanente o perché non può utilizzare la funzione di amicizia. In questo stato, qualsiasi tentativo di richiedere l'accesso all'elenco di amici non avrà esito positivo.

PlayerExperienceInfo

I metadati proprietari/di terze parti relativi all'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 del giocatore.
lastLevelUpTimestampMillis

string (int64 format)

Timestamp del miglioramento del player, espresso in millisecondi dall'epoca Unix UTC.
currentLevel

object (PlayerLevel)

Il livello attuale del player.
nextLevel

object (PlayerLevel)

Il livello successivo del player. Se il livello attuale è il massimo, deve corrispondere al livello attuale.

PlayerLevel

Metadati proprietari/di terze parti relativi al 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 c'è 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 giocatore attualmente autenticato in tutti i giochi richiesti dallo stesso sviluppatore dell'applicazione per la 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.