- Selección de la API Collections Query adecuada para sus necesidades
- Descripción de los derechos satisfactorios en la respuesta
- Descripción de los artículos duplicados en la respuesta
Revise Requisitos previos para las API de servicio a servicio. Si los productos no están configurados correctamente para su tipo de autenticación, las llamadas pueden completarse correctamente pero no devolver resultados.
Selección de la API Collections Query adecuada para sus necesidades
Hay dos versiones de Collections Query:b2bLicensePreview (v8) y publisherQuery (v9). En la mayoría de los casos, use publisherQuery porque tiene parámetros de solicitud simplificados y admite el estado de XBOX Game Pass. Use b2bLicensePreview cuando necesite comportamientos heredados, como la compatibilidad con LegacyProductId.
Aunque no hay un URI de v9 equivalente para la funcionalidad de consumo, puede usar publisherQuery y el URI de consumo de v8 juntos sin problemas.
Descripción de los derechos satisfactorios en la respuesta
Un usuario puede tener derecho a un producto directamente (compra/canje) o indirectamente (agrupación/suscripción). Si el derecho es indirecto, la matrizsatisfiedByProductIds contiene los ProductId de los que procede el derecho.
Ejemplo: un usuario compró la agrupación Deluxe Edition de un juego. Al llamar a las API de consulta, se muestran en el resultado el producto del juego y los productos incluidos en la agrupación. Cada uno de estos artículos tiene el ProductID de la agrupación Deluxe Edition en su lista satisfiedByProductIds.
Descripción de los artículos duplicados en la respuesta
Es posible que vea varios artículos con el mismo ProductId/SKU cuando los usuarios tienen varias fuentes de derechos. Las diferencias suelen aparecer en campos comoacquisitionType, las fechas y satisfiedByProductIds. Use excludeDuplicates como true para contraer varias fuentes de derechos en un único artículo con el derecho de propiedad más directo, en este orden:
- Compra directa / código de canje
- Satisfecho por una agrupación comprada directamente
- Satisfecho por una suscripción
- Satisfecho por una compra promocional (por ejemplo, Games With Gold)
Active y Expired), solo se devuelve un artículo (aunque excludeDuplicates esté desactivado) usando la siguiente prioridad de estado:
ActiveInvalid(si hay varios derechos no válidos, se devolvería el artículo invalidado más recientemente)Revoked
Ejemplo
Un usuario compra el juego A y el complemento B y, más tarde, compra un pase de temporada que también incluye el complemento B. La respuesta puede contener dos entradas para el complemento B: la compra directa y el derecho satisfecho procedente del pase de temporada. SiexcludeDuplicates es true, solo se devuelve la entrada de la compra directa.