​

Información general sobre artículos e inventario de PlayFab

​

Conceptos clave

• Catálogo: un catálogo es una colección de todos los artículos que están disponibles en el juego. Los catálogos ofrecen una manera sencilla de administrar los artículos virtuales del juego. Para obtener más información, consulte la información general del catálogo.
• Artículos de catálogo: artículos individuales definidos en el catálogo. Pueden representar cualquier tipo de bien virtual, como armas, atuendos, potenciadores, cajas de botín, etc. Puede personalizar sus propiedades y comportamientos para adaptarlos al diseño del juego.
• Tiendas de catálogo: las tiendas le permiten crear varios listados de artículos para distintos fines, como eventos de temporada, promociones o pruebas. Consulte Tiendas.
• Paquetes: los paquetes son artículos de catálogo que contienen referencias a otros artículos. Cuando un jugador compra un paquete, los artículos referenciados se desempaquetan y se agregan a su inventario.
• Suscripciones: las suscripciones conceden acceso basado en tiempo a bienes duraderos. Los artículos de una suscripción están disponibles en el inventario de un jugador mientras dure la suscripción. Consulte Suscripciones.
• Colecciones de inventario del jugador: el inventario es un registro de los artículos que un jugador posee en el juego. Contiene información sobre las cantidades de artículos, los saldos de moneda virtual y las propiedades personalizadas. Todas las cuentas de jugador pueden tener uno o varios inventarios denominados colecciones.
• Pilas: las pilas permiten que existan varias instancias distintas del mismo artículo dentro de un único inventario, cada una con su propia cantidad y propiedades personalizadas. Consulte Pilas.
• Moneda virtual: la moneda virtual es un tipo de artículo que se usa como medio de intercambio en el juego. Puede usar la moneda virtual para comprar artículos del catálogo o de una tienda, implementar moneda blanda a partir de compras dentro de la aplicación o impulsar mecánicas de juego.

​

API clave

​

Administración del inventario

• GetInventoryItems: recupera el inventario actual de una entidad. Admite la paginación con ContinuationToken y la carga masiva mediante TurboLoading.
• AddInventoryItems: agrega artículos directamente al inventario de un jugador.
• SubtractInventoryItems: reduce las cantidades de artículos en el inventario de un jugador.
• UpdateInventoryItems: establece cantidades de artículos o modifica las propiedades de presentación de los artículos del inventario.
• DeleteInventoryItems: quita pilas completas de artículos del inventario de un jugador.

​

Compra e intercambio

• PurchaseInventoryItems: compra artículos de catálogo o paquetes usando moneda virtual. Deduce la moneda del inventario del jugador y concede el artículo comprado.
• TransferInventoryItems: transfiere artículos entre jugadores, entre las colecciones de inventario de un jugador o entre pilas dentro del mismo inventario.

​

Operaciones por lotes

• ExecuteInventoryOperations: agrupa por lotes hasta 10 operaciones de inventario (Add, Subtract, Update, Purchase, Transfer, Delete) en una única solicitud atómica. Si alguna operación falla, se revierte todo el lote.

​

Historial y diagnóstico

• GetTransactionHistory: recupera los eventos de transacciones del inventario de un jugador. Admite el filtrado por marca de tiempo y la paginación para revisar el historial completo de operaciones. Consulte Historial de transacciones.

​

Confiabilidad

• Idempotencia: todas las API de inventario admiten un parámetro IdempotencyId para reintentar solicitudes de forma segura sin efectos secundarios duplicados. Los identificadores se aplican durante 14 días. Consulte Idempotencia.