PUT (/users/xuid(xuid)/lists/PINS/)
リクエスト本文の各アイテムに指定されたインデックスに従って、リスト内のアイテムを更新します。 これらの URI のドメインはeplists.xboxlive.com です。
備考
この呼び出しは、リクエスト本文の各アイテムに指定されたインデックスに従って、リスト内のアイテムを更新します。この呼び出しはリストにアイテムを挿入せず、指定されたインデックスにアイテムが存在しない場合、呼び出しは 400 Bad Request ステータスを返します。1 回の呼び出しで複数のアイテムを更新できますが、すべて現在のリスト内に存在している必要があります。つまり、すべてが更新されるか、いずれも更新されないかのどちらかです。 この呼び出しでは、更新するアイテムを index ではなく itemId で指定することもできます。これを行うには、サービスに送信する IndexedItems 構造のインデックスに単に “-1” を使用します。もちろん、この場合、更新の一部として itemId を変更することはできないため、他のメタデータ フィールドへの変更にのみ機能します。アイテムの識別に itemId の代わりに provider/providerId の組み合わせを使用することもできます。内部的に、サービスはリスト内でこれらのアイテムを検索し、更新すべき適切なインデックスを見つけ出します。アイテムが見つからない場合は 400 Bad Request ステータスが返され、いずれのアイテムも更新されません。 この呼び出しでは、アイテムを識別するためにインデックスを使用する場合、リクエストに If-Match:versionNumber ヘッダーを含める必要があります。アイテムを識別するために item ID を使用する場合 (かつリストが重複を許可しない場合)、If-Match ヘッダーは任意です。ヘッダーが存在する場合、if-Match ヘッダーは常に検証されます。ヘッダー内の versionNumber は、リストの現在のバージョン番号です。必須の場合に含まれていない、または現在のリスト バージョン番号と一致しない場合、HTTP 412 Precondition Failed ステータス コードが返され、レスポンス本文には現在のバージョン番号を含むリストの最新メタデータが含まれます。これは、異なるクライアントからの更新が互いに上書きし合うのを防ぐためです。URI パラメーター
認可
この呼び出しでは、Authorization ヘッダーに XSTS SAML トークンが必要です。呼び出し元を識別するために、SAML トークン内に Xuid クレームが存在する必要があります。この値は、呼び出し元が該当するリスト データへのアクセス権を持っているかどうかを判定するために使用されます。リスト自体も Xuid によって識別され、リストの URI に含まれます。これを使用することで、将来的にはリストの共有アクセスをサポートする可能性がありますが、現時点ではこの機能はサポートされていません。現在、ユーザーがアクセスするリストはすべてそのユーザー自身のものであり、共有アクセスはありません。したがって、URI 内の Xuid は SAML クレーム トークン内の Xuid と一致する必要があります。注:
現時点では XBL Auth 2.0 と 3.0 の両方のトークンがサポートされています。