- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- ScoreTimeSpan
- IncludeRankType
- Essayer
Obtenez les meilleurs scores et éventuellement des classements dans les classements pour le joueur actuellement authentifié. Pour une période spécifique, leaderboardId
peut être défini sur ALL
afin de récupérer les données de tous les classements sur une période donnée. REMARQUE: Vous ne pouvez pas demander 'TOUS' les classements et 'ALL' timeSpans' dans la même requête. Un seul paramètre peut être défini sur 'ALL'.
Requête HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Paramètres de chemin
Paramètres | |
---|---|
playerId |
Un ID de joueur Vous pouvez utiliser la valeur |
leaderboardId |
Identifiant du classement. Peut être défini sur "ALL" pour récupérer les données de tous les classements pour cette application. |
timeSpan |
La période pour les scores et les classements que vous demandez. |
Paramètres de requête
Paramètres | |
---|---|
language |
Langue préférée à utiliser pour les chaînes renvoyées par cette méthode. |
includeRankType |
Types de rangs à afficher. Si le paramètre est omis, aucun rang n'est renvoyé. |
maxResults |
Nombre maximal de scores de classement à renvoyer dans la réponse. Pour toute réponse, le nombre réel de scores de classement renvoyés peut être inférieur à la valeur |
pageToken |
Jeton renvoyé par la requête précédente. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de GetLeaderboardScoresResponse
.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
ScoreTimeSpan
Définit les périodes possibles pour un score.
Enums | |
---|---|
ALL |
Obtenez les meilleurs scores pour toutes les périodes. Si vous utilisez cette option, les valeurs maxResults seront ignorées. |
ALL_TIME |
Obtenez le meilleur score de tous les temps. |
WEEKLY |
Listez les meilleurs scores du jour. |
DAILY |
Lister les meilleurs scores de la semaine en cours |
IncludeRankType
Valeurs possibles pour le type de classement.
Enums | |
---|---|
ALL |
Récupérez tous les classements acceptés. Dans HTTP, cette valeur de paramètre peut également être spécifiée en tant que ALL . |
PUBLIC |
récupérer les niveaux publics, si le joueur partage son activité de jeu publiquement ; |
SOCIAL |
(Obsolète) Récupérez le classement sur les réseaux sociaux. |
FRIENDS |
Récupérez votre classement dans la collection d'amis. |