# Obter lista de jogos por grupo especificado

Recebe uma lista de jogos do grupo especificado 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. Para obter mais dados página por página, use os campos limit e offset.  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/game/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)
    Example: [{"attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"description":"Game description","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","promotions":[],"sku":"com.xsolla.game_1","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_free":false,"is_pre_order":true,"periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":"2020-08-11T10:00:00+03:00","sku":"com.xsolla.game_key_01","type":"game_key","virtual_prices":[]},{"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.game_key_02","type":"game_key","virtual_prices":[]}],"unit_type":"game"},{"attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"description":"Game description","groups":[{"external_id":"all","name":"All games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","promotions":[],"sku":"com.xsolla.game_2","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.game_key_01","type":"game_key","virtual_prices":[]}],"unit_type":"game"}]

  - `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.description` (string)
    Descrição do item.
    Example: "Game description"

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

  - `items.groups.external_id` (string)
    Um identificador exclusivo para o grupo, normalmente usado para referenciá-lo em solicitações de API ou sistemas externos.
    Example: "exclusive"

  - `items.groups.item_order_in_group` (integer)
    A posição do item dentro do grupo, usada para determinar sua ordem de exibição.
Este campo é incluído na resposta somente se solicitado por meio do parâmetro de consulta additional_fields[].
    Example: 1

  - `items.groups.name` (string)
    Nome do grupo.
    Example: "Exclusive"

  - `items.image_url` (string)
    URL da imagem.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `items.name` (string)
    Nome do item.
    Example: "Game name"

  - `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: "game_01"

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

  - `items.unit_items` (array)

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

  - `items.unit_items.drm_name` (string)
    Nome do DRM.
    Example: "Steam"

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

  - `items.unit_items.has_keys` (boolean)
    Se true, a chave de jogo tem chaves para venda.

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

  - `items.unit_items.is_pre_order` (boolean)
    Se true, a chave do jogo é uma pré-venda e a data de lançamento não foi passada.
    Example: true

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

  - `items.unit_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.unit_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.unit_items.price` (object)
    Preços dos itens.

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

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

  - `items.unit_items.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).
    Example: "USD"

  - `items.unit_items.release_date` (string,null)
    Data de lançamento da chave de jogo no formato ISO 8601.
    Example: "2020-08-11T10:00:00+03:00"

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

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

  - `items.unit_items.virtual_prices.amount` (integer)
    Preço do item com desconto em moeda virtual.
    Example: 100

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

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

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

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

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

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

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

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

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

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

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

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

  - `items.unit_type` (string)
    Tipo de unidade: game.
    Example: "game"