Method: scores.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Receber pontuações altas e, opcionalmente, classificações nos placares do jogador autenticado. Para um período específico, leaderboardId pode ser definido como ALL para recuperar dados de todos os placares em um determinado período. Observação: não é possível pedir "TODOS" placares e "TODOS" períodos de tempo na mesma solicitação. Apenas um parâmetro pode ser definido como "TODOS".
Solicitação HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Parâmetros de caminho
| Parâmetros |
playerId |
string
Um ID do jogador. Um valor de me pode ser usado no lugar do ID do jogador autenticado.
|
leaderboardId |
string
O ID da tabela de classificação. Pode ser definido como "ALL" para recuperar dados de todos os placares do app.
|
timeSpan |
enum (ScoreTimeSpan)
O período de tempo das pontuações e classificações que você está solicitando.
|
Parâmetros de consulta
| Parâmetros |
language |
string
O idioma preferencial a ser usado para strings retornadas por esse método.
|
includeRankType |
enum (IncludeRankType)
Os tipos de classificação a serem retornados. Se o parâmetro for omitido, nenhuma classificação será retornada.
|
maxResults |
integer
O número máximo de pontuações da tabela de classificação a serem retornadas na resposta. Para qualquer resposta, o número real de pontuações da tabela de classificação retornadas pode ser menor do que o maxResults especificado.
|
pageToken |
string
O token retornado pela solicitação anterior.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta terá uma instância de GetLeaderboardScoresResponse.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para mais informações, consulte a Visão geral do OAuth 2.0.
ScoreTimeSpan
Define os possíveis períodos de uma pontuação.
| Enumerações |
ALL |
Receba as pontuações mais altas para todos os períodos. Se esse parâmetro for usado, os valores de maxResults serão ignorados. |
ALL_TIME |
Conquiste a maior pontuação de todos os tempos. |
WEEKLY |
Listar as melhores pontuações do dia atual. |
DAILY |
Listar as melhores pontuações da semana atual. |
IncludeRankType
Valores possíveis para o tipo de classificação.
| Enumerações |
ALL |
Extrair todas as classificações compatíveis. No HTTP, esse valor de parâmetro também pode ser especificado como ALL. |
PUBLIC |
Extrair classificações públicas, se o jogador estiver compartilhando a atividade de jogo publicamente. |
SOCIAL |
(Descontinuado) Recupera a classificação social. |
FRIENDS |
Extraia a classificação na coleção de amigos. |
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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. |"]]
