REST Resource: players

Recurso: Reproductor

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

string

Es el ID del jugador.
displayName

string

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

string

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

string

Es la URL de la imagen del banner del reproductor en modo vertical.
bannerUrlLandscape

string

Es la URL de la imagen del banner del reproductor en modo horizontal.
originalPlayerId

string

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

object (ProfileSettings)

La configuración del perfil del jugador. Controla si otros jugadores pueden ver el perfil del jugador.
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 en algunos jugadores.
name.familyName

string

Es el apellido de este reproductor. En algunos lugares, se conoce como apellido.
name.givenName

string

Es el nombre de este jugador. En algunos lugares, se conoce como 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 que se le otorga al jugador por sus actividades en el juego.
friendStatus

enum (FriendStatus)

Es el estado de amigo del jugador determinado en relación con el solicitante. No se establece 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

Indica si el perfil del jugador que accedió actualmente es visible para él.
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 accedió actualmente.

Enums
VISIBLE Actualmente, 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 diálogo de consentimiento.
UNAVAILABLE La lista de amigos no está disponible para este usuario en este momento y no es posible solicitar acceso en este momento, ya sea porque el usuario rechazó la solicitud de forma permanente o porque la función de amigos no está disponible para él. En este estado, no se realizará ningún intento de 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)

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

object (PlayerLevel)

Es el nivel actual del jugador.
nextLevel

object (PlayerLevel)

Es el siguiente nivel del jugador. Si el nivel actual es el máximo, este 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)

Los puntos de experiencia mínimos 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 los jugadores.

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

Métodos

get

 Recupera el recurso de jugador con el ID determinado.

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

 Recupera los identificadores de jugador centrados para el usuario autenticado actualmente.

list

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