# 主要なエンティティ構造 
すべてのタイプ（仮想アイテム、バンドル、仮想通貨、キー）のアイテムは、同様のデータ構造を使用しています。この基本構造を理解することで、APIの利用が簡素化され、ドキュメントをよりスムーズに読み進められるようになります。
<div class="note"><b>注意</b><br><br>一部のコールには追加のフィールドが含まれる場合がありますが、基本構造が変わることはありません。</div>
**識別**
- `merchant_id` — [パブリッシャーアカウント](https://publisher.xsolla.com/)における会社ID
- `project_id` — パブリッシャーアカウントにおけるプロジェクトID
- `sku` — アイテムSKU、プロジェクト内で一意です

**ストア表示**
- `name` — アイテム名
- `description` — アイテム説明
- `image_url` — 画像URL
- `is_enabled` — アイテムの可用性
- `is_show_in_store` — アイテムがカタログに表示されるかどうか

カタログ内のアイテムの可用性管理に関する詳細は、[ドキュメント](/ja/items-catalog/catalog-features/items-availability/)を参照してください。
**組織**
- `type` — アイテムタイプ、例：仮想アイテム（`virtual_item`）またはバンドル（`bundle`）
- `groups` — アイテムが属するグループ
- `order` — カタログ内の表示順序

**販売条件**
- `prices` — 実際通貨または仮想通貨での価格
- `limits` — 購入制限
- `periods` — 可用期間
- `regions` — 地域別制限

**主要なエンティティ構造の例：**

```json
{
  "attributes": [],
  "bundle_type": "virtual_currency_package",
  "content": [
    {
      "description": {
        "en": "Main in-game currency"
      },
      "image_url": "https://.../image.png",
      "name": {
        "en": "Crystals",
        "de": "Kristalle"
      },
      "quantity": 500,
      "sku": "com.xsolla.crystal_2",
      "type": "virtual_currency"
    }
  ],
  "description": {
    "en": "Crystals x500"
  },
  "groups": [],
  "image_url": "https://.../image.png",
  "is_enabled": true,
  "is_free": false,
  "is_show_in_store": true,
  "limits": {
    "per_item": null,
    "per_user": null,
    "recurrent_schedule": null
  },
  "long_description": null,
  "media_list": [],
  "name": {
    "en": "Medium crystal pack"
  },
  "order": 1,
  "periods": [
    {
      "date_from": null,
      "date_until": "2020-08-11T20:00:00+03:00"
    }
  ],
  "prices": [
    {
      "amount": 20,
      "country_iso": "US",
      "currency": "USD",
      "is_default": true,
      "is_enabled": true
    }
  ],
  "regions": [],
  "sku": "com.xsolla.crystal_pack_2",
  "type": "bundle",
  "vc_prices": []
}
```