# Obter lista de jogos por grupo especificado

Obtém uma lista de jogos do grupo especificado para criar um catálogo.

Atenção. Todos os projetos têm uma limitação no número de itens que você pode obter 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.

Endpoint: GET /v2/project/{project_id}/items/game/group/{external_id}
Version: 1.0.0
Security: AuthForClient

## Path parameters:

  - `project_id` (integer, required)
    ID do Projeto.
    Example: 44056

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

## Query parameters:

  - `limit` (integer)
    Limite para o número de elementos na página.
    Example: 50

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

  - `locale` (string)
    Idioma 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. Campos disponíveis media_list, order, long_description.

  - `country` (string)
    País para calcular preços regionais e restrições de catálogos. Código de país maiúsculo de duas letras de acordo com o padrão ISO 3166-1 alpha-2. Se você não especificar o país explicitamente, ele será calculado com base no endereço IP do usuário.

## Response 200 fields (application/json):

  - `items` (array)
    Example: [{"attributes":{"$ref":"#/components/examples/client-attribute-game/Catalog_value"},"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","sku":"game_1","type":"unit","unit_items":[{"drm_name":"Steam","drm_sku":"steam","has_keys":true,"is_free":false,"is_pre_order":true,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"release_date":"2020-08-11T10:00:00+03:00","sku":"game_key_01","type":"game_key","virtual_prices":[]},{"drm_name":"Origin","drm_sku":"origin","has_keys":false,"is_free":false,"is_pre_order":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"sku":"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","sku":"game_2","type":"unit","unit_items":[{"drm_name":"Steam","drm_sku":"steam","has_keys":false,"is_free":false,"is_pre_order":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"sku":"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 filtrar catálogos.

  - `items.attributes.external_id` (string)
    ID de atributo exclusivo. O external_id pode conter apenas caracteres alfanuméricos latinos minú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)
    Grupos aos quais o item pertence.
    Example: [{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla game"}]

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

  - `items.groups.name` (string)
    Example: "Accessory"

  - `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.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minú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.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, 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 de jogo é do tipo pré-venda e a data de lançamento não foi passada.
    Example: true

  - `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 de compra padrão. Código de três letras de acordo com o padrão [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.unit_items.release_date` (string)
    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 moedas virtuais.
    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 ou não.
    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 do item de moeda virtual.
    Example: "vc_test"

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

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