メインコンテンツへスキップ
playfab economy inventory を使用して、PlayFab Economy v2 のインベントリを読み取り、変更します。これには、 コレクション、トランザクション履歴、バッチ処理されたインベントリ操作が含まれます。 インベントリ コマンドは、--entity-id と --entity-type の両方を渡さない限り、呼び出し元のエンティティを 対象とします。プレイヤーの場合は、マスター プレイヤー アカウント ID ではなく、タイトル プレイヤー アカウント ID を --entity-type title_player_account と共に渡します。この ID は、 playfab player account get から UserInfo.TitleInfo.TitlePlayerAccount.Id として返されます。--collection-id は、default 以外のインベントリ コレクションを選択します。 operation execute は、--confirm (--yes、-y) を渡さない限り、ターミナルであっても Delete 操作を含むバッチを 拒否します。その他のインベントリの変更は確認なしで実行されます。 安全性と破壊的な操作を参照してください。

インベントリ アイテム

  • inventory list は、--limit 個のアイテム (既定では 10 個) を 1 ページとして返します。次のページを取得するには、 応答の継続トークンを --continuation-token で渡します。
  • --filter は、アイテムのプロパティ type、id、stackId に対する OData フィルターです。
  • inventory add は、変更後のインベントリではなく、ETag、IdempotencyId、および記録した TransactionIds を 返します。結果を確認するには、inventory list を実行します。

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

インベントリ操作

operation execute は、バッチを 1 つのトランザクションとして実行します。inventory add と同様に、バッチ全体の ETag、IdempotencyId、TransactionIds を返します。実行された内容を確認するには、inventory list または inventory transaction list を実行します。 operation status は、要求が返された時点で完了していなかったインベントリの転送を確認します。 TransferInventoryItems と ExecuteTransferOperations は、OperationStatus が InProgress の間、 OperationToken を返します。そのトークンと、転送の GivingEntity を --entity-id と --entity-type として渡します。 CLI にはこれらの転送 API 用のコマンドがないため、playfab api で呼び出します。トランザクション ID は 操作トークンではなく、PlayFab はトランザクション ID を Bad OperationToken. で拒否します。

インベントリ トランザクション

--filter では、timestamp、transactionid、apiname、operationtype を参照できます。 --order-by には timestamp asc または timestamp desc を指定できます。

表形式の出力

次のコマンドは --output table を受け付けます。inventory add と operation execute は受け付けません。 テーブル出力を参照してください。 表には継続トークンが表示されないため、最初のページ以降を表示するには JSON 出力を 使用します。

例

1 人のプレイヤーのインベントリ、コレクション、トランザクション履歴を読み取ります。
プレイヤーのインベントリにアイテムを 1 つ追加します。
ops.json のインベントリ操作のバッチを実行します。
ops.json に Delete 操作が含まれている場合は、--confirm を追加します。
"OperationStatus": "InProgress" を返した転送を、その応答の OperationToken と、アイテムを譲渡した プレイヤーを使用して確認します。
最終更新日 2026年11月19日