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

# Economy V2 の制限

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

# 制限 - Economy (V2)

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

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

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

<Note>
  すべての API は、互いに独立して計測されます。
</Note>

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

### 読み取り

| **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 エンティティ](/services/playfab/live-service-management/game-configuration/entities#group) のインベントリもサポートされており、Group Entity は Player エンティティと同じスロットリング レートを共有します。[Groups](/services/playfab/community/associations/groups) も参照してください。
</Note>

### 読み取り

| **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 で返されるアイテムの最大数です。[継続トークン](/services/playfab/economy-monetization/economy-v2/catalog/search#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 で返されるアイテムの最大件数です。[継続トークン](/services/playfab/economy-monetization/economy-v2/catalog/search#continuation-tokens) を使用して、制限を超える結果をページングできます。

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

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

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

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

`SearchItems` 呼び出しで使用される過度に複雑な `Filter` クエリの使用を防ぐためのチェックが適用されます。詳細については、[こちら](/services/playfab/economy-monetization/economy-v2/catalog/search#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

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