このページは Cloud Translation API によって翻訳されました。

Scores: submit

指定したリーダーボードにスコアを送信します。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	値	説明
パスパラメータ
`leaderboardId`	`string`	リーダーボードの ID。
必須のクエリパラメータ
`score`	`long`	登録するスコアです。送信されたスコアが、以前に送信されたスコアより悪かった場合、送信されたスコアは無視されます。これは、リーダーボードの並べ替え順序によって異なります。スコア値の意味はリーダーボードのフォーマットタイプによって異なります。固定小数点の場合、スコアは未加工の値を表します。時間に対して、スコアは経過時間をミリ秒単位で表します。通貨の場合、スコアはマイクロ単位の値を表します。
省略可能なクエリパラメータ
`language`	`string`	このメソッドから返される文字列に使用する言語。
`scoreTag`	`string`	送信したスコアに関する追加情報。値には、RFC 3986 のセクション 2.3 で定義されている 64 文字以下の URI セーフ文字を含める必要があります。

承認

このリクエストには、次のスコープによる認証が必要です。

範囲
`https://www.googleapis.com/auth/games`

詳細については、認証と承認のページをご覧ください。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "games#playerScoreResponse",
  "beatenScoreTimeSpans": [
    string
  ],
  "unbeatenScores": [
    {
      "kind": "games#playerScore",
      "timeSpan": string,
      "score": long,
      "formattedScore": string,
      "scoreTag": string
    }
  ],
  "formattedScore": string,
  "leaderboardId": string,
  "scoreTag": string
}

プロパティ名	値	説明
`kind`	`string`	このリソースの種類を一意に識別します。値は常に固定文字列の `games#playerScoreResponse` です。
`beatenScoreTimeSpans[]`	`list`	送信されたスコアが、その期間の既存のスコアよりも良好である期間。有効な値は次のとおりです。「`ALL_TIME`」- スコアは全期間のスコアです。「`WEEKLY`」- スコアは 1 週間のスコアです。「`DAILY`」- スコアは 1 日ごとのスコアです。
`unbeatenScores[]`	`list`	無敵の期間のスコア。たとえば、送信されたスコアがプレーヤーの `DAILY` スコアよりも優れていても、`WEEKLY` または `ALL_TIME` の期間におけるプレーヤーのスコアよりは良くない場合があります。
`unbeatenScores[].kind`	`string`	このリソースの種類を一意に識別します。値は常に固定文字列の `games#playerScore` です。
`unbeatenScores[].timeSpan`	`string`	このプレーヤースコアの期間。有効な値は次のとおりです。「`ALL_TIME`」- スコアは全期間のスコアです。「`WEEKLY`」- スコアは 1 週間のスコアです。「`DAILY`」- スコアは 1 日ごとのスコアです。有効な値は次のとおりです。 "`ALL_TIME`" 「`DAILY`」「`WEEKLY`」
`unbeatenScores[].score`	`long`	このプレーヤースコアの数値。
`unbeatenScores[].formattedScore`	`string`	このプレーヤースコアのフォーマットされたスコア。
`unbeatenScores[].scoreTag`	`string`	このスコアに関する追加情報。値には、RFC 3986 のセクション 2.3 で定義されている 64 文字以下の URI セーフ文字が含まれます。
`formattedScore`	`string`	送信されたスコアのフォーマットされた値。
`leaderboardId`	`string`	このスコアが送信されたリーダーボード ID。
`scoreTag`	`string`	このスコアに関する追加情報。値には、RFC 3986 のセクション 2.3 で定義されている 64 文字以下の URI セーフ文字が含まれます。

実習

以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。