Scores: submit

Envia uma pontuação ao placar especificado. Faça o teste agora.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/games/v1/leaderboards/leaderboardId/scores

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
leaderboardId string É o ID do placar.
Parâmetros de consulta obrigatórios
score long A pontuação que você está enviando. A pontuação enviada será ignorada se for pior do que a enviada anteriormente, em que o pior depende da ordem de classificação do placar. O significado do valor da pontuação depende do tipo de formato do placar. Para ponto fixo, a pontuação representa o valor bruto. Para tempo, a pontuação representa o tempo decorrido em milissegundos. Para moeda, a pontuação representa um valor em microunidades.
Parâmetros de consulta opcionais
language string O idioma preferencial a ser usado para strings retornadas por esse método.
scoreTag string Informações adicionais sobre a pontuação que você está enviando. Os valores não podem conter mais de 64 caracteres seguros de URI, conforme definido na seção 2.3 da RFC 3986.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
https://www.googleapis.com/auth/games

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "kind": "games#playerScoreResponse",
  "beatenScoreTimeSpans": [
    string
  ],
  "unbeatenScores": [
    {
      "kind": "games#playerScore",
      "timeSpan": string,
      "score": long,
      "formattedScore": string,
      "scoreTag": string
    }
  ],
  "formattedScore": string,
  "leaderboardId": string,
  "scoreTag": string
}
Nome da propriedade Valor Descrição Observações
kind string Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa games#playerScoreResponse.
beatenScoreTimeSpans[] list O período em que a pontuação enviada é melhor do que a pontuação existente nesse período
Os valores possíveis são:
  • "ALL_TIME": é uma pontuação geral.
  • "WEEKLY": é uma pontuação semanal.
  • "DAILY": é uma pontuação diária.
unbeatenScores[] list As pontuações em períodos que não foram vencidos. Por exemplo, a pontuação enviada pode ser melhor do que a pontuação de DAILY do jogador, mas não melhor que as pontuações do jogador nos períodos WEEKLY ou ALL_TIME.
unbeatenScores[].kind string Identifica exclusivamente o tipo do recurso. O valor é sempre a string fixa games#playerScore.
unbeatenScores[].timeSpan string O período para essa pontuação do jogador.
Os valores possíveis são:
  • "ALL_TIME": é uma pontuação geral.
  • "WEEKLY": é uma pontuação semanal.
  • "DAILY": é uma pontuação diária.


Os valores aceitáveis são os seguintes:
  • "ALL_TIME"
  • "DAILY"
  • "WEEKLY"
unbeatenScores[].score long É o valor numérico da pontuação do jogador.
unbeatenScores[].formattedScore string Pontuação formatada para a pontuação desse jogador.
unbeatenScores[].scoreTag string Informações adicionais sobre essa pontuação. Os valores não conterão mais de 64 caracteres seguros de URI, conforme definido na seção 2.3 da RFC 3986.
formattedScore string É o valor formatado da pontuação enviada.
leaderboardId string O ID do placar ao qual esta pontuação foi enviada.
scoreTag string Informações adicionais sobre essa pontuação. Os valores não conterão mais de 64 caracteres seguros de URI, conforme definido na seção 2.3 da RFC 3986.

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.