# Obtener la lista de artículos virtuales por ID del grupo especificado

Obtiene la lista de artículos virtuales de un grupo para su administración.

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

Endpoint: GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}
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.
    Example: 44056

  - `group_id` (integer, required)
    ID del grupo.
    Example: 10

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

## Response 200 fields (application/json):

  - `items` (array)

  - `items.attributes` (array)
    Lista de atributos.
    Example: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 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_1"

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

  - `items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 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: "attribute_value"

  - `items.attributes.values.value` (object, required)
    Objeto con traducciones del nombre del valor. Las claves se especifican en la norma ISO 3166-1.
    Example: {"de":"Strategie","en":"Strategy"}

  - `items.custom_attributes` (object)
    Un objeto JSON que contiene los atributos y valores del artículo.

  - `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.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)
    Nombre del artículo. Debe contener pares clave/valor
en los cuales clave es una configuración regional con formato "^[a-z]{2}", valor es una cadena (string).
    Example: {"de":"Horror","en":"Horror"}

  - `items.image_url` (string)

  - `items.is_enabled` (boolean)

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

  - `items.is_show_in_store` (boolean)

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

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

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

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

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

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

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

  - `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 se han configurado restablecimientos de límite, el artículo no aparecerá en el catálogo una vez alcanzado el límite de compra, independientemente del valor de limit_exceeded_visibility.
    Enum: "show", "hide"

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

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

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

  - `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.media_list` (array)
    Recursos adicionales del artículo 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.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.order` (integer)
    Define el orden de disposición.
    Example: 1

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

  - `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.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.prices` (array)
    Example: [{"amount":10.5,"currency":"USD","is_default":true,"is_enabled":true}]

  - `items.prices.amount` (number, required)
    Importe.
    Example: 10.5

  - `items.prices.country_iso` (string)
    Código de país de dos letras mayúsculas de conformidad con la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Consulte la documentación para obtener información detallada sobre los [países admitidos por Xsolla](https://developers.xsolla.com/es/doc/shop-builder/references/supported-countries/). Ejemplo: country=US
    Example: "US"

  - `items.prices.currency` (string, required)
    Divisa del precio del artículo. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte la documentación para obtener información detallada sobre [monedas soportadas por Xsolla](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items.prices.is_default` (boolean)
    Example: true

  - `items.regions` (array)

  - `items.regions.id` (integer)
    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: "booster_mega_1"

  - `items.type` (string)
    Tipo de artículo: virtual_good/virtual_currency/bundle/physical_good/unit.

  - `items.vc_prices` (array)
    Example: [{"amount":10,"is_default":true,"sku":"com.xsolla.gold_1"}]

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401