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 の概要をご覧ください。