購入要件を設定する

Last updated on October 7, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

購入要件は、プレイヤーがアイテムを購入する資格を得るために満たす必要がある条件です。これらの要件には、エンタイトルメント、シーズンパス、シーズンティア、統計コードなどの条件を含めることができます。

この記事では、AGS 管理者ポータルまたは AGS CLI で、ストアアイテムの購入要件を設定する方法について説明します。

AGS CLI の手順に従うには、AGS CLI をインストールし、これらの機能にアクセスできるアカウントでサインインします。インストールとサインインを参照してください。例では Bash シェルを使用しています。

アイテムの購入要件を追加および設定する

Admin Portal

1. 管理者ポータルのサイドバーで、Online > Store & Catalog > Stores に移動します。Stores ページが表示されます。

2. Storeページで、Viewボタンをクリックしてドラフトストアを開きます。

3. ドラフトストアの詳細ページで、ドラフトのItemsタブを開き、購入要件を設定するアイテムを見つけます。アイテムのViewボタンをクリックして、詳細ページを開きます。

4. アイテムのBasic Informationセクションで、Purchasing Requirementの横にあるView Configurationsをクリックします。Purchasing Requirement Configurationsページが表示されます。

5. アイテムの購入要件を作成および設定します。

   

   各要件タイプの設定方法のガイドラインについては、以下を参照してください。

   • エンタイトルメント
   • シーズンパス
   • シーズンティア
   • 統計コード

6. さらに要件または要件グループを追加します。

   注記

   1つのアイテムは、複数の購入要件グループを持つことができ、各グループは複数の購入条件を含むことができます。

   • 同じグループ内の要件はANDロジックを使用します。つまり、プレイヤーはアイテムを購入するためにグループ内のすべての要件を満たす必要があります。
   • 要件グループはORロジックを使用します。つまり、プレイヤーはアイテムを購入できるようにするために、グループ要件のいずれかを満たすだけで済みます。

7. Save Configurationをクリックして変更を保存します。

AGS CLI

1. ドラフトストアの ID を確認します。出力で、published が false に設定されているストアの storeId がそれにあたります。

   ags platform stores list --namespace <YourNamespace> --format json

2. 購入要件を追加するアイテムを見つけます。<ItemName> をアイテム名の全部または一部に置き換えます。

   ags platform items list --namespace <YourNamespace> --store-id <StoreId> --item-name '<ItemName>' --format json

   アイテムの itemId を使用します。エンタイトルメント要件で使用する各アイテムの itemId も、同じコマンドで確認します。

3. 出力の purchaseCondition フィールドで、アイテムの現在の購入要件を確認します。

   ags platform items get --namespace <YourNamespace> --store-id <StoreId> --item-id <ItemId> --active-only false --format json

4. アイテムに設定するすべての購入要件を含む JSON ファイルを作成します。手順 3 の要件のうち残したいものも含めてください。ファイル名は任意です。この例では purchase-condition.json を使用し、エンタイトルメント要件と統計コード要件を持つグループと、シーズンパス要件とシーズンティア要件を持つ 2 つ目のグループを定義しています。

   {
     "purchaseCondition": {
       "conditionGroups": [
         {
           "operator": "and",
           "predicates": [
             {
               "name": "Owns two of three swords",
               "predicateType": "EntitlementPredicate",
               "comparison": "includes",
               "anyOf": 2,
               "values": ["<ItemId1>", "<ItemId2>", "<ItemId3>"]
             },
             {
               "name": "Level 10 or higher",
               "predicateType": "StatisticCodePredicate",
               "code": "<StatCode>",
               "comparison": "isGreaterThanOrEqual",
               "value": "10"
             }
           ]
         },
         {
           "operator": "and",
           "predicates": [
             {
               "name": "Season pass holder",
               "predicateType": "SeasonPassPredicate",
               "comparison": "includes",
               "anyOf": 1,
               "values": ["<PassCode>"]
             },
             {
               "name": "Tier 5 or higher",
               "predicateType": "SeasonTierPredicate",
               "comparison": "isGreaterThanOrEqual",
               "value": "5"
             }
           ]
         }
       ]
     }
   }

   • conditionGroups: 要件グループ。プレイヤーは、少なくとも 1 つのグループ内のすべての要件を満たす必要があります。
   • name: 要件の名前。
   • anyOf: Any [number] Of の値。values の数を超えることはできません。
   • values: エンタイトルメント要件の場合はアイテム ID、シーズンパス要件の場合はパスコード。
   • value: 比較対象の数値。文字列として記述します。

   各要件タイプでは、次のフィールドを使用します。

   要件タイプ	predicateType	フィールド
   エンタイトルメント	EntitlementPredicate	comparison、anyOf、values
   シーズンパス	SeasonPassPredicate	comparison、anyOf、values
   シーズンティア	SeasonTierPredicate	comparison、value
   統計コード	StatisticCodePredicate	code（統計コード）、comparison、value

   管理者ポータルの各 Condition には、対応する comparison の値があります。

   管理者ポータルの条件	comparison
   includes、enrolled	includes
   excludes、not enrolled	excludes
   equals	is
   not equals	isNot
   is less than	isLessThan
   is less than or equal	isLessThanOrEqual
   is greater than	isGreaterThan
   is greater than or equal	isGreaterThanOrEqual

5. 購入要件をアイテムに保存します。この更新により、アイテムのすべての購入要件がファイル内の要件に置き換えられます。@ の後に JSON ファイルのパスを指定します。

   ags platform items update-purchase-condition --namespace <YourNamespace> --store-id <StoreId> --item-id <ItemId> \
     --json @purchase-condition.json

設定ガイドライン

このセクションでは、各購入要件タイプを設定するためのガイドラインとサンプルシナリオについて説明します。

エンタイトルメント

エンタイトルメントを使用して、プレイヤーがインベントリに持っているアイテムまたは持っていないアイテムに基づいて、アイテムを購入するための特定の条件を設定できます。購入要件としてエンタイトルメントを追加または設定するには、次のようにフィールドを設定します。

• Condition:
  • includesを使用して、購入資格を得るためにプレイヤーがインベントリにすでに持っている必要があるアイテムを指定します。
  • excludesを使用して、購入資格を得るためにプレイヤーがインベントリに持っていてはならないアイテムを指定します。
• Any [number] Of: プレイヤーがインベントリに持っている必要がある、または持っていてはならないリストされたアイテムの数を示します。
• Items selected: 購入の資格を決定するアイテム（ゲーム内アイテム、コイン、メディア）をリストします。

特定のシナリオのサンプル設定は次のとおりです。

要件シナリオ	Condition	Any [number] of	Items selected
プレイヤーが4つの指定されたアイテムのうち2つを持っている必要があります。	includes	2	Diamond Sword、Scarlet Sword、Solar Cape、Moon Shield
プレイヤーが4つの指定されたアイテムすべてを所有している必要があります。	includes	4	Diamond Sword、Scarlet Sword、Solar Cape、Moon Shield
プレイヤーが4つの指定されたアイテムのいずれも所有していない必要があります。	excludes	1	Diamond Sword、Scarlet Sword、Solar Cape、Moon Shield

シーズンパス

シーズンパスは、プレイヤーが登録されているシーズンまたは登録されていないシーズンに基づいて、アイテムを購入するための条件として使用できます。詳細については、シーズンパスを設定するを参照してください。

購入要件としてシーズンパスを設定するには、次のようにフィールドを設定します。

• Condition:
  • enrolledを使用して、プレイヤーがリストされたシーズンパスに登録されている必要があることを示します。
  • not enrolledを使用して、プレイヤーがリストされたシーズンパスに登録されていない必要があることを示します。
• Any [number] Of: プレイヤーが登録されている必要がある、または登録されていない必要があるリストされたシーズンパスの数を示します。
• Pass codes selected: 購入の資格を決定するシーズンパスをリストします。

特定のシナリオのサンプル設定は次のとおりです。

要件シナリオ	Condition	Any [number] of	Pass codes selected
プレイヤーがリストされたシーズンパスのいずれかに登録されている必要があります。	enrolled	1	SeasonPassCode1、SeasonPassCode2、SeasonPassCode3、SeasonPassCode4
プレイヤーがリストされたシーズンパスのうち3つに登録されている必要があります。	enrolled	3	SeasonPassCode1、SeasonPassCode2、SeasonPassCode3、SeasonPassCode4
プレイヤーがリストされたシーズンパスのいずれにも登録されていない必要があります。	not enrolled	1	SeasonPassCode1、SeasonPassCode2、SeasonPassCode3、SeasonPassCode4

シーズンティア

シーズンティアは、プレイヤーがシーズン内のどのティアにいるかに基づいて、アイテムを購入するための条件として使用できます。詳細については、ティアを設定するを参照してください。

購入要件としてシーズンティアを設定するには、次のようにフィールドを設定します。

• Condition: シーズンティアの条件を設定します。利用可能な条件オプションは次のとおりです。
  • Equals
  • not equals
  • is less than
  • is less than or equal
  • is greater than
  • is greater than or equal
• Value: シーズンティアの数値を指定します。例えば、ティア10を参照するには、これを「10」に設定します。

特定のシナリオのサンプル設定は次のとおりです。

要件シナリオ	Condition	Value
プレイヤーは1から5の間の任意のティアにいる必要があります。	is less than or equal to	5
プレイヤーはティア10にいてはいけません。他のティアは問題ありません。	not equals	10
プレイヤーはティア10以上にいる必要があります。	is greater than or equal	10

統計コード

統計コードは、スコアやレベルなどのプレイヤー統計に基づいて、アイテムを購入するための条件として使用できます。統計コードの管理の詳細については、プレイヤーとゲーム全体のグローバル統計を追跡するを参照してください。

購入要件として統計コードを設定するには、次のようにフィールドを設定します。

• Condition:
  • equals
  • not equals
  • is less than
  • is less than or equal
  • is greater than
  • is greater than or equal
• Value: 条件が適用される統計の数値を指定します。例えば、これを「10」に設定すると、要件がスコアまたはレベル10に関連していることを意味する場合があります。

特定のシナリオのサンプル設定は次のとおりです。

要件シナリオ	Condition	Value
プレイヤーは0から100の間のスコアを持っている必要があります。	is less than or equal to	100
プレイヤーは100に等しいスコアを持っていてはいけません。100未満または100を超えるスコアは問題ありません。	not equals	100
プレイヤーはレベル10以上である必要があります。	is greater than or equal	10
プレイヤーは0から9の間の任意のレベルである必要があります。	is less than	10