Store Development Entitlements Tool (DevEntitlementTool.exe)

[アーティクル]
11/19/2024

サンドボックス内の Xbox テストアカウントで Microsoft Store エンタイトルメントを照会、追加、削除するためのコマンドラインツール。

使用方法

deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]

コマンド	説明
query	アカウントが所有する権利を検索する
add	指定した権利をアカウントに追加する
delete	指定した権利をアカウントから削除する
catalog	指定された親製品によって販売可能な利用可能な製品を表示する

すべてのコマンドに、 /e (電子メール) パラメーターと /s (サンドボックス) パラメーターが必要です。アカウントを使用した初期サインインでは、対話型のパスワード入力ダイアログが呼び出されます。正常にサインインすると、デバイス上の同じアカウント/サンドボックスを使用した後続の操作では、パスワード入力が不要になります。

query

deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]

このアカウントに関連付けられているすべての直接所有の権利をサンドボックスに一覧表示します。

クエリ出力

Entitlements found: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...

クエリの例

> DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1
Entitlements found: 2
9MT5TGW893HV: 4/18/2023 5:05:19 PM  Active
9N30KZZF4BR9: 7/24/2024 2:34:08 AM  Active

各権利の詳細を表示するには、/d を使用します。

> DevEntitlementTool.exe query /e xdks-testaccount00000@xboxtest.com /s XDKS.1 /d
Entitlements found: 2
9MT5TGW893HV: 4/18/2023 5:05:19 PM  Active Consumable   ATG Sample Consumable 3
9N30KZZF4BR9: 7/24/2024 2:34:08 AM  Active Durable      ATG Sample Durable 1

add

deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]

指定した製品の権利をアカウントに追加します。これは、Store から、または購入 API を介して製品を購入することに相当します。

ゲーム、非消費型アイテム、バンドル、および開発管理の消費型製品の場合、既に権利のある製品 (または数量が 1) に対して追加が試行された場合、既存の権利が報告されます。新しい権利または数量は追加されません。

ストア管理の消費型製品の場合、各 add コマンドで消費型残高に既定の数量 1 が追加されます。オプションの数量値を指定してこの既定値を変更できますが、数量フィールドは、単一の productID が /p で渡された場合にのみ使用できます。これは、購入時に数量が 1 を超える消費型アイテムに役立ちます。

詳細を表示する /d がサポートされています。

注意

数量は、このツールでは検証できません。 XStoreCollectionData 構造体を調べて数量を決定してください。

バンドルである製品を追加すると、含まれるすべての製品が付与されます。数量が指定され、バンドルにストア管理の消耗品アイテムが含まれている場合、各消耗品アイテムに同じ数量が割り当てられます。

注意

サブスクリプション製品はサポートされていません。

出力を追加する

Entitlements added: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...

追加の例

1 つの権利が追加されました

> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV
Entitlements added: 1
9MT5TGW893HV: 2/20/2024 12:21:25 AM Active

複数の権利が追加されました

> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18 9NQWJKKNHF1L
Entitlements added: 4
9P23V43P0XZZ: 2/20/2024 12:33:20 AM Active
9N30KZZF4BR9: 2/20/2024 12:33:20 AM Active
9NCX1H100M18: 2/20/2024 12:33:20 AM Active
9NQWJKKNHF1L: 2/20/2024 12:33:20 AM Active

数量で消耗品アイテムを追加する

> DevEntitlementTool.exe add /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9MT5TGW893HV /q 4321
Entitlements added: 1
9MT5TGW893HV: 2/20/2024 12:34:35 AM Active

delete

deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]

指定した権利をアカウントから削除します。

/all が指定されている場合、アカウントとサンドボックスに関連付けられているすべての権利の削除が試行されます。

このツールによって付与された権利を削除すると、失効済み状態が表示されます。

ストアクライアントまたはゲーム内 API を通じて従来通りに購入された権利を削除すると、払い戻し済み状態が表示されます。

詳細を表示する /d がサポートされています。

削除出力

Entitlements deleted: {Number of entitlements}
{ProductID}: {Last Updated Date (UTC)} {Status}
...

削除の例

> DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9P23V43P0XZZ 9N30KZZF4BR9 9NCX1H100M18
Entitlements deleted: 3
9P23V43P0XZZ: 2/20/2024 2:26:13 AM Revoked
9N30KZZF4BR9: 2/20/2024 2:26:13 AM Revoked
9NCX1H100M18: 2/20/2024 2:26:13 AM Revoked

> DevEntitlementTool.exe delete /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9PLRFWZWWF91
Entitlements deleted: 1
9PLRFWZWWF91: 1/1/0001 12:00:00 AM Refunded

catalog

deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]

指定された製品 ID で販売可能な一連の製品を表示します。つまり、子アドオン製品およびパートナーセンターの productID と使用および販売可関係を持つ製品です。このコマンドは、XStoreQueryAssociatedProductsAsync によって返される内容と同等です。パートナーセンターで使用可能だが Microsoft Store では検出不可として構成されている製品は、このコマンドでは返されません。必要に応じて、市場を指定して、その特定の市場の価格を取得できます。 ISO の 2 文字による国コード (GB、CA、JP、ES など) を指定する必要があります。

カタログ出力

Parent product: {ProductID} ({Parent Product Name})
can sell {Number of products} products:
1. {ProductID} {Product Name} {Product Type} {Price}
2. {ProductID} {Product Name} {Product Type} {Price}
...

カタログの例

> DevEntitlementTool.exe catalog /e xdks-test00000@xboxtest.com /s XDKS.1 /p 9NTL0QDWZ4FS /m SG
Parent product: 9NTL0QDWZ4FS (ATG In-Game Store)
can sell 16 products:
 1. 9PHPTTDP88F7: ATG Season Pass 1                        Durable      23.25 SGD
 2. 9NMDDZC7ZWRM: ATG Sample Year 1 Pass                   Durable      2850 SGD
 3. 9PGLXLWS7319: ATG Consumable Only Bundle               Durable      7.2 SGD
 4. 9P23V43P0XZZ: ATG Sample Durable 2                     Durable      0 SGD
 5. 9MZ0MGGFPLTP: ATG Sample Subscription 1                Durable      0 SGD
 6. 9MT5TGW893HV: ATG Sample Consumable 3                  Consumable   4.35 SGD
 7. 9N30KZZF4BR9: ATG Sample Durable 1                     Durable      0 SGD
 8. 9PLRFWZWWF91: ATG Sample Durable 4                     Durable      0 SGD
 9. 9PLNMXRKNM4C: ATG Sample Durable 1 (with package)      Durable      0 SGD
10. 9P8S15PJTB0P: ATG Sample Durable 3                     Durable      48.75 SGD
11. 9NCX1H100M18: ATG Sample Consumable 2                  Consumable   2.85 SGD
12. 9N0297GK108W: ATG Dev managed consumable 1             Consumable   2.1 SGD
13. 9NQWJKKNHF1L: ATG Downloadable Content Sample          Game         0 SGD
14. 9NRGW2QG5PCW: ATG Sample Pre-Order 1                   Durable      0 SGD
15. 9PHHWZ12RR23: ATG In-Game Store Deluxe Add-on          Durable      0 SGD
16. 9PFL4RQTB1P6: ATG Sample Consumable 1                  Consumable   1.5 SGD

解説

このツールは厳密に、Xbox テストアカウントとサンドボックス製品に対して使用されます。小売アカウントおよびシナリオの使用はブロックされています。

アカウントごとに 1 日あたりの追加操作と削除操作には制限があります。これは、確認済み使用状況に基づいて調整されます。制限の引き上げをリクエストする場合は、Microsoft アカウントの担当者にお問い合わせください。

次の方法で共有