制限 - エコノミー (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 アイテムです。
(たとえば、1 つの完全なバンドルと最大 50 個の他の項目を追加できます)
インベントリ コレクション
コレクションの最大サイズは 10000 アイテムです。
コレクション リストの長さの制限は無制限です。
コレクションの名前の文字数制限は75 文字です。
トランザクションの履歴
トランザクション履歴の最大日付範囲は無制限です。
既定の日付範囲は 6 か月です。
在庫品目
画面のプロパティ
画面プロパティ フィールドには 1000 バイトの制限があります。