# アイテムグループリストを取得する

ページネーションなしでカタログを構築するためのアイテムグループリストを取得します。

注意アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、 AuthorizationヘッダーにユーザーのJWTを渡す必要があります。

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に準拠した2文字の小文字の言語コード（例：en）。nameやdescriptionなどのローカリゼーションフィールドでは5文字のロケールコード（例：en-US）がサポートされていますが、応答内では2文字のコードに正規化されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

  - `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。