GET (/users/me/inventory)

Proporciona al autor de la llamada el conjunto de inventario asociado actualmente al usuario proporcionado. El dominio de estos URI es inventory.xboxlive.com.

Comentarios
Parámetros de cadena de consulta
Ejemplo de solicitud
Cuerpo de la respuesta

Comentarios

No se realizará ninguna comprobación de directivas, aplicación ni filtrado como parte de esta llamada. Los autores de la llamada tienen la opción de pasar parámetros de consulta para restringir el ámbito de los resultados devueltos. Los autores de la llamada pueden paginar los resultados con un token de continuación proporcionado en una respuesta anterior: /users/me/inventory?continuationToken=continuationTokenString. El autor de la llamada puede realizar una llamada a la API de detalles con una dirección URL de elemento específica para ver información sobre un elemento específico.

Parámetros de cadena de consulta

Parámetro	Tipo	Descripción
availability	string	La disponibilidad actual de los elementos que se van a devolver. El valor predeterminado es “Available”, que devuelve los elementos para los que la fecha actual se encuentra entre la fecha de inicio y la fecha de finalización. Otros valores son “All”, que devuelve todos los elementos, y “Unavailable”, que devuelve los elementos para los que la fecha actual queda fuera del intervalo entre la fecha de inicio y la fecha de finalización y, por lo tanto, no están disponibles actualmente.
container	string	Opcional. Si establece el valor en el Id. de producto de un juego, los resultados del inventario solo incluirán los elementos relacionados con ese juego. Esto resulta especialmente útil al llamar al inventario desde el servidor para filtrar los resultados a los productos de un juego específico.
expandSatisfyingEntitlements	string	Marca que indica si la respuesta incluye en los resultados devueltos todos los derechos satisfactorios que tiene el usuario. El valor predeterminado es “false”. Cuando este parámetro se usa con un valor de “true”, cualquier producto concedido al usuario mediante derechos satisfactorios, como elementos agrupados, compras de XBOX 360 migradas a XBOX One, ventajas de suscripción, etc., se agrega a los resultados. Cuando este valor es “false”, solo se devuelven en los resultados los elementos primarios, como el ProductID del paquete, y no los elementos individuales incluidos. Nota: El uso de este parámetro con un valor de “true” solo se admite si el parámetro itemType no se incluye en el URI; de lo contrario, recibirá un error HTTP 400.
productIds	string	Colección de ProductIds que desea recuperar específicamente del inventario del usuario, separados por ’,’. Si el usuario no tiene un ProductID proporcionado en los resultados de su inventario, ese elemento no aparecerá en los resultados de la llamada a la API. Si pasa el productID de un paquete junto con el parámetro expandSatisfyingEntitlements establecido en true, todos los elementos incluidos en el paquete se devuelven en los resultados de la llamada (tanto si especificó sus productIds en la cadena de consulta como si no).
state	string	El estado de los elementos que se van a devolver. El valor predeterminado es “all”, que devuelve todos los elementos. Otros valores son “Enabled”, que indica que solo se deben devolver los elementos habilitados; “Suspended”, que indica que solo se deben devolver los elementos suspendidos; “Expired”, que indica que solo se deben devolver los elementos que hayan expirado; “Cancelled”, que indica que solo se deben devolver los elementos cancelados; y “Renewed”, que indica que solo se deben devolver los elementos que se hayan renovado.

Además de estos, el recurso admite los mecanismos de paginación estándar.

Ejemplo de solicitud

El nombre de dominio completo para este método de URI es https://inventory.xboxlive.com/users/me/inventory.

Nota:
Los usuarios que se tienen en cuenta dependen del token proporcionado, que puede incluir varios usuarios. Si desea el inventario de un único usuario, también debe proporcionar el hash de usuario del usuario específico que desea considerar de forma exclusiva.

Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devuelve una matriz de elementos de inventario. Consulte inventoryItem (JSON).

Ejemplo de respuesta

{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

Consulte también

Elemento primario

/users/me/inventory

Información adicional

Encabezados comunes de EDS Parámetros de EDS Refinadores de consulta de EDS URI de Marketplace Referencia adicional

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

GET (/users/me/inventory)

GET (/users/me/inventory)

Comentarios

Parámetros de cadena de consulta

Ejemplo de solicitud

Cuerpo de la respuesta

Ejemplo de respuesta

Consulte también

Elemento primario

Información adicional

​GET (/users/me/inventory)

​Comentarios

​Parámetros de cadena de consulta

​Ejemplo de solicitud

​Cuerpo de la respuesta

​Ejemplo de respuesta

​Consulte también

Elemento primario

Información adicional

GET (/users/me/inventory)

Comentarios

Parámetros de cadena de consulta

Ejemplo de solicitud

Cuerpo de la respuesta

Ejemplo de respuesta

Consulte también