> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta de los derechos de los usuarios desde sus servicios

> Consulte los derechos de los usuarios desde sus servicios mediante las API Collections Query de Microsoft Store, incluidos los derechos satisfactorios y el estado de propiedad.

Las API Collections Query son la forma principal en que los servicios determinan la propiedad y el estado de los derechos de los usuarios. En comparación con las API de XStore del lado cliente, las consultas de servicio a servicio admiten escenarios más amplios a nivel de editor y arquitecturas de servicio centralizadas.

Los resultados de las API de Collections incluyen solo los productos que el usuario de destino posee directamente o sobre los que tiene derecho directo. Los derechos compartidos que son válidos en el cliente no se devuelven en las respuestas de servicio a servicio. Para obtener más información sobre los escenarios de uso compartido, consulte [Modelo de uso compartido de productos para juegos](/publishing/xstore-commerce/xstore-product-sharing).

Este artículo le ayuda a comprender las API de consulta e integrarse con ellas mediante:

* [Selección de la API Collections Query adecuada para sus necesidades](#selecting-the-right-collections-query-api-for-your-needs)
* [Descripción de los derechos satisfactorios en la respuesta](#understanding-satisfying-entitlements-in-the-response)
* [Descripción de los artículos duplicados en la respuesta](#understanding-duplicate-items-in-the-response)

<Note>
  Revise [Requisitos previos para las API de servicio a servicio](/publishing/xstore-commerce/xstore-authenticating-service). Si los productos no están configurados correctamente para su tipo de autenticación, las llamadas pueden completarse correctamente pero no devolver resultados.
</Note>

## 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.

| Característica de la API de consulta                                    | [b2bLicensePreview (v8)](/reference/microsoft-store-apis/xstore-v8-query-for-products) | [publisherQuery (v9)](/reference/microsoft-store-apis/xstore-v9-query-for-products) |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Ver el estado de la suscripción a XBOX Game Pass de un usuario          | No                                                                                     | Sí                                                                                  |
| Autenticación con tokens X                                              | Sí                                                                                     | Sí                                                                                  |
| Autenticación con Microsoft Entra ID / User Store ID                    | Sí                                                                                     | Sí                                                                                  |
| StoreIds de Partner Center                                              | Sí                                                                                     | Sí                                                                                  |
| LegacyProductIds (Product ID de XBOX Inventory / XBOX Developer Portal) | Sí                                                                                     | No                                                                                  |
| Capacidad de desactivar los resultados de derechos satisfactorios       | Sí                                                                                     | No                                                                                  |

<Note>
  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.
</Note>

## 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 matriz `satisfiedByProductIds` 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 como `acquisitionType`, 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)

Si los duplicados proceden de la misma fuente (por ejemplo, períodos de suscripción `Active` y `Expired`), solo se devuelve un artículo (aunque `excludeDuplicates` esté desactivado) usando la siguiente prioridad de estado:

* `Active`
* `Invalid` (si hay varios derechos no válidos, se devolvería el artículo invalidado más recientemente)
* `Revoked`

Los escenarios de duplicados comunes y sus resultados se muestran en la tabla siguiente.

| Escenario                                                                                            | `excludeDuplicates: false`                                | `excludeDuplicates: true`                             |
| ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ----------------------------------------------------- |
| Compra directa + derecho de agrupación                                                               | Pueden aparecer ambos artículos.                          | Se devuelve el artículo de compra directa.            |
| Compra directa + derecho de Game Pass                                                                | Pueden aparecer ambos artículos (`Single` y `Recurring`). | Se devuelve el artículo de compra directa.            |
| Misma fuente de derechos con varios períodos (por ejemplo, períodos de suscripción Active + Expired) | Se devuelve un artículo según la prioridad de estado.     | Se devuelve un artículo según la prioridad de estado. |

### 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. Si `excludeDuplicates` es true, solo se devuelve la entrada de la compra directa.

## Documentación de referencia de la API

* [XStore (contenido de la API)](/reference/system/xstore/xstore_members)

## Consulte también

[Información general sobre comercio](/publishing/xstore-commerce/xstore-commerce-overview)

[Administración de productos desde sus servicios](/publishing/xstore-commerce/xstore-authenticating-service)

[Referencia de la API de XStore](/reference/system/xstore/xstore_members)


## Related topics

- [Uso en el cliente de los privilegios de usuario de los servicios XBOX](/es/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
- [Información general sobre los privilegios de usuario de los servicios XBOX](/es/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview.md)
- [Gestión en el servidor de los privilegios de usuario de los servicios XBOX](/es/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-server.md)
- [Administración de productos de suscripción desde su servicio](/es/publishing/xstore-commerce/xstore-managing-subscriptions.md)
- [Detección del acceso a la suscripción a XBOX Game Pass desde su servicio](/es/publishing/xstore-commerce/xstore-detecting-game-pass.md)