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

# トレード

> PlayFab Legacy Economy のプレイヤー間トレード API の概要。プレイヤーがゲームを通じて安全にインベントリ アイテムを直接交換できるようにします。

PlayFab クライアント API を使用すると、プレイヤー同士でアイテムを取引できます。これらの API メソッドは既定で有効になっているため、タイトルのセキュリティを確保するには、ポリシー API を使用して無効化する必要がある場合があります。

<Note>
  インベントリ トレード機能はプレビュー段階にあります。メソッドは機能しますが、完全な機能とするための便利な要素が一部欠けています。現在、トレードできるのは仮想アイテムのみです。仮想通貨をリクエストしたり交換することはできず、PlayFab が他のプレイヤーから利用可能なトレードの一覧を提供することもありません。トレード メソッドはクライアント API でのみ使用でき、サーバー API からは使用できません。
</Note>

## 主要な概念

**カタログ** - カタログを使用すると、ゲームの仮想アイテムを簡単に管理できます。ゲーム内で利用可能なすべてのアイテムのリストです。

**カタログ アイテム** – PlayFab アイテムは、耐久財、バンドル、ロックされたコンテナなど、ほぼあらゆる種類の仮想商品を表すことができます。

**インベントリ** - すべてのアカウント (プレイヤー アカウントとキャラクター アカウント) にはインベントリがあります。インベントリには、所有しているすべてのアイテム インスタンスとアイテム履歴が含まれます。

**仮想通貨** - PlayFab では、タイトルごとに最大 10 種類の仮想通貨を提供できます。通貨は、カタログまたはストアからアイテムを購入するために使用したり、アプリ内購入から変換されたソフト通貨を表したり、ゲームプレイを促進する仕組みとして使用したりできます。

## 前提条件

トレードには、カタログとインベントリ アイテムの両方に関する知識が必要です。プレイヤーは、取引したいインベントリ アイテムを所有している必要があります。

## API

トレードのフローは、いくつかの API によって処理されます。

[OpenTrade](xref:titleid.playfabapi.com.client.trading.opentrade)\
新しい未完了のトレードを開きます。これは 2 人の特定のプレイヤー (PlayfabID) 間、または 1 人のプレイヤーが誰にでも開かれたトレードを開始することができます。1 つのアイテム インスタンスは、同時に 1 つのオープン トレードにのみ含められる点に注意してください。

[GetTradeStatus](xref:titleid.playfabapi.com.client.trading.gettradestatus)\
クライアントが特定のトレードの現在のステータスを取得することで評価できるようにします。

[AcceptTrade](xref:titleid.playfabapi.com.client.trading.accepttrade)\
オープン トレードを受け入れます。呼び出しが成功すると、提供されたアイテムと受け入れられたアイテムが 2 人のプレイヤーのインベントリ間で交換されます。

[CancelTrade](xref:titleid.playfabapi.com.client.trading.canceltrade)\
オープン トレードをキャンセルします。トレードを作成したプレイヤーのみがこの API 呼び出しでキャンセルできることに注意してください。これは嫌がらせを防ぐためです。

[GetPlayerTrades](xref:titleid.playfabapi.com.client.trading.getplayertrades)\
**GetPlayerTrades** は、プレイヤーが開始または受け入れたすべてのトレードを、必要に応じてトレード ステータスでフィルターして返します。


## Related topics

- [トレードのクイックスタート](/ja-jp/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)
- [デバッグ トレース](/ja-jp/services/playfab/sdks/c/tracing.md)
- [ストレージ](/ja-jp/services/xbox-services/storage/index.md)
- [XDXR を使用した XBOX Series X|S でのレイ トレーシング](/ja-jp/build/core-features/graphics/newfeatures/raytracing/index.md)
- [Steam Cloud ストレージを XBOX GDK に移植する](/ja-jp/build/steam-porting-guide/features/steam-cloud.md)
