메인 콘텐츠로 건너뛰기
playfab economy inventory로 컬렉션, 트랜잭션 기록, 일괄 인벤토리 작업을 포함한 PlayFab Economy v2 인벤토리를 읽고 변경합니다. 인벤토리 명령은 --entity-id와 --entity-type을 모두 전달하지 않으면 호출하는 엔터티를 대상으로 합니다. 플레이어의 경우 마스터 플레이어 계정 ID가 아니라 타이틀 플레이어 계정 ID를 --entity-type title_player_account와 함께 전달하세요. playfab player account get은 이 ID를 UserInfo.TitleInfo.TitlePlayerAccount.Id로 반환합니다. --collection-id는 default가 아닌 인벤토리 컬렉션을 선택합니다. operation execute는 --confirm(--yes, -y)을 전달하지 않으면 터미널에서도 Delete 작업이 포함된 일괄 처리를 거부합니다. 다른 인벤토리 변경은 묻지 않고 실행됩니다. 안전 및 파괴적 작업을 참조하세요.

인벤토리 항목

  • inventory list는 --limit개 항목(기본값 10개)의 한 페이지를 반환합니다. 다음 페이지를 가져오려면 응답의 연속 토큰을 --continuation-token으로 전달하세요.
  • --filter는 항목 속성 type, id, stackId에 대한 OData 필터입니다.
  • inventory add는 변경된 인벤토리가 아니라 ETag, IdempotencyId 및 기록한 TransactionIds를 반환합니다. 결과를 보려면 inventory list를 실행하세요.

인벤토리 컬렉션

인벤토리 작업

operation execute는 일괄 처리를 하나의 트랜잭션으로 실행합니다. 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 출력을 사용하세요.

예제

플레이어 한 명의 인벤토리, 컬렉션 및 트랜잭션 기록을 읽습니다.
플레이어의 인벤토리에 항목 하나를 추가합니다.
ops.json의 인벤토리 작업 일괄 처리를 실행합니다.
ops.json에 Delete 작업이 포함되어 있으면 --confirm을 추가합니다.
"OperationStatus": "InProgress"를 반환한 전송을, 해당 응답의 OperationToken과 항목을 준 플레이어를 사용하여 확인합니다.
마지막 수정일 2026년 11월 19일