Method: scores.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 |
string
Un ID de joueur Vous pouvez utiliser la valeur me à la place de l'ID du joueur authentifié.
|
leaderboardId |
string
Identifiant du classement. Peut être défini sur "ALL" pour récupérer les données de tous les classements pour cette application.
|
timeSpan |
enum (ScoreTimeSpan)
La période pour les scores et les classements que vous demandez.
|
Paramètres de requête
| Paramètres |
language |
string
Langue préférée à utiliser pour les chaînes renvoyées par cette méthode.
|
includeRankType |
enum (IncludeRankType)
Types de rangs à afficher. Si le paramètre est omis, aucun rang n'est renvoyé.
|
maxResults |
integer
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 maxResults spécifiée.
|
pageToken |
string
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. |
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Method: scores.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [ScoreTimeSpan](#ScoreTimeSpan)\n- [IncludeRankType](#IncludeRankType)\n- [Try it!](#try-it)\n\nGet high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. \\`NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\n| `leaderboardId` | `string` The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all leaderboards for this application. |\n| `timeSpan` | `enum (`[ScoreTimeSpan](/games/services/web/api/rest/v1/scores/get#ScoreTimeSpan)`)` The time span for the scores and ranks you're requesting. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `includeRankType` | `enum (`[IncludeRankType](/games/services/web/api/rest/v1/scores/get#IncludeRankType)`)` The types of ranks to return. If the parameter is omitted, no ranks will be returned. |\n| `maxResults` | `integer` The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GetLeaderboardScoresResponse](/games/services/web/api/rest/v1/scores#GetLeaderboardScoresResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nScoreTimeSpan\n-------------\n\nDefines possible time spans for a score.\n\n| Enums ||\n|------------|---------------------------------------------------------------------------------------------|\n| `ALL` | Get the high scores for all time spans. If this is used, maxResults values will be ignored. |\n| `ALL_TIME` | Get the all time high score. |\n| `WEEKLY` | List the top scores for the current day. |\n| `DAILY` | List the top scores for the current week. |\n\nIncludeRankType\n---------------\n\nPossible values for rank type.\n\n| Enums ||\n|-----------|---------------------------------------------------------------------------------------------|\n| `ALL` | Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`. |\n| `PUBLIC` | Retrieve public ranks, if the player is sharing their gameplay activity publicly. |\n| `SOCIAL` | (Obsolete) Retrieve the social rank. | This item is deprecated! |\n| `FRIENDS` | Retrieve the rank on the friends collection. |"]]
