¿Busca la referencia REST de servicio a servicio de Microsoft Store (colecciones, compras, reversiones, concesiones, periodicidades)? Se encuentra en la pestaña API, en API REST de Microsoft Store.
En esta sección
Introducción
Información general, tipos de producto, configuración de Partner Center, pruebas, licencias y solución de problemas.
Aspectos básicos
Operaciones básicas de la tienda, DLC, versiones de prueba, consumibles, lotes, DWOB y actualizaciones.
Administración desde sus servicios
Autenticación de servicios, consulta de derechos, suscripciones, reembolsos e identificadores User Store ID.
Consideraciones específicas de PC
DRM, tokens de licencia, control de cuentas de la Tienda no coincidentes y cambio de sandbox.
API REST de Microsoft Store
Referencia de los puntos de conexión v8/v9 de colecciones, compras, reversiones, concesiones y periodicidades. La referencia completa ahora se encuentra en la pestaña API, en API REST de Microsoft Store.
Centros de juegos de franquicia
Agrupe varios productos bajo un único centro de franquicia de la Tienda.
Panorama general: cómo se conectan las piezas
- Partner Center: donde crea productos (juegos base, complementos, lotes, pases de temporada, suscripciones, consumibles), define los precios y la disponibilidad y asigna identificadores (StoreId, Product ID, BigId, SKU ID).
MicrosoftGame.config: se distribuye dentro del paquete de su título y vincula el ejecutable en ejecución con el producto de la Tienda medianteTitleId,StoreIdyMSAAppId.- API en tiempo de ejecución de XStore (
XStore*): llamadas del lado del cliente realizadas desde su juego para enumerar productos, consultar licencias y derechos, mostrar la interfaz de usuario de compra y notificar el cumplimiento de consumibles. - API de XPackage (
XPackage*): montan y licencian paquetes opcionales (DLC), instalan fragmentos y observan los cambios de estado de los paquetes. - API REST S2S de Microsoft Store: puntos de conexión del lado del servidor a los que llama su back-end para consultar derechos de forma autoritativa, cumplir consumibles, conceder productos, buscar suscripciones y procesar reembolsos y reversiones.
- User Store ID (UserStoreId): una clave de corta duración que su título obtiene mediante
XUserGetTokenAndSignatureAsync(oXStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync) y entrega a su servicio para que este pueda llamar a la Tienda en nombre de ese usuario.
Cliente frente a servicio
Casi todos los escenarios de la Tienda tienen tanto una vía del lado del cliente (XStore) como una del lado del servicio (REST S2S). Use el cliente para la experiencia de usuario en tiempo real (mostrar el botón de compra, desbloquear contenido, notificar un gasto de consumible); use el servicio cuando la autoridad sea lo importante (cumplir un gasto de moneda virtual que debe sobrevivir a las reinstalaciones del título, conceder un artículo promocional, detectar Game Pass, procesar un reembolso). Un patrón confiable:- El cliente detecta la compra o el gasto y muestra la experiencia de usuario inmediata.
- El cliente envía un UserStoreId a su servicio.
- El servicio llama a la API S2S de la Tienda para confirmar el derecho o cumplir el consumible y actualiza su base de datos de registro.