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