制限 - エコノミー (V2)

  • [アーティクル]

Important

エコノミー v2 が一般提供になりました。 サポートとフィードバックについては、PlayFab フォーラム をご利用ください。

このガイドの目的は、アイテムのカタログの作成、更新、読み取り、プレイヤー インベントリからのアイテムの追加、更新、削除時に適用される制限を詳しく説明することです。 これで、エコノミー (V2) ごとの最新の制限が含まれるようになりました。

  • 制限 (プレイヤー) は、対象となるエンティティがプレイヤーの場合を指します。
  • 制限 (タイトル) は、対象となるエンティティがタイトルの場合を指します。

注意

すべての API は、互いに個別にカウントされます。

カタログ調整

読み取り

API 制限 (プレイヤー) 制限 (タイトル)
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 制限 (プレイヤー) 制限 (タイトル)
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)

インベントリ調整

注意

  • インベントリ調整は、ターゲット エンティティに基づいて、API ごとに個別に計算されます。
  • たとえば、プレイヤーまたはタイトル (ゲーム サービス、coudscript など) がインベントリ API を呼び出してプレイヤー エンティティのインベントリを更新する場合、制限 (プレイヤー) 調整が適用されます。
  • グループ エンティティ インベントリもサポートされており、グループ エンティティはプレイヤー エンティティと同じ調整率を共有します。 「グループ、ギルド、クラン」も参照してください。

読み取り

API 制限 (プレイヤー) 制限 (タイトル)
get_inventory_items 1.67 rps (60 秒で 100) -
GetInventoryCollectionIds 1.67 rps (60 秒で 100) -

読み取り トランザクション履歴

API 制限 (プレイヤー) 制限 (タイトル)
GetTransactionHistory 0.1 rps (300 秒で 30) -

書き込み

API 制限 (プレイヤー) 制限 (タイトル)
AddInventoryItems 0.66 rps (90 秒間に 60) -
SubtractInventoryItems 0.66 rps (90 秒間に 60) -
UpdateInventoryItems 0.66 rps (90 秒間に 60) -
PurchaseInventoryItems 0.66 rps (90 秒間に 60) -
TransferInventoryItems 0.66 rps (90 秒間に 60) -
DeleteInventoryItems 0.66 rps (90 秒間に 60) -
ExecuteInventoryOperations 0.66 rps (90 秒間に 60) -
DeleteInventoryCollection 0.16 rps (90 秒で 15) -

使う

API 制限 (プレイヤー) 制限 (タイトル)
RedeemAppleAppStoreInventoryItems 0.66 rps (90 秒間に 60) -
RedeemGooglePlayInventoryItems 0.66 rps (90 秒間に 60) -
RedeemMicrosoftStoreInventorItems 0.66 rps (90 秒間に 60) -
RedeemNintendoEShopInventoryItems 0.66 rps (90 秒間に 60) -
RedeemPlayStationStoreInventoryItems 0.66 rps (90 秒間に 60) -
RedeemSteamInventoryItems 0.66 rps (90 秒間に 60) -

API の制限

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

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

バイナリコンテンツの量

最大 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 に対して返されるアイテムの最大数です。 継続トークンを使用すると、制限を超える結果を返す結果をページ分割できます。

API 応答圧縮による制限 応答圧縮なしで制限する
get_inventory_items 250 項目 50 項目
GetInventoryCollectionIds 250 項目 50 項目
GetTransactionHistory 250 項目 50 項目

インベントリの既定のページ サイズ

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

検索フィルターの複雑さ

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

カタログ アイテム

タイトル

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

説明

説明には、国コードごとに 10,000 文字の制限があります。

Keywords

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

画面のプロパティ

画面のプロパティ フィールドには 10000 バイトの制限があります。

Tags

タグには、タグごとに 32 文字の制限があります。 タイトルには最大 1,024 個のタグを付けることができ、アイテムには最大 32 個のタグを追加できます

コンテンツの種類

コンテンツ タイプには、コンテンツ タイプごとに 32 文字の制限があります。 タイトルには最大 128 のコンテンツ タイプを含めることができます。

PricesOptions

価格オプションの一覧には、15 個の価格オプションの長さの制限があります。

金額

金額一覧には、15 の長さの制限があります。

UnitDurationInSeconds

期間単位には、100 年 (3,155,695,200 秒) の制限があります。

AlternateIds

各代替 ID には、100 文字の文字数制限があります。

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

DisplayVersion

表示バージョン フィールドには、50 文字 の文字数制限があります。

ClientVersion

クライアント バージョンには 3 つのセグメント制限があり、各セグメントでは最大 65535 までの値が許可されます。
例: "1.65535.234"。

ItemReferences

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

カタログ構成

AdminEntities

管理者エンティティの一覧には、64 個のエンティティ制限があります。

ReviewerEntities

管理者エンティティの一覧には、128 個のエンティティ制限があります。

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

DisplayPropertyIndexInfo

表示プロパティの種類ごとに 5 つの値という制限があります。

コンテンツの種類

コンテンツの種類の一覧には 128 種類の制限があり、それぞれ長さは最大 40 文字です。

プラットフォーム

プラットフォームの一覧には 128 個のプラットフォームの制限があり、それぞれ長さは最大 40 文字です。

タグ

タグの一覧には 1024 個のタグの制限があり、それぞれ長さは最大 32 文字です。

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

バッチ操作

実行可能なインベントリ操作の最大実行回数は 50 回です。

変更できるアイテムの最大数は 300 アイテムです。
(たとえば、5*50 = 250 が 250 の制限に一致するため、最大 5 つの完全なバンドルを追加できます)

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

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

コレクション リストの長さの制限は無制限です。

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

トランザクションの履歴

トランザクション履歴の最大日付範囲は無制限です。

既定の日付範囲は 6 か月です。

在庫品目

画面のプロパティ

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