Method: scores.submit
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Envoie un score au classement spécifié.
Requête HTTP
POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores
Paramètres de chemin
Paramètres |
leaderboardId |
string
Identifiant du classement.
|
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.
|
score |
string (int64 format)
Obligatoire. Score que vous envoyez. Le score envoyé est ignoré s'il est moins bon qu'un score précédemment envoyé (le score inférieur dépend de l'ordre de tri du classement). La signification de la valeur du score dépend du type de format du classement. Pour les valeurs à virgule fixe, le score représente la valeur brute. Pour le temps, le score représente le temps écoulé en millisecondes. Pour une devise, le score représente une valeur en micro-unités.
|
scoreTag |
string
Informations supplémentaires sur le score que vous envoyez. Les valeurs ne doivent pas contenir plus de 64 caractères compatibles avec les URI, comme défini dans la section 2.3 du document RFC 3986.
|
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 SubmitLeaderboardScoreResponse
.
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.
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.submit\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- [Try it!](#try-it)\n\nSubmits a score to the specified leaderboard.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|-------------------------------------|\n| `leaderboardId` | `string` The ID of the leaderboard. |\n\n### Query parameters\n\n| Parameters ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `score` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The score you're submitting. The submitted score is ignored if it is worse than a previously submitted score, where worse depends on the leaderboard sort order. The meaning of the score value depends on the leaderboard format type. For fixed-point, the score represents the raw value. For time, the score represents elapsed time in milliseconds. For currency, the score represents a value in micro units. |\n| `scoreTag` | `string` Additional information about the score you're submitting. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. |\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 [SubmitLeaderboardScoreResponse](/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse).\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)."]]