REST Resource: players

Ressource: Lecteur

Ressource "Player" (Lecteur).

Représentation 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
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#player
playerId

string

ID du joueur.
displayName

string

Nom à afficher pour le joueur.
avatarImageUrl

string

URL de base de l'image qui représente le joueur.
bannerUrlPortrait

string

URL de l'image de la bannière du lecteur en mode Portrait.
bannerUrlLandscape

string

URL de l'image de la bannière du lecteur en mode Paysage.
originalPlayerId

string

L'ID utilisé pour ce joueur la première fois qu'il s'est connecté au jeu en question. N'est renseigné que pour les appels à player.get pour le joueur à l'origine de la demande, uniquement si l'ID de joueur a été modifié par la suite, et uniquement pour les clients qui acceptent le remappage des ID de joueur.
profileSettings

object (ProfileSettings)

Paramètres de profil du joueur Détermine si le profil du joueur est visible ou non par les autres joueurs.
name

object

Représentation objet des composants individuels du nom du joueur. Pour certains joueurs, ces champs peuvent être absents.
name.familyName

string

Nom de famille du joueur. À certains endroits, il s'agit du nom de famille.
name.givenName

string

Nom donné au joueur. À certains endroits, on l'appelle le prénom.
experienceInfo

object (PlayerExperienceInfo)

Objet représentant des informations sur l'expérience de jeu Play pour le joueur.
title

string

Titre du joueur récompensé pour ses activités de jeu.
friendStatus

enum (FriendStatus)

Statut d'ami du joueur donné, par rapport au demandeur. Cette option n'est pas configurée si le joueur ne partage pas sa liste d'amis avec le jeu.
gamePlayerId

string

Identifiant de joueur unique par application.

ProfileSettings

Paramètres du profil

Représentation JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#profileSettings.
profileVisible

boolean

Indique si le profil du joueur est visible par le joueur actuellement connecté.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Indique si la liste d'amis du joueur est visible par ce jeu ou peut être demandée. Ce champ n'est renseigné que pour le joueur actuellement connecté.

Enums
VISIBLE La liste d'amis est actuellement visible par le jeu.
REQUEST_REQUIRED Le développeur n'a pas accès à la liste d'amis, mais il peut appeler l'API Android pour afficher une boîte de dialogue de collecte du consentement.
UNAVAILABLE Cet utilisateur n'a pas accès à sa liste d'amis pour le moment. Il est donc impossible de demander l'accès à sa liste d'amis, car l'utilisateur a refusé définitivement l'invitation ou parce qu'il n'a pas accès à la fonctionnalité d'amis. Dans ce cas, toute demande d'accès à la liste d'amis échouera.

PlayerExperienceInfo

Métadonnées propriétaires/tierces sur l'expérience du joueur.

Représentation JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

Nombre actuel de points d'expérience du joueur.
lastLevelUpTimestampMillis

string (int64 format)

Code temporel du passage au niveau supérieur, en millisecondes depuis l'epoch Unix (UTC).
currentLevel

object (PlayerLevel)

Niveau actuel du joueur.
nextLevel

object (PlayerLevel)

Niveau suivant du joueur. Si le niveau actuel est le maximum, il doit être identique au niveau actuel.

PlayerLevel

Métadonnées propriétaires/3P sur le niveau de l'utilisateur.

Représentation JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#playerLevel.
level

integer

Niveau de l'utilisateur.
minExperiencePoints

string (int64 format)

Nombre minimal de points d'expérience pour ce niveau.
maxExperiencePoints

string (int64 format)

Nombre maximal de points d'expérience pour ce niveau.

FriendStatus

Définit les relations d'amitié entre les joueurs.

Enums
NO_RELATIONSHIP Il n'y a aucune relation entre les joueurs.
FRIEND Le joueur et le demandeur sont amis.

Méthodes

get

 Récupère la ressource "Joueur" avec l'ID donné.

getMultipleApplicationPlayerIds

 Obtenez les ID de joueur de l'application pour le joueur actuellement authentifié pour tous les jeux demandés par le même développeur que l'application appelante.

getScopedPlayerIds

 Récupère les identifiants de joueur limités pour l'utilisateur actuellement authentifié.

list

 Permet d'obtenir la collection de joueurs pour l'utilisateur actuellement authentifié.