# Obtener lista de juegos (admin)

Obtiene la lista de juegos dentro de un proyecto para su administración.
El juego se compone de claves del juego que podrían ser compradas por un usuario.

NotaNo utilice este punto final para crear un catálogo de tienda.

Endpoint: GET /v2/project/{project_id}/admin/items/game
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

  - `promo_code` (string)
    Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.
    Example: "WINTER2021"

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Se utiliza como indicador de que hay más páginas.

  - `total_items_count` (integer)
    Número total de artículos en el sistema.

  - `items` (array)

  - `items.item_id` (integer)
    ID único interno del artículo que se proporciona al crearlo.
    Example: 1

  - `items.sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "game_1"

  - `items.type` (string)
    Tipo de artículo. En este caso es siempre unit.
    Example: "unit"

  - `items.name` (object,null)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de idioma de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.description` (object,null)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.long_description` (object,null)
    Objeto con traducciones para la descripción larga del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.image_url` (string)
    URL de la imagen.
    Example: "https://image.example.com"

  - `items.media_list` (array)
    Recursos adicionales del juego, como capturas de pantalla, vídeos de partidas del juego, etc.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Tipo de soporte multimedia: image/video.
    Enum: "image", "video"

  - `items.media_list.url` (string)
    Archivo de recurso.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `items.is_enabled` (boolean)
    Si se deshabilita, el artículo no se puede comprar ni se puede acceder a este a través del inventario.

  - `items.is_show_in_store` (boolean)
    El artículo está disponible para la compra.

  - `items.order` (integer)
    Prioridad de orden del juego en la lista.
    Example: 1

  - `items.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.groups.external_id` (string)
    Example: "horror"

  - `items.groups.name` (object)
    Example: {"en":"Horror"}

  - `items.attributes` (array)
    Lista de atributos.
    Example: [{"external_id":"attribute_external_id","name":{"en":"Attribute name","de":"Attributname"},"values":[{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]}]

  - `items.attributes.external_id` (string, required)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.
    Example: "attribute_external_id"

  - `items.attributes.name` (object)
    Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.
    Example: {"en":"Attribute name","de":"Attributname"}

  - `items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]

  - `items.attributes.values.external_id` (string, required)
    ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    Example: "value_external_id"

  - `items.attributes.values.value` (object, required)
    Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

  - `items.is_free` (boolean)
    Si el artículo es gratuito.

  - `items.unit_items` (array)
    Claves del juego para diferentes DRM (gestión de derechos digitales).

  - `items.unit_items.item_id` (integer)
    ID único interno del artículo que se proporciona al crearlo.
    Example: 1

  - `items.unit_items.sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "game_1"

  - `items.unit_items.type` (string)
    Tipo de artículo. En este caso es siempre game_key.
    Example: "game_key"

  - `items.unit_items.is_free` (boolean)
    Si el artículo es gratuito.

  - `items.unit_items.prices` (array)
    Precios en monedas reales.
    Example: [{"amount":1299.99,"currency":"RUB","is_default":true,"is_enabled":true}]

  - `items.unit_items.prices.amount` (number)
    Example: 1299.99

  - `items.unit_items.prices.currency` (string)
    Divisa del precio del artículo. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "RUB"

  - `items.unit_items.prices.is_default` (boolean)
    El precio por defecto se utiliza para generar el catálogo si no se especifica el precio en la moneda del usuario.

  - `items.unit_items.prices.is_enabled` (boolean)

  - `items.unit_items.prices.country_iso` (string,null)
    País en el que está disponible este precio. Código de dos letras según la norma [ISO 3166-1 alfa 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `items.unit_items.virtual_prices` (array,null)
    Example: [{"sku":"com.xsolla.gold_1","name":{"en":"Gold"},"type":"virtual_currency","description":null,"image_url":"https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png","amount":1000,"is_default":true}]

  - `items.unit_items.virtual_prices.sku` (string)
    ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "gold"

  - `items.unit_items.virtual_prices.name` (object)
    Objeto con traducciones para el nombre de la moneda virtual. Las claves se especifican en la norma ISO 3166-1.
    Example: {"en":"Gold"}

  - `items.unit_items.virtual_prices.type` (string)
    Tipo de artículo. En este caso es siempre virtual_currency.
    Example: "virtual_currency"

  - `items.unit_items.virtual_prices.description` (object,null)
    Objeto con traducciones para la descripción del juego. Las claves se especifican en la norma ISO 3166-1.
    Example: {"en":"Game 1 Example"}

  - `items.unit_items.virtual_prices.image_url` (string)
    URL de la imagen.
    Example: "https://image.example.com"

  - `items.unit_items.virtual_prices.amount` (number)

  - `items.unit_items.virtual_prices.is_default` (boolean)

  - `items.unit_items.order` (integer)
    Prioridad de orden del juego en la lista.
    Example: 1

  - `items.unit_items.is_enabled` (boolean)
    Si se deshabilita, el artículo no se puede comprar ni se puede acceder a este a través del inventario.

  - `items.unit_items.is_show_in_store` (boolean)
    El artículo está disponible para la compra.

  - `items.unit_items.drm_name` (string)
    Nombre del DRM de la clave del juego.
    Example: "Steam"

  - `items.unit_items.drm_sku` (string)
    ID único del DRM.
    Example: "steam"

  - `items.unit_items.drm_image` (string,null)
    Icono del DRM de clave del juego.
    Example: "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png"

  - `items.unit_items.drm_id` (integer)
    ID único interno de DRM.
    Example: 1

  - `items.unit_items.keys` (object)

  - `items.unit_items.keys.available` (integer)
    Número de claves disponibles para la compra.

  - `items.unit_items.keys.total` (integer)
    Número total de claves cargadas.

  - `items.unit_items.keys.used` (integer)
    Número de claves vendidas.

  - `items.unit_items.is_sales_exist` (boolean)
    Si es true, la clave del juego fue comprada por los usuarios.

  - `items.unit_items.pre_order` (object)
    Configuración del pedido por anticipado.

  - `items.unit_items.pre_order.release_date` (string,null)
    Fecha de lanzamiento de la clave del juego en formato ISO 8601.

  - `items.unit_items.pre_order.is_enabled` (boolean)
    Si está deshabilitada, el artículo no es un pedido por anticipado.

  - `items.unit_items.pre_order.description` (string,null)
    Información adicional para el pedido por anticipado que se enviará por correo electrónico.

  - `items.unit_items.regions` (array)

  - `items.unit_items.regions.id` (integer)
    Example: 1

  - `items.unit_items.limits` (object,null)
    Límites del artículo.

  - `items.unit_items.limits.per_user` (object,null)
    Limitación de artículos para un usuario independiente.

  - `items.unit_items.limits.per_user.total` (integer)
    Número máximo de artículos que un mismo usuario puede comprar.

  - `items.unit_items.limits.per_user.limit_exceeded_visibility` (string)
    Determina la visibilidad del artículo en el catálogo tras alcanzar el límite de compra, hasta el siguiente restablecimiento del límite.

Se aplica a los artículos para los que se han configurado restablecimientos periódicos del límite en la matriz recurrent_schedule.

Si no están configurados los restablecimientos del límite, el artículo no aparecerá en el catálogo cuando se haya alcanzado el límite de compra,
 independientemente del valor de limit_exceeded_visibility.

Valores posibles:
- show — El artículo se devuelve en las llamadas API de recuperación del catálogo tras alcanzar el límite de compra. En las llamadas API
de recuperación del catálogo en el lado del cliente, tras alcanzar el límite, el artículo se devuelve con el indicador can_be_bought: false. La
La próxima fecha de restablecimiento se devuelve el día reset_next_date.
- hide — El artículo no se devuelve en las llamadas API de recuperación del catálogo tras alcanzar el límite de compra, hasta que
 se restablezca ese límite.
    Enum: "show", "hide"

  - `items.unit_items.limits.per_item` (object,null)
    Limitación global de artículos.

  - `items.unit_items.limits.per_item.total` (integer)
    Número máximo de artículos que pueden comprar todos los usuarios.

  - `items.unit_items.limits.per_item.available` (integer)
    Número restante de artículos que todos los usuarios pueden comprar.

  - `items.unit_items.limits.per_item.reserved` (integer)

  - `items.unit_items.limits.per_item.sold` (integer)

  - `items.unit_items.limits.recurrent_schedule` (object,null)
    Periodo de actualización del límite.

  - `items.unit_items.limits.recurrent_schedule.per_user` (any)
    Periodo de actualización del límite del usuario.

  - `items.unit_items.periods` (array)
    Periodo de venta del artículo.

  - `items.unit_items.periods.date_from` (string,null)
    Fecha en la que el artículo especificado estará disponible para la venta.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.unit_items.periods.date_until` (string,null)
    Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser null.
    Example: "2020-08-11T20:00:00+03:00"

  - `items.unit_items.name` (object,null)
    Objeto con traducciones para la descripción del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de idioma de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.unit_items.attributes` (array)
    Lista de atributos.
    Example: [{"external_id":"attribute_external_id","name":{"en":"Attribute name","de":"Attributname"},"values":[{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]}]

  - `items.unit_items.attributes.external_id` (string, required)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, guiones y guiones bajos.
    Example: "attribute_external_id"

  - `items.unit_items.attributes.name` (object)
    Objeto con traducciones para el nombre del atributo. Las claves se especifican en la norma ISO 3166-1.
    Example: {"en":"Attribute name","de":"Attributname"}

  - `items.unit_items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"en":"value 1","de":"wert 1"}},{"external_id":"value_2","name":{"en":"value 2","de":"wert 2"}}]

  - `items.unit_items.attributes.values.external_id` (string, required)
    ID del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas, guiones y guiones bajos.
    Example: "value_external_id"

  - `items.unit_items.attributes.values.value` (object, required)
    Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.

  - `items.unit_items.long_description` (object,null)
    Objeto con traducciones para la descripción larga del artículo. Acepta valores en uno de estos dos formatos: códigos de idioma de dos letras en minúscula (p. ej., en) o códigos de configuración regional de cinco caracteres (p. ej., en-US). Aunque ambos formatos se aceptan como entradas, las respuestas devuelven códigos de idioma de dos letras en minúscula. Cuando se facilitan ambas opciones para el mismo idioma (p. ej. en y en-US), se almacena el último valor proporcionado. Puede consultar la lista completa de idiomas admitidos en la [documentación](/es/doc/shop-builder/references/supported-languages/).

  - `items.unit_items.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

  - `items.unit_items.groups.external_id` (string)
    Example: "horror"

  - `items.unit_items.groups.name` (object)
    Example: {"en":"Horror"}

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"