# Obter grupo de itens por ID externo

Recupera um grupo de itens por seu ID externo para fins administrativos.

ObservaçãoNão use esse ponto de extremidade para criar um catálogo de loja. Em vez disso, use o ponto de extremidade do lado do cliente Obter lista de grupos de itens.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (string, required)
    ID de grupo de itens externo especificado durante a criação.
    Example: "weapons"

## Response 200 fields (application/json):

  - `id` (integer, required)
    ID de grupo de itens atribuído pela Xsolla.
    Example: 1

  - `external_id` (string, required)
    ID de grupo de itens externo especificado durante a criação.
    Example: "weapons"

  - `name` (object,null, required)
    Objeto com traduções para a descrição 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 opções 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/).

  - `description` (object,null)
    Objeto com traduções para a descrição 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 opções 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/).

  - `image_url` (string,null)
    URL da imagem do grupo de itens.

  - `order` (integer)
    Ordem de exibição do grupo de itens no catálogo. Quanto maior o valor, mais baixa a posição do grupo na lista. Se os valores forem iguais, os grupos serão organizados por data de criação, com os mais novos sendo exibidos mais alto.

  - `is_enabled` (boolean, required)
    Se o grupo de itens fica ativado no catálogo.

  - `items_count` (integer)
    Número total de itens no grupo.
    Example: 5

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Status de resposta HTTP.

  - `errorCode` (integer)
    Código de erro.

  - `errorMessage` (string)
    Descrição de erro curta.

  - `transactionId` (string)
    ID de solicitação. O ID usado para rastrear e associar entradas de registros a essa solicitação ou operação específica. Esse ID pode ser útil para encontrar problemas, realizar depurações e auditorias.

## Response 404 fields (application/json):

  - `statusCode` (integer)
    Status de resposta HTTP.

  - `errorCode` (integer)
    Código de erro.

  - `errorMessage` (string)
    Descrição de erro curta.

  - `transactionId` (string)
    ID de solicitação. O ID usado para rastrear e associar entradas de registros a essa solicitação ou operação específica. Esse ID pode ser útil para encontrar problemas, realizar depurações e auditorias.

  - `errorMessageExtended` (object,null)
    IDs usados na pesquisa falha.

  - `errorMessageExtended.project_id` (integer)
    ID de projeto usado na solicitação de pesquisa.

  - `errorMessageExtended.external_id_list` (array)
    Lista de grupo external_id utilizada na solicitação de pesquisa.

  - `errorMessageExtended.group_id_list` (array)
    Lista de grupo id utilizada na solicitação de pesquisa.