> ## 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. # Detección del acceso a la suscripción a XBOX Game Pass desde su servicio > Detecte el estado de la suscripción a XBOX Game Pass desde su servicio mediante la API publisherQuery de colecciones y conceda recompensas a los suscriptores activos. Si su título participa en Game Pass, su servicio puede usar la [API collections.mp.microsoft.com/v9.0/collections/publisherQuery](/reference/microsoft-store-apis/xstore-v9-query-for-products) para verificar el estado de suscriptor activo y conceder recompensas y ventajas en el juego. Antes de consultar el estado de Game Pass, su publicador debe estar autorizado para los niveles que desee comprobar. Solicite esta autorización a través de su Developer Partner Manager o su contacto de Microsoft. ## Licencias de Game Pass en las comprobaciones de licencia del cliente Los derechos de Game Pass no se pueden detectar desde el cliente del juego. Cuando un usuario tiene derecho a su título a través de Game Pass, [XStoreQueryGameLicenseAsync](/reference/system/xstore/functions/xstorequerygamelicenseasync) devuelve una licencia con `isActive = true`, igual que una compra directa. La estructura [XStoreGameLicense](/reference/system/xstore/structs/xstoregamelicense) no incluye un campo que identifique cómo se adquirió la licencia. Para registrar cómo adquirieron los usuarios su título, por ejemplo con fines de telemetría, envíe la identidad del usuario desde el cliente a su propio servicio. A continuación, su servicio llama a la API publisherQuery y comprueba `acquisitionType`. Un valor de `Recurring` indica un derecho a través de Game Pass y `Single` indica propiedad directa. ## Comportamiento de los datos de respuesta para publicadores autorizados y no autorizados Si su publicador no está autorizado, los artículos con derecho a través de Game Pass aparecen como derechos de propiedad directa. Por ejemplo, `acquisitionType` aparece como `Single` y los ProductIds de Game Pass no aparecen en `satisfiedByProductIds`. Para los publicadores autorizados, solo se devuelven las suscripciones activas a Game Pass. Si la suscripción a Game Pass del usuario se cancela o finaliza, las consultas posteriores dejarán de contener la información de Game Pass. Además, `EndDate` se normaliza al valor máximo, por lo que no se puede usar para detectar el final de la suscripción. ## Retraso el día del lanzamiento en Game Pass en los resultados de derechos de servidor a servidor Cuando los títulos o complementos se publican en Game Pass, prevea un retraso entre la disponibilidad en el cliente y la visibilidad en `publisherQuery`. Este comportamiento se debe a los distintos intervalos de actualización de las cachés en los sistemas de la tienda. En la práctica, las licencias locales suelen actualizarse primero, y publisherQuery puede retrasarse entre dos y tres horas. Las comprobaciones directas de los ProductIds de Game Pass no se ven afectadas; el retraso afecta principalmente a los artículos concedidos mediante derechos satisfechos. ## Pruebas de suscripciones a Game Pass en su sandbox de desarrollo Los niveles de XBOX Game Pass deben estar habilitados y ser accesibles buscándolos en la aplicación XBOX Store dentro de su sandbox de desarrollo. Las cuentas de prueba de XBOX se crean con una tarjeta de crédito de prueba y podrán suscribirse a los niveles de Game Pass en su sandbox. Si no puede encontrar los niveles de Game Pass en su sandbox, póngase en contacto con su Developer Partner Manager o su contacto de Microsoft para obtener ayuda. El estado de la suscripción a Game Pass no se conserva entre sandboxes. Al agregar Game Pass a una cuenta de prueba en un sandbox, no mueva esa cuenta de prueba a otro sandbox para pruebas o depuración de Game Pass u otras funciones relacionadas con el comercio. ## Solicitud del estado de la suscripción a Game Pass Para solicitar el estado de la suscripción a Game Pass del usuario, agregue los ProductIds correspondientes a los niveles de suscripción que está autorizado a ver en la lista productSkuIds de la solicitud de consulta (consulte la tabla). | Nivel de suscripción | ProductID | | ------------------------------------- | ------------ | | XBOX Game Pass for Console (retirado) | CFQ7TTC0K6L8 | | XBOX Game Pass (Starter Edition) | CFQ7TTC10QFD | | PC Game Pass | CFQ7TTC0KGQ8 | | XBOX Game Pass Essential | CFQ7TTC0K5DJ | | XBOX Game Pass Premium | CFQ7TTC0P85B | | XBOX Game Pass Ultimate | CFQ7TTC0KHS0 | Si el usuario tiene una suscripción en el nivel que solicitó, la respuesta de la consulta incluye un artículo con el ProductId del nivel de suscripción a Game Pass correspondiente. ### Comportamiento al solicitar niveles incluidos en niveles superiores Algunos niveles de Game Pass están incluidos cuando un suscriptor tiene un nivel superior. Cualquiera de sus niveles autorizados que esté incluido en niveles superiores se devuelve cuando el usuario está suscrito al nivel superior. Ejemplo: nuestro publicador está autorizado para XBOX Game Pass Essential. El usuario tiene XBOX Game Pass Ultimate y, cuando consulta todos los ProductIds de Game Pass, publisherQuery solo devuelve un resultado para XBOX Game Pass Essential. Si su publicador tiene acceso para ver alguno de los otros niveles, esos niveles también se devolverían. XBOX Game Pass (Starter Edition) es una excepción a la herencia y es un nivel independiente. No está incluido en ninguno de los otros niveles. ### Concesión de ventajas en el juego a los suscriptores de Game Pass Se recomienda solicitar acceso al nivel más bajo de Game Pass necesario para conceder ventajas y beneficios en el juego a los suscriptores. Ejemplo: va a conceder una recompensa en el juego a todos los suscriptores de Game Pass en la consola. Solo necesita acceso a XBOX Game Pass Essential (CFQ7TTC0K5DJ) porque Premium y Ultimate incluyen Essential. ### Detección de productos con derecho a través de una suscripción a Game Pass con satisfiedByProductIds Después de la autorización, identifique los derechos derivados de Game Pass comprobando los valores `satisfiedByProductIds` y `acquisitionType`. Un derecho basado en Game Pass tiene un `acquisitionType` de tipo `Recurring`, y `satisfiedByProductIds` incluirá el ProductID del nivel más alto de Game Pass para el que está autorizado. Si usa la opción de filtro excludeDuplicates, el derecho relacionado con Game Pass se filtra si el usuario posee el título directamente. Comprobar los productIDs de Game Pass en `satisfiedByProductIds` de un artículo le indicará si el artículo tiene derecho a través de Game Pass, pero no es suficiente para determinar si el usuario es miembro de Game Pass. Por lo tanto, al comprobar el estado de la suscripción a Game Pass de un usuario, es mejor incluir los valores de ProductId de Game Pass en el campo `productSkuIds` de su solicitud. ### Ejemplo de artículo duplicado con XBOX Game Pass Si el usuario tiene tanto la propiedad directa como el derecho a través de Game Pass para el mismo producto, pueden aparecer dos entradas cuando `excludeDuplicates` es `false`. Cuando `excludeDuplicates` es `true`, se devuelve el artículo de compra directa. Para conocer todas las reglas de resolución de duplicados y el comportamiento de prioridad de origen, consulte [Descripción de los artículos duplicados en la respuesta](/publishing/xstore-commerce/xstore-query-entitlements#understanding-duplicate-items-in-the-response). ### Ejemplo de solicitud del estado de la suscripción a XBOX Game Pass Essential ```json theme={null} POST https://collections.mp.microsoft.com/v9.0/collections/publisherQuery HTTP/1.1 {authorization header} User-Agent: {identifier string of your service} Content-Type: application/json; Host: collections.mp.microsoft.com { "maxPageSize": 100, "excludeDuplicates": true, "validityType": "All", "productSkuIds": [ {"productId": "CFQ7TTC0K5DJ"} ], "beneficiaries": [ { "identitytype": "b2b", "identityValue": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjYxNTI2OEI4N0YwNEFDQzIzRDdCQ0E2M...", "localTicketReference": "" } ], "sbx":"RETAIL" } ``` ### Ejemplo de respuesta para XBOX Game Pass Essential ```json theme={null} HTTP/1.1 200 OK Date: Mon, 18 May 2026 18:40:32 GMT Content-Type: application/json; charset=utf-8 Server: Kestrel Content-Length: 602 MS-CorrelationId: 5ec99421-7fa8-457e-87c1-edf16297528e MS-RequestId: a604aca2-f60d-4de5-993f-125a57dcabdd MS-CV: pjtLxeR5BUOY5n.0 X-Content-Type-Options: nosniff { "items": [ { "acquiredDate": "2026-05-15T18:29:24.2131463+00:00", "acquisitionType": "Recurring", "endDate": "9999-12-31T23:59:59.9999999+00:00", "id": "a1702e2c6cff4e0095b3c51d06d9fac9", "modifiedDate": "2026-05-15T18:29:24.2153924+00:00", "productId": "CFQ7TTC0K5DJ", "productKind": "Pass", "quantity": 1, "recurrenceData": "mdr:0:9ee54c66dc2a49ca81bd2c3eaf148826:a118bfe9-8175-4407-9d14-b2be4af30acd", "satisfiedByProductIds": [], "skuId": "", "startDate": "2026-05-15T00:00:00+00:00", "status": "Active", "tags": [], "transactionId": "a118bfe9-8175-4407-9d14-b2be4af30acd", "trialData": { "isInTrialPeriod": false, "isTrial": false } } ] } ``` ### Ejemplo de solicitud de un juego con derecho a través de la suscripción a Game Pass Essential ```json theme={null} POST https://collections.mp.microsoft.com/v9.0/collections/publisherQuery HTTP/1.1 {authorization header} User-Agent: {identifier string of your service} Content-Type: application/json; Host: collections.mp.microsoft.com { "maxPageSize": 100, "excludeDuplicates": true, "validityType": "All", "productSkuIds": [ {"productId": "9NTL0QDWZ4FS"} ], "beneficiaries": [ { "identitytype": "b2b", "identityValue": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjYxNTI2OEI4N0YwNEFDQzIzRDdCQ0E2M...", "localTicketReference": "" } ], "sbx":"RETAIL" } ``` ### Ejemplo de respuesta de un juego con derecho a través de la suscripción a Game Pass Essential ```json theme={null} HTTP/1.1 200 OK Date: Mon, 18 May 2026 18:41:18 GMT Content-Type: application/json; charset=utf-8 Server: Kestrel Content-Length: 602 MS-CorrelationId: d4c6dd08-a80a-4098-9433-757864d3716d MS-RequestId: 6de32c62-9690-46dc-81c3-d1fef9df10a5 MS-CV: IvL+PCZ9Jk2+C4Xo.0 X-Content-Type-Options: nosniff { "items": [ { "acquiredDate": "2026-05-15T18:29:24.2131463+00:00", "acquisitionType": "Recurring", "endDate": "9999-12-31T23:59:59.9999999+00:00", "id": "a1702e2c6cff4e0095b3c51d06d9fac9", "modifiedDate": "2026-05-15T18:29:24.2153924+00:00", "productId": "9NTL0QDWZ4FS", "productKind": "Game", "quantity": 1, "satisfiedByProductIds": [ "CFQ7TTC0K5DJ" ], "skuId": "0010", "startDate": "2026-05-15T00:00:00+00:00", "status": "Active", "tags": [], "transactionId": "a118bfe9-8175-4407-9d14-b2be4af30acd", "trialData": { "isInTrialPeriod": false, "isTrial": false } } ] } ``` ## Consulte también [Información general sobre comercio](/publishing/xstore-commerce/xstore-commerce-overview) [Referencia de la API de XStore](/reference/system/xstore/xstore_members) ## Related topics - [collections.mp.microsoft.com/v9.0/collections/publisherQuery](/es/reference/microsoft-store-apis/xstore-v9-query-for-products.md) - [DRM básico y comprobaciones de licencia](/es/publishing/xstore-commerce/xstore-basic-drm.md) - [Concesión de acceso a los jugadores al contenido de complemento](/es/publishing/xstore-commerce/xstore-granting-access.md) - [Administración de productos de suscripción desde su servicio](/es/publishing/xstore-commerce/xstore-managing-subscriptions.md) - [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)