REST Resource: players

Recurso: Player

Un recurso Reproductor

Representación 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
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor siempre es la cadena fija games#player
playerId

string

Es el ID del jugador.
displayName

string

El nombre que se mostrará al reproductor.
avatarImageUrl

string

Es la URL base de la imagen que representa al reproductor.
bannerUrlPortrait

string

La URL a la imagen del banner del reproductor en modo Retrato.
bannerUrlLandscape

string

La URL a la imagen del banner del reproductor en modo horizontal.
originalPlayerId

string

El ID de jugador que se usó para este jugador la primera vez que accedió al juego en cuestión Solo se completa para las llamadas a player.get para el jugador solicitante, solo si el ID de jugador cambió posteriormente, y solo para los clientes que admiten la reasignación de los IDs de jugador.
profileSettings

object (ProfileSettings)

La configuración del perfil del jugador Controla si el perfil del jugador es visible o no para otros jugadores.
name

object

Es una representación de objeto de los componentes individuales del nombre del jugador. Es posible que algunos jugadores no tengan estos campos presentes.
name.familyName

string

Es el nombre de familia de este jugador. En algunos lugares, se denomina apellido.
name.givenName

string

Es el nombre de este jugador. En algunos lugares, se conoce como el nombre de pila.
experienceInfo

object (PlayerExperienceInfo)

Un objeto que representa la información de la experiencia de Play Juegos para el jugador.
title

string

Es el título del jugador como recompensa por sus actividades del juego.
friendStatus

enum (FriendStatus)

Es el estado de amigo del jugador determinado en relación con el solicitante. Esta opción no se establece si el jugador no comparte su lista de amigos con el juego.
gamePlayerId

string

Es el identificador de reproductor único por aplicación.

ProfileSettings

Configuración del perfil

Representación JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#profileSettings.
profileVisible

boolean

Indica si el perfil del jugador es visible para el jugador que accedió.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Indica si la lista de amigos del jugador es visible para este juego o si se puede solicitar. Este campo solo se completa para el jugador que actualmente accedió a su cuenta.

Enumeraciones
VISIBLE En este momento, el juego puede ver la lista de amigos.
REQUEST_REQUIRED El desarrollador no tiene acceso a la lista de amigos, pero puede llamar a la API de Android para mostrar un cuadro de diálogo de consentimiento.
UNAVAILABLE La lista de amigos no está disponible en este momento para este usuario y no es posible solicitar acceso en este momento, ya sea porque el usuario ha rechazado de manera permanente o porque la función de amigos no está disponible para él. En este estado, no se podrá solicitar acceso a la lista de amigos.

PlayerExperienceInfo

Metadatos de origen o de terceros sobre la experiencia del jugador

Representación JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

Es la cantidad actual de puntos de experiencia del jugador.
lastLevelUpTimestampMillis

string (int64 format)

Marca de tiempo en la que el jugador subió de nivel, en milisegundos, desde la época Unix UTC.
currentLevel

object (PlayerLevel)

Es el nivel actual del jugador.
nextLevel

object (PlayerLevel)

El siguiente nivel del jugador. Si el nivel actual es el máximo, debería ser igual que el nivel actual.

PlayerLevel

Metadatos propios o de terceros sobre el nivel de un usuario.

Representación JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Campos
kind

string

Identifica de forma única el tipo de este recurso. El valor es siempre la cadena fija games#playerLevel.
level

integer

El nivel del usuario.
minExperiencePoints

string (int64 format)

Es la cantidad mínima de puntos de experiencia para este nivel.
maxExperiencePoints

string (int64 format)

Es la cantidad máxima de puntos de experiencia para este nivel.

FriendStatus

Define las relaciones de amistad entre jugadores.

Enumeraciones
NO_RELATIONSHIP No hay relación entre los jugadores.
FRIEND El jugador y el solicitante son amigos.

Métodos

get

 Recupera el recurso Reproductor con el ID determinado.

getMultipleApplicationPlayerIds

 Obtén los ID de jugador de la aplicación para el jugador autenticado actualmente en todos los juegos solicitados por el mismo desarrollador de la aplicación que realiza la llamada.

getScopedPlayerIds

 Recupera identificadores de jugador con alcance para el usuario autenticado actualmente.

list

 Obtén la colección de jugadores del usuario autenticado actualmente.