> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/users/xuid({xuid})/achievements/{scid}/update)

> POST (/users/xuid({xuid})/achievements/{scid}/update)

# POST (/users/xuid({xuid})/achievements/{scid}/update)

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

* [URI パラメーター](#ID4EV)
* [認可](#ID4EAB)
* [必須リクエスト ヘッダー](#ID4EPG)
* [任意のリクエスト ヘッダー](#ID4EPH)
* [リクエスト本文](#ID4ECBAC)
* [HTTP ステータス コード](#ID4ENBAC)
* [レスポンス本文](#ID4EBGAC)

## 備考

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

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | 64 ビット符号なし整数 | リソースにアクセスするユーザーの XBOX User ID (XUID)。認証済みユーザーの XUID と一致している必要があります。 |
| scid | GUID | アクセス対象の実績が属するサービス構成の一意識別子。 |

## 認可

| クレーム | 必須? | 説明 | 欠落時の動作 |
| - | - | - | - |
| User | はい | リクエストが行われる XBOX LIVE 上の有効なユーザー。 | 403 Forbidden |

## 必須リクエスト ヘッダー

\| ヘッダー| 型| 説明|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-achievementupdaterequest.md) オブジェクト。

### サンプル リクエスト

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

```json theme={null}
{
    "action": "progressUpdate",
    "serviceConfigId": "00000000-0000-0000-0000-000000000000",
    "titleId": 0000000000,
    "userId": "2810000000000000",
    "achievements": [
        {
            "id": "1",
            "percentComplete": 100
        }
    ]
}
```

## HTTP ステータス コード

サービスは、このリソースに対するこのメソッドでのリクエストに応じて、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準的な HTTP ステータス コードの完全な一覧については、[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes.md) を参照してください。

\| コード| 理由フレーズ| 説明|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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({xuid})/achievements/{scid}/update](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)


## Related topics

- [/users/xuid({xuid})/achievements/{scid}/update](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)
- [/users/xuid({xuid})/achievements/{scid}/{achievementid}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid.md)
- [GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementidget.md)
- [/users/xuid({xuid})/achievements](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsv2.md)
- [GET (/users/xuid({xuid})/achievements)](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-achievementsusersxuidachievementsgetv2.md)
