# 아이템 그룹 목록 가져오기

페이지 매김 없이 카탈로그를 작성하기 위한 아이템 그룹 목록을 검색합니다.

NoteIn general, the use of catalog of items is available without authorization. Only authorized users can get a personalized catalog.

Endpoint: GET /v2/project/{project_id}/items/groups
Version: 2.0.0

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID. 이 매개 변수는 프로젝트 이름 옆의 관리자 페이지에서 또는 프로젝트 작업 시 브라우저 주소 표시줄에서 확인할 수 있습니다. URL 형식은 다음과 같습니다: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `locale` (string)
    응답 언어. ISO 639-1 표준에 따른 소문자 두 글자 언어 코드(예: en)입니다. name 및 description과 같은 현지화 입력란에서는 다섯 글자 로케일 코드(예: en-US)를 사용할 수 있지만, 응답에서는 두 글자 코드로 정규화됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

  - `with_geo` (boolean)
    응답 헤더에 사용자의 로케일 및 국가 정보를 포함할지 여부입니다. true로 설정하면 응답에 X-User-Locale-Code 및 X-User-Country-Code 헤더가 포함됩니다.

## Response 200 fields (application/json):

  - `groups` (array)
    Example: [{"external_id":"weapons","name":"Weapons","description":"All weapons available in the game","image_url":null,"order":1},{"external_id":"group_external_id","name":"Super","description":"Super description","image_url":null,"order":1}]

  - `groups.external_id` (string)
    외부 그룹 ID입니다.
    Example: "weapons"

  - `groups.name` (string)
    그룹 이름입니다.
    Example: "Weapons"

  - `groups.description` (string)
    그룹 설명입니다.
    Example: "All weapons available in the game"

  - `groups.image_url` (string,null)
    이미지 URL입니다.

  - `groups.order` (integer)
    배열 순서를 정의합니다.
    Example: 1

  - `groups.level` (integer)
    그룹 중첩 수준입니다.

  - `groups.children` (array)
    하위 그룹입니다.
    Example: [{"external_id":"background","name":"Background","description":"Background description","image_url":null,"order":1,"level":1,"children":[{"external_id":"accessory","name":"Accessory","description":"Accessory","image_url":null,"order":1,"level":2,"children":[],"parent_external_id":"background"}],"parent_external_id":"weapons"}]

  - `groups.children.external_id` (string)
    외부 그룹 ID입니다.
    Example: "background"

  - `groups.children.name` (string)
    그룹 이름입니다.
    Example: "Background"

  - `groups.children.description` (string)
    그룹 설명입니다.
    Example: "Background description"

  - `groups.children.image_url` (string,null)
    그룹 이미지 URL입니다.

  - `groups.children.order` (integer)
    배열 순서를 정의합니다.
    Example: 1

  - `groups.children.level` (integer)
    그룹 중첩 수준입니다.
    Example: 1

  - `groups.children.children` (array)
    하위 그룹입니다.
    Example: [{"external_id":"accessory","name":"Accessory","description":"Accessory","image_url":null,"order":1,"level":2,"children":[],"parent_external_id":"background"}]

  - `groups.children.children.external_id` (string)
    외부 그룹 ID입니다.
    Example: "accessory"

  - `groups.children.children.name` (string)
    그룹 이름입니다.
    Example: "Accessory"

  - `groups.children.children.description` (string)
    그룹 설명입니다.
    Example: "Accessory"

  - `groups.children.children.image_url` (string,null)
    이미지 URL입니다.

  - `groups.children.children.order` (integer)
    배열 순서를 정의합니다.
    Example: 1

  - `groups.children.children.level` (integer)
    그룹 중첩 수준입니다.
    Example: 2

  - `groups.children.children.children` (array)
    하위 그룹입니다.
    Example: []

  - `groups.children.children.parent_external_id` (string,null)
    상위 외부 그룹 ID입니다.
    Example: "background"

  - `groups.children.parent_external_id` (string,null)
    상위 외부 그룹 ID입니다.
    Example: "weapons"

  - `groups.parent_external_id` (string,null)
    상위 외부 그룹 ID입니다.