> ## 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.

# purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken

> ゲーム サービスの Clawback イベント メッセージ キューを読み取るための Azure Storage SAS トークンを生成する、Microsoft Store v8 の clawback SAS トークン エンドポイント。

このエンドポイントは、Clawback イベント メッセージ キューを認証してアクセスするための [SAS トークン](https://learn.microsoft.com/azure/storage/common/storage-sas-overview) を生成します。
Clawback イベント メッセージ キューの詳細については、[サービスからの返金とチャージバックの管理](/ja-jp/publishing/xstore-commerce/xstore-managing-refunds.md) を参照してください。

## 前提条件

[サービス間 API の前提条件](/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md) を確認してください。

この API を使用するには、Developer Partner Manager または Microsoft の担当者の支援を受けてオンボーディング プロセスを完了する必要があります。
オンボーディング プロセスの詳細については、[必要なセットアップ / オンボーディング要求](/ja-jp/publishing/xstore-commerce/xstore-managing-refunds.md#required-setup--onboarding-request) を参照してください。

## 要求

### 要求の構文

| メソッド | 要求 URI |
| - | - |
| `GET` | `purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken` |

### 要求ヘッダー

| ヘッダー | 型 | 説明 |
| - | - | - |
| `Authorization` | `string` | 必須。`Bearer` \<*token*> の形式の Microsoft Entra ID サービス アクセス トークン。[Microsoft Entra ID アクセス トークンの作成](/ja-jp/publishing/xstore-commerce/xstore-requesting-userstoreid.md#step-3-creating-microsoft-entra-id-access-tokens) を参照してください。 |
| `Host` | `string` | 値 `purchase.mp.microsoft.com` に設定する必要があります。 |

### 要求の例

```html theme={null}
GET https://purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken HTTP/1.1
Host: purchase.mp.microsoft.com
Authorization: Bearer [Microsoft Entra ID bearer token]
```

## 応答

### 応答本文

応答本文は、次の値を含む JSON です。

| パラメーター | 型 | 説明 | 必須 |
| - | - | - | - |
| `expiresOn` | `DateTime` | SAS トークンの有効期限が切れる UTC 日時 | はい |
| `uri` | `string` | Clawback メッセージ キューにアクセスするための、Storage リソース URI と [SAS トークン](https://learn.microsoft.com/azure/storage/common/storage-sas-overview) を組み合わせたもの。 | はい |

### 応答の例

```json theme={null}

HTTP/1.1 200 OK
Date: Thu, 08 Dec 2022 20:13:46 GMT
Content-Length: 243
Content-Type: application/json; charset=utf-8
ms-correlationid: 70e6f659-ceee-4050-bdf3-56ea3beefe23
ms-requestid: 8c80d7ff-73e2-4a5c-9aca-79059fbc1beb
ms-cv: tRscYtHLJHps.0
x-content-type-options: nosniff

{
    "expiresOn":"2022-12-09T02:13Z",
    "uri":"https://uluufeofsxh2k.queue.core.windows.net:443/gxhxcvb32lnk4?sv=2021-10-04&spr=https&st=2022-12-08T20%3A13%3A46Z&se=2022-12-09T02%3A13%3A46Z&sp=rp&sig=OneHfX99E820avICZvXJUF14IyDuv2BrvY0kj%2Ftxc70%3D"
}

```

## SAS トークンを使用して Clawback イベント メッセージ キューにアクセスする

`uri` パラメーターを取得したら、キュー メッセージにアクセスできます。
詳細については、[キューからの Clawback メッセージの処理](/ja-jp/publishing/xstore-commerce/xstore-managing-refunds.md#processing-clawback-messages-from-the-queue) を参照してください。

## 関連記事

[サービスからの返金とチャージバックの管理](/ja-jp/publishing/xstore-commerce/xstore-managing-refunds.md)

[サービスからのコンシューマブル製品の管理](/ja-jp/publishing/xstore-commerce/xstore-managing-consumables.md)

[サービスからの製品の管理](/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)

[Microsoft Store API を使用したサービスの認証](/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)

[Azure Queue Storage REST API](https://learn.microsoft.com/rest/api/storageservices/queue-service-rest-api)

[.NET を使用した Azure Queue Storage](https://learn.microsoft.com/azure/storage/queues/storage-dotnet-how-to-use-queues?tabs=dotnet)


## Related topics

- [Microsoft Store サービス API (目次)](/ja-jp/reference/microsoft-store-apis/xstore-nav.md)
- [サービスから消費型製品を管理する](/ja-jp/publishing/xstore-commerce/xstore-managing-consumables.md)
- [purchase.mp.microsoft.com/v8.0/b2b/orders/query](/ja-jp/reference/microsoft-store-apis/xstore-v8-clawbackv1.md)
- [purchase.mp.microsoft.com/v8.0/b2b/recurrences/query](/ja-jp/reference/microsoft-store-apis/xstore-v8-recurrence-query.md)
- [collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview](/ja-jp/reference/microsoft-store-apis/xstore-v8-query-for-products.md)