Skip to main content

制限 - Economy (V2)

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラム を参照してください。
このガイドでは、アイテムのカタログの作成、更新、読み取り、およびプレイヤー インベントリからの追加、更新、削除の際に適用される制限について詳しく説明します。Economy (V2) に応じた最新の制限が含まれています。
  • Limit (Player) は、対象のエンティティが Player である場合を指します。
  • Limit (Title) は、対象のエンティティが Title である場合を指します。
すべての API は、互いに独立して計測されます。

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

読み取り

書き込み/管理

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

  • インベントリのスロットリングは、API ごとに個別に、ターゲット エンティティに基づいて計算されます。 - たとえば、Player または Title (ゲーム サービス、CloudScript など) が Inventory API を呼び出して Player エンティティのインベントリを更新すると、Limit (Player) のスロットリングが適用されます。 - Group エンティティ のインベントリもサポートされており、Group Entity は Player エンティティと同じスロットリング レートを共有します。Groups も参照してください。

読み取り

取引履歴の読み取り

書き込み

引き換え

API 制限

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

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

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

1 つのアイテムに最大 100 個の画像100 個のファイル を追加できます。
  • ファイルには制限はありません。
  • 画像は .png.jpg.gif.bmp ファイル タイプでのみアップロードできます。

CreateUploadsUrls

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

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

以下は、さまざまな API で返されるアイテムの最大数です。継続トークン を使用して、制限を超える結果をページングできます。
  • 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 で返されるアイテムの最大件数です。継続トークン を使用して、制限を超える結果をページングできます。

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

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

検索フィルターの複雑さ

SearchItems 呼び出しで使用される過度に複雑な Filter クエリの使用を防ぐためのチェックが適用されます。詳細については、こちら を参照してください。

カタログ アイテム

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

カタログ作成者エンティティごとに最大 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 バイトの制限があります。
最終更新日 2026年8月13日