REST Resource: players

Recurso: Reproductor

Un recurso del jugador.

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 es siempre la cadena fija games#player
playerId

string

Es el ID del reproductor.
displayName

string

Es el nombre que se mostrará para el reproductor.
avatarImageUrl

string

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

string

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

string

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

string

Indica el ID de jugador que se utilizó la primera vez que accedió al juego en cuestión. Este campo solo se completa con las llamadas a player.get del jugador solicitante, solo si el ID de jugador cambió posteriormente, y solo para clientes que admiten la reasignación de IDs de jugador.
profileSettings

object (ProfileSettings)

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

object

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

string

El apellido de este jugador. En algunos lugares, esto se conoce como el apellido.
name.givenName

string

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

object (PlayerExperienceInfo)

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

string

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

enum (FriendStatus)

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

string

Es el identificador de jugador ú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 siempre es la cadena fija games#profileSettings.
profileVisible

boolean

Si el perfil del jugador es visible para el jugador conectado
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 actualmente conectado.

Enumeradores
VISIBLE Por el 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 actualmente no está disponible para este usuario, y no es posible solicitar acceso en este momento, ya sea porque el usuario ha rechazado la invitación de forma permanente o porque la función de amigos no está disponible para él. En este estado, no se podrán solicitar acceso a la lista de amigos.

PlayerExperienceInfo

Metadatos propios 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 siempre es la cadena fija games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

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

string (int64 format)

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

object (PlayerLevel)

Indica el nivel actual del jugador.
nextLevel

object (PlayerLevel)

El siguiente nivel del jugador. Si el nivel actual es el máximo, debe ser el mismo 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 siempre es la cadena fija games#playerLevel.
level

integer

Es el nivel del usuario.
minExperiencePoints

string (int64 format)

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

string (int64 format)

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

FriendStatus

Define las relaciones de amistad entre los jugadores.

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

Métodos

get

 Recupera el recurso Player con el ID determinado.

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

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

list

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