Method: scores.submit

指定されたリーダーボードにスコアを送信します。

HTTP リクエスト

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

パスパラメータ

パラメータ
leaderboardId

string

リーダーボードの ID。

クエリ パラメータ

パラメータ
language

string

このメソッドによって返される文字列に使用する優先言語。

score

string (int64 format)

必須。送信するスコア。以前に送信されたスコアよりも低いスコアは送信されません。低いスコアかどうかは、リーダーボードの並べ替え順序によって異なります。スコア値の意味は、リーダーボードの形式のタイプによって異なります。固定小数点数の場合、スコアは元の値を表します。時間の場合、スコアは経過時間をミリ秒単位で表します。通貨の場合、スコアはマイクロ単位の値を表します。

scoreTag

string

送信するスコアに関する追加情報。値には、RFC 3986 の第 2.3 節で定義されている URI セーフ文字を 64 文字以内で指定する必要があります。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には SubmitLeaderboardScoreResponse のインスタンスが含まれます。

認可スコープ

次のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

詳しくは、OAuth 2.0 の概要をご覧ください。