# Obter lista de pacotes por grupo especificado

Recebe uma lista de conjuntos dentro de um grupo para montar um catálogo.

AtençãoTodos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta.  ObservaçãoO use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização.

Endpoint: GET /v2/project/{project_id}/items/bundle/group/{external_id}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
    Example: 44056

  - `external_id` (string, required)
    ID externo de grupo.

## Query parameters:

  - `limit` (integer)
    Limite da quantidade de elementos na página.
    Example: 50

  - `offset` (integer)
    Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0).

  - `locale` (string)
    Linguagem de resposta. Código de idioma minúsculo de duas letras de acordo com o padrão ISO 639-1.

  - `additional_fields[]` (array)
    A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

  - `country` (string)
    Código de país de duas letras maiúsculas de acordo com o padrão ISO 3166-1 alfa-2. Verifique a documentação para obter informações detalhadas sobre os países suportados pela Xsolla e o processo de determinação do país.
    Example: "US"

  - `promo_code` (string)
    Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Exibe itens de tempo limitado que não estão disponíveis para o usuário. O prazo de validade desses itens não começou ou já expirou.
    Example: 1

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Usado como um indicador de que há mais páginas.
    Example: true

  - `items` (array)

  - `items.attributes` (array)
    Lista de atributos e seus valores correspondentes ao item. Pode ser usado para a filtragem de catálogos.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `items.attributes.external_id` (string)
    ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nome do atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valor do atributo.
    Example: "Strategy"

  - `items.bundle_type` (string)
    Tipo de pacote. Use standard para criar um pacote com itens e especificar os SKUs dos itens incluídos no pacote.
Use partner_side_content para criar um pacote vazio e adicionar itens do seu lado usando um [webhook](https://developers.xsolla.com/pt/webhooks/operation/personalized-partner-catalog/). Esse tipo é usado somente para a [personalização de catálogos no lado do parceiro](https://developers.xsolla.com/pt/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
    Enum: "standard", "partner_side_content"

  - `items.can_be_bought` (boolean)
    Se true, o usuário pode comprar um item.
    Example: true

  - `items.content` (array)
    Conteúdo do pacote de conjuntos.
    Example: [{"attributes":[],"description":"Big Rocket - short description.","groups":[],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","is_free":false,"name":"Big Rocket","price":{"amount":"10.99","amount_without_discount":"10.99","currency":"USD"},"quantity":100,"sku":"com.xsolla.big_rocket_1","type":"virtual_currency"}]

  - `items.content.description` (string)
    Descrição do item.
    Example: "Big Rocket - description"

  - `items.content.groups` (array)
    Grupo aos quais o item pertence.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

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

  - `items.content.groups.name` (object)
    Nome do item. Deve conter pares chave/valor
onde chave é uma localização com o formato "^[a-z]{2}", e o valor é uma cadeia de caracteres.
    Example: {"de":"Horror","en":"Horror"}

  - `items.content.image_url` (string)
    URL da imagem.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

  - `items.content.is_free` (boolean)
    Se true, o item é gratuito.

  - `items.content.limits` (object,null)
    Limites de itens.

  - `items.content.limits.per_item` (object,null)
    Limites de item para um item.

  - `items.content.limits.per_item.available` (integer)
    Quantidade restante de itens que todos os usuários podem comprar.
    Example: 3

  - `items.content.limits.per_item.total` (integer)
    Quantidade máxima de itens que todos os usuários podem comprar.
    Example: 5

  - `items.content.limits.per_user` (object,null)
    Limites de item para um usuário.

  - `items.content.limits.per_user.available` (integer)
    Quantidade restante de itens que o usuário atual pode comprar.
    Example: 3

  - `items.content.limits.per_user.limit_exceeded_visibility` (string)
    Determina a visibilidade do item no catálogo após o limite de compra ser atingido, até o próximo limite ser redefinido.

Aplica-se a itens para os quais redefinições recorrentes de limite estão configurados na matriz recurrent_schedule.

Se as redefinições do limite não forem configuradas, o item não aparece no catálogo após o limite de compra ser atingido, independentemente do valor de limit_exceeded_visibility.
    Enum: "show", "hide"

  - `items.content.limits.per_user.recurrent_schedule` (object)
    O item limita o período de atualização recorrente para um usuário.

  - `items.content.limits.per_user.recurrent_schedule.interval_type` (string)
    Tipo de período de atualização recorrente.
    Enum: "daily", "weekly", "monthly", "hourly"

  - `items.content.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Data e hora em que os limites são redefinidos (Unix Timestamp).
    Example: 1677553200

  - `items.content.limits.per_user.total` (integer)
    Quantidade máxima de itens que o usuário atual pode comprar.
    Example: 5

  - `items.content.name` (string)
    Nome do item.
    Example: "Big Rocket"

  - `items.content.price` (object,null)
    Preços dos itens.

  - `items.content.price.amount` (string)
    Preço do item com desconto.
    Example: "100.99"

  - `items.content.price.amount_without_discount` (string)
    Preço do item.
    Example: "100.99"

  - `items.content.price.currency` (string)
    Moeda do preço do item. Código de três letras de acordo com [a ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consulte a documentação para obter informações detalhadas sobre [as moedas suportadas pelo Xsolla](https://developers.xsolla.com/pt/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items.content.quantity` (integer)
    Quantidade de item em um pacote.
    Example: 250

  - `items.content.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados.
    Example: "com.xsolla.big_rocket_1"

  - `items.content.type` (string)
    Tipo de item: virtual_good/virtual_currency/bundle.
    Example: "virtual_currency"

  - `items.content.virtual_item_type` (string)
    Tipo de item virtual.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

  - `items.content.virtual_prices` (array)
    Preços virtuais.

  - `items.content.virtual_prices.amount` (integer)
    Preço do item em moedas virtuais com desconto.
    Example: 100

  - `items.content.virtual_prices.description` (string)
    Descrição da moeda virtual.
    Example: "Big Rocket - description"

  - `items.content.virtual_prices.image_url` (string)
    Imagem da moeda virtual.
    Example: "http://image.png"

  - `items.content.virtual_prices.is_default` (boolean)
    Se o preço é padrão para um item.
    Example: true

  - `items.content.virtual_prices.name` (string)
    Nome da moeda virtual.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.content.virtual_prices.sku` (string)
    SKU da moeda virtual.
    Example: "vc_test"

  - `items.content.virtual_prices.type` (string)
    Tipo de moeda virtual.
    Example: "virtual_currency"

  - `items.custom_attributes` (object)
    Um objeto JSON que contém atributos e valores de item.

  - `items.item_id` (integer)
    ID de item exclusivo interno.
    Example: 1

  - `items.long_description` (object,null)
    Objeto com traduções para a descrição longa do item. Aceita valores em um dos dois formatos: códigos de idioma minúsculos de duas letras (por exemplo, en) ou códigos de localidade de cinco caracteres (por exemplo, en-US). Embora ambos os formatos sejam aceitos, as respostas retornam códigos de idioma minúsculos de duas letras. Quando ambas as variantes para o mesmo idioma são fornecidas (por exemplo, en e en-US), o último valor fornecido é armazenado. Você pode encontrar a lista completa de idiomas suportados na [documentação](/pt/doc/shop-builder/references/supported-languages/).

  - `items.media_list` (array)
    Ativos adicionais do conjunto.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Tipo de mídia: image/video.
    Enum: "image", "video"

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

  - `items.order` (integer)
    Prioridade de pedido do conjunto na lista.
    Example: 1

  - `items.periods` (array,null)
    Período de venda de itens.

  - `items.periods.date_from` (string)
    Data em que o item especificado estará disponível para venda.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.periods.date_until` (string,null)
    Data em que o item especificado ficará indisponível para venda. Pode ser null.
    Example: "2020-08-11T20:00:00+03:00"

  - `items.price` (object,null)
    Preço do item.

  - `items.price.currency` (string, required)
    Moeda do preço do item. Código de três letras de acordo com [a ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.promotions` (array)
    Promoções aplicadas a itens específicos no carrinho. A matriz é retornada nos seguintes casos:

* Uma promoção de desconto é configurada para um item específico.

* Um código promocional com a configuração Desconto em itens selecionados é aplicado.

Se nenhuma promoção no nível do item for aplicada, é retornada uma matriz vazia.

  - `items.promotions.bonus` (array)

  - `items.promotions.bonus.bundle_type` (string)
    Tipo de item de pacote de bônus. Disponível apenas para o tipo de item bônus bundle.
    Enum: "standard", "virtual_currency_package"

  - `items.promotions.bonus.image_url` (string)
    URL da imagem do item bônus. Indisponível para o tipo de item bônus physical_good.

  - `items.promotions.bonus.name` (string)
    Nome do item bônus. Indisponível para o tipo de item bônus physical_good.

  - `items.promotions.bonus.quantity` (integer)

  - `items.promotions.bonus.sku` (string)

  - `items.promotions.bonus.type` (string)
    Tipo de item bônus.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `items.promotions.date_end` (string,null)

  - `items.promotions.date_start` (string,null)

  - `items.promotions.discount` (object,null)

  - `items.promotions.discount.percent` (string,null)

  - `items.promotions.discount.value` (string,null)

  - `items.promotions.limits` (object)

  - `items.promotions.limits.per_user` (object)

  - `items.promotions.limits.per_user.available` (integer)

  - `items.promotions.limits.per_user.total` (integer)

  - `items.promotions.name` (string)

  - `items.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados.
    Example: "bundle_1"

  - `items.total_content_price` (object,null)
    Soma dos preços do conteúdo do conjunto.

  - `items.total_content_price.amount` (string)
    Soma dos preços do conteúdo do conjunto com um desconto.
    Example: "100.99"

  - `items.total_content_price.amount_without_discount` (string)
    Soma dos preços do conteúdo do conjunto.
    Example: "100.99"

  - `items.type` (string)
    Tipo de item.
    Example: "bundle"

  - `items.vp_rewards` (array)
    Recompensa do item de ponto de valor.

  - `items.vp_rewards.amount` (integer)
    Quantidade de pontos de valor.

  - `items.vp_rewards.is_clan` (boolean)
    Se o ponto de valor é usado em cadeias de recompensa de clã ou não.
    Example: true

  - `items.vp_rewards.name` (string)
    Nome do ponto de valor.

  - `items.vp_rewards.sku` (string)
    ID de ponto de valor exclusivo.