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

# Economy V2 の制限

> プレイヤーごとおよびタイトルごとの 1 秒あたりのリクエスト クォータを含む、PlayFab Economy v2 のカタログおよびインベントリ API のスロットリングとレート制限のリファレンス。

# 制限 - Economy (V2)

> [!NOTE]
>
> Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、[PlayFab フォーラム](https://community.playfab.com) を参照してください。

このガイドでは、アイテムのカタログの作成、更新、読み取り、およびプレイヤー インベントリからの追加、更新、削除の際に適用される制限について詳しく説明します。Economy (V2) に応じた最新の制限が含まれています。

* Limit (Player) は、対象のエンティティが Player である場合を指します。
* Limit (Title) は、対象のエンティティが Title である場合を指します。

> [!NOTE]
>
> すべての API は、互いに独立して計測されます。

## カタログのスロットリング

### 読み取り

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **GetItem** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **GetItems** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **SearchItems** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **GetItemReviews** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **GetItemReviewsSummary** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **GetEntityItemReview** | 1.67 rps (60 秒間で 100 回) | 1000 rps (10 秒間で 10000 回) |
| **GetItemModerationState** | - | 1000 rps (10 秒間で 10000 回) |

### 書き込み/管理

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **CreateDraftItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **CreateUploadUrls** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **DeleteEntityItemReviews** | - | 100 rps (10 秒間で 1000 回) |
| **DeleteItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **GetDraftItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **GetDraftItems** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **GetEntityDraftItems** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **GetItemPublishStatus** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **PublishDraftItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **ReportItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **ReportItemReview** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **ReviewItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **SetItemModerationState** | - | 100 rps (10 秒間で 1000 回) |
| **SubmitItemReviewVote** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |
| **TakedownItemReviews** | - | 100 rps (10 秒間で 1000 回) |
| **UpdateDraftItem** | 0.33 rps (30 秒間で 10 回) | 100 rps (10 秒間で 1000 回) |

## インベントリのスロットリング

> [!NOTE]
>
> * インベントリのスロットリングは、API ごとに個別に、ターゲット エンティティに基づいて計算されます。 - たとえば、Player または Title (ゲーム サービス、CloudScript など) が Inventory API を呼び出して Player エンティティのインベントリを更新すると、Limit (Player) のスロットリングが適用されます。 - [Group エンティティ](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/entities.md#group) のインベントリもサポートされており、Group Entity は Player エンティティと同じスロットリング レートを共有します。[Groups](https://docs.xbox.com/ja-jp/services/playfab/community/associations/groups.md) も参照してください。

### 読み取り

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **GetInventoryItems** | 0.67 rps (60 秒間で 40 回) | - |
| **GetInventoryCollectionIds** | 0.08 rps (60 秒間で 5 回) | - |

### 取引履歴の読み取り

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **GetTransactionHistory** | 0.1 rps (300 秒間で 30 回) | - |

### 書き込み

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **AddInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **SubtractInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **UpdateInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **PurchaseInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **TransferInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **DeleteInventoryItems** | 0.33 rps (60 秒間で 20 回) | - |
| **ExecuteInventoryOperations** | 0.33 rps (60 秒間で 20 回) | - |
| **DeleteInventoryCollection** | 0.08 rps (60 秒間で 5 回) | - |

### 引き換え

| **API** | **Limit (Player)** | **Limit (Title)** |
| - | - | - |
| **RedeemAppleAppStoreInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |
| **RedeemGooglePlayInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |
| **RedeemMicrosoftStoreInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |
| **RedeemNintendoEShopInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |
| **RedeemPlayStationStoreInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |
| **RedeemSteamInventoryItems** | 0.16 rps (60 秒間で 10 回) | - |

## API 制限

### バイナリ コンテンツのサイズ

許可される最大ファイル サイズは **500MB** です。

### バイナリ コンテンツの数量

1 つのアイテムに最大 **100 個の画像** と **100 個のファイル** を追加できます。

* ファイルには制限はありません。
* 画像は **.png**、**.jpg**、**.gif**、**.bmp** ファイル タイプでのみアップロードできます。

### CreateUploadsUrls

コンテンツ blob/URL は、下書きまたは公開されたアイテムに **添付されていない場合**、**24 時間** 後にガベージ コレクションされます。

### カタログの最大ページ サイズ

以下は、さまざまな API で返されるアイテムの最大数です。[継続トークン](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/search.md#continuation-tokens) を使用して、制限を超える結果をページングできます。

* `SearchItems` - 1 ページあたり 50 アイテム
* `GetItems` - 1 ページあたり 50 アイテム
* `GetItemReviews` - 1 ページあたり 50 アイテム
* `GetItemContainers` - 1 ページあたり 50 アイテム
* `GetEntityDraftItems` - 1 ページあたり 50 アイテム

### カタログのデフォルト ページ サイズ

* `SearchItems` - 1 ページあたり 10 アイテム
* `GetItems` - 1 ページあたり 10 アイテム
* `GetItemReviews` - 1 ページあたり 10 アイテム
* `GetItemContainers` - 1 ページあたり 10 アイテム
* `GetDraftItems` - 1 ページあたり 10 アイテム
* `GetEntityDraftItems` - 1 ページあたり 10 アイテム

### インベントリの最大ページ サイズ

以下は、さまざまな API で返されるアイテムの最大件数です。[継続トークン](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/search.md#continuation-tokens) を使用して、制限を超える結果をページングできます。

| **API** | **レスポンス圧縮あり** | **レスポンス圧縮なし** |
| - | - | - |
| **GetInventoryItems** | 250 アイテム | 50 アイテム |
| **GetInventoryCollectionIds** | 250 アイテム | 50 アイテム |
| **GetTransactionHistory** | 250 アイテム | 50 アイテム |

### インベントリのデフォルト ページ サイズ

* `GetInventoryItems` - 1 ページあたり 10 アイテム
* `GetInventoryCollectionIds` - 1 ページあたり 10 アイテム
* `GetTransactionHistory` - 1 ページあたり 10 アイテム

### 検索フィルターの複雑さ

`SearchItems` 呼び出しで使用される過度に複雑な `Filter` クエリの使用を防ぐためのチェックが適用されます。詳細については、[こちら](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/search.md#limits) を参照してください。

## カタログ アイテム

### カタログ作成者エンティティの制限

カタログ作成者エンティティごとに最大 20GB のカタログ データが許可されます。この制限に達する可能性が最も高いのは、Title エンティティによって作成されたカタログ アイテムです。

### Titles

Title は、国コードごとに **512 文字の制限** があります。

### Descriptions

Description は、国コードごとに **10000 文字の制限** があります。

### Keywords

Keyword は、キーワードごとに **50 文字の制限** があり、国コードごとに最大 **32 個のキーワード** を追加できます。

### 表示プロパティ

Display Properties フィールドには **10000 バイトの制限** があります。

### Tags

Tag は、タグごとに **32 文字の制限** があります。
Title は最大 **1024 個の Tag** を持つことができ、
1 つのアイテムに最大 **32 個の Tag** を追加できます。

### Content Types

Content Type は、コンテンツ タイプごとに **32 文字の制限** があります。
Title は最大 **128 個の Content Type** を持つことができます。

### PricesOptions

price options リストの長さの制限は **15 個の価格オプション** です。

### Amounts

amounts リストの長さの制限は **15 個の数量** です。

### UnitDurationInSeconds

unit duration には **100 年 (3,155,695,200 秒)** の制限があります。

### AlternateIds

各代替 ID の値の長さの制限は **100 文字** です。

代替 ID のリストの長さは、**15 個の代替 ID** の制限があります。

### DisplayVersion

display version フィールドには、**50 文字** の値の長さの制限があります。

### ClientVersion

client version には **3 セグメントの制限** があり、各セグメントで最大 **65535** の値が許可されます。
例: "1.65535.234"。

### ItemReferences

ItemReferences フィールドには、**250 アイテム** の制限があります。

## カタログ構成

### AdminEntities

admin entities のリストには **64 エンティティの制限** があります。

### ReviewerEntities

admin entities のリストには **128 エンティティの制限** があります。

### ディープ リンク

ディープ リンクの最大数は **10 リンク** です。

### DisplayPropertyIndexInfo

各表示プロパティ タイプに **5 個の値** の制限があります。

### Content Types

content types のリストには **128 タイプ** の制限があり、それぞれの最大長は **40 文字** です。

### Platforms

platforms のリストには **128 プラットフォーム** の制限があり、それぞれの最大長は **40 文字** です。

### Tags

tags のリストには **1024 タグ** の制限があり、それぞれの最大長は **32 文字** です。

## プレイヤー インベントリ

### バッチ操作

実行できるインベントリ操作の最大数は **50 操作** です。

変更できるアイテムの最大数は **300 アイテム** です。
(たとえば、1 つの完全なバンドルと最大 50 個の他のアイテムを追加できます)

### インベントリ コレクション

最大コレクション サイズは **10000 アイテム** です。

コレクション リストの長さの制限は、エンティティごとに **1000 コレクション** です。

コレクション名の文字制限は **75 文字** です。

### 取引履歴

取引履歴の最大日付範囲は **4 年** です。

デフォルトの日付範囲は **6 か月** です。

## インベントリ アイテム

### 表示プロパティ

表示プロパティ フィールドには 1000 バイトの制限があります。


## Related topics

- [スロットリングのベスト プラクティス](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/throttling/best-practices.md)
- [PlayFab におけるスロットリング](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/service-gateway/throttling/what-is-throttling.md)
- [Economy v2 の概要](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/overview.md)
- [Game Saves の制限](https://docs.xbox.com/ja-jp/services/playfab/player-progression/game-saves/limits.md)
- [統計情報の制限](https://docs.xbox.com/ja-jp/services/playfab/player-progression/statistics/limits-statistics.md)
