Skip to main content

POST (/users/xuid()/achievements//update)

実績の進捗を更新します。 これらの URI のドメインは achievements.xboxlive.com です。

備考

  • 呼び出しが成功すると、HTTP ステータス コード 200 と空のレスポンス本文が返されます。
  • 呼び出しによって実績の進捗に変化がない場合 (すでに解除済み、または同じ達成率の場合)、HTTP ステータス コード 304 と空のレスポンス本文が返されます。

URI パラメーター

認可

必須リクエスト ヘッダー

| ヘッダー| 型| 説明| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 認証のための認証資格情報。値の例: “XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| 2| API コントラクトのバージョン。|

任意のリクエスト ヘッダー

| ヘッダー| 型| 説明| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Accept-Language| string| 希望するロケールおよびフォールバックのリスト (例: fr-FR、fr、en-GB、en-WW、en-US)。Achievements サービスは、一致するローカライズされた文字列が見つかるまでリストを順に処理します。見つからない場合は、ユーザー トークンで定義された場所 (ユーザーの IP アドレスに由来) との一致を試みます。それでも一致するローカライズ文字列が見つからない場合は、タイトルの開発者/発行者が提供する既定の文字列が使用されます。 |

リクエスト本文

AchievementUpdateRequest (JSON) オブジェクト。

サンプル リクエスト

POST /users/xuid({2810000000000000})/achievements/{00000000-0000-0000-0000-000000000000}/update

HTTP ステータス コード

サービスは、このリソースに対するこのメソッドでのリクエストに応じて、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準的な HTTP ステータス コードの完全な一覧については、標準 HTTP ステータス コード を参照してください。 | コード| 理由フレーズ| 説明| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| セッションは正常に取得されました。| | 301| Moved Permanently| サービスは別の URI に移動しました。| | 304| Not Modified| 実績の進捗は変更されていません。| | 307| Temporary Redirect| このリソースの URI は一時的に変更されています。| | 400| Bad Request| サービスは形式が正しくないリクエストを解釈できませんでした。通常はパラメーターが無効です。| | 401| Unauthorized| リクエストにはユーザー認証が必要です。| | 403| Forbidden| このユーザーまたはサービスにはリクエストが許可されていません。| | 404| Not Found| 指定されたリソースが見つかりませんでした。| | 406| Not Acceptable| リソースのバージョンはサポートされていません。MVC 層で拒否されるべきです。| | 408| Request Timeout| リクエストの完了に時間がかかりすぎました。| | 410| Gone| 要求されたリソースは利用できなくなりました。|

レスポンス本文

レスポンス本文は空です。

関連項目

親
/users/xuid()/achievements//update
Last modified on October 19, 2026