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. |