Autorisation requise
Récupère la liste des joueurs masqués pour l'application donnée. Cette méthode n'est disponible que pour les comptes utilisateur dans la Play Console.
Requête
Requête HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Paramètres
| Nom du paramètre | Valeur | Description |
|---|---|---|
| Paramètres de chemin d'accès | ||
applicationId |
string |
ID d'application provenant de la Google Play Console. |
| Paramètres de requête facultatifs | ||
maxResults |
integer |
Nombre maximal de ressources de lecteur à renvoyer dans la réponse. Utilisé pour la pagination. Pour toute réponse, le nombre réel de ressources de joueurs renvoyées peut être inférieur à la valeur maxResults spécifiée.
Les valeurs autorisées vont de 1 à 15, inclus.
|
pageToken |
string |
Jeton renvoyé par la requête précédente. |
Autorisation
Cette requête nécessite une autorisation ayant la portée suivante. En savoir plus sur le processus d'authentification et d'autorisation
| Champ d'application |
|---|
https://www.googleapis.com/auth/games |
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"kind": "gamesManagement#hiddenPlayerList",
"nextPageToken": string,
"items": [
{
"kind": "gamesManagement#hiddenPlayer",
"player": {
"kind": "gamesManagement#player",
"playerId": string,
"displayName": string,
"avatarImageUrl": string,
"lastPlayedWith": {
"timeMillis": long,
"autoMatched": boolean
},
"name": {
"familyName": string,
"givenName": string
},
"experienceInfo": {
"currentExperiencePoints": long,
"lastLevelUpTimestampMillis": long,
"currentLevel": {
"level": integer,
"minExperiencePoints": long,
"maxExperiencePoints": long
},
"nextLevel": {
"level": integer,
"minExperiencePoints": long,
"maxExperiencePoints": long
}
},
"title": string
},
"hiddenTimeMillis": long
}
]
}| Nom de propriété | Valeur | Description | Remarques |
|---|---|---|---|
kind |
string |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe gamesManagement#hiddenPlayerList. |
|
nextPageToken |
string |
Jeton de pagination pour la page de résultats suivante. | |
items[] |
list |
Les joueurs. | |
items[].kind |
string |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe gamesManagement#hiddenPlayer. |
|
items[].player |
nested object |
Informations sur le joueur | |
items[].player.kind |
string |
Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe gamesManagement#player. |
|
items[].player.playerId |
string |
Identifiant du joueur. | |
items[].player.displayName |
string |
Nom à afficher pour le lecteur. | |
items[].player.avatarImageUrl |
string |
URL de base de l'image représentant le joueur. | |
items[].player.lastPlayedWith |
nested object |
Détails concernant la dernière fois où ce joueur a joué à un jeu multijoueur avec le joueur actuellement authentifié. Renseigné pour les membres de la collection de joueurs PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
Dernière fois que le joueur a joué au jeu en millisecondes depuis l'epoch (UTC). | |
items[].player.lastPlayedWith.autoMatched |
boolean |
"True" si le lecteur a été mis en correspondance automatiquement avec l'utilisateur actuellement authentifié. | |
items[].player.name |
object |
Représentation d'objet des différents composants du nom du joueur. Pour certains joueurs, ces champs ne sont pas disponibles. | |
items[].player.name.familyName |
string |
Nom de famille de ce joueur. Dans certains endroits, il s'agit du nom de famille. | |
items[].player.name.givenName |
string |
Nom donné à ce joueur. Dans certains endroits, on l'appelle le prénom. | |
items[].player.experienceInfo |
nested object |
Objet représentant les informations relatives à l'expérience de jeu Play pour le joueur. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Nombre actuel de points d'expérience pour le joueur. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Code temporel du passage au niveau supérieur du joueur, exprimé en millisecondes depuis l'epoch Unix (UTC). | |
items[].player.experienceInfo.currentLevel |
nested object |
Niveau actuel du joueur. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Niveau de l'utilisateur. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Nombre minimal de points d'expérience pour ce niveau. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Nombre maximal de points d'expérience pour ce niveau. | |
items[].player.experienceInfo.nextLevel |
nested object |
Niveau suivant du joueur Si le niveau actuel est le niveau maximal, il doit être identique au niveau actuel. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Niveau de l'utilisateur. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Nombre minimal de points d'expérience pour ce niveau. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Nombre maximal de points d'expérience pour ce niveau. | |
items[].player.title |
string |
Titre du joueur récompensé pour ses activités de jeu. |