JSONインポートを使用したアイテムカタログの作成と更新方法
JSONファイルからのインポートを使用して、アイテムの作成、更新、非アクティブ化を行うことができます。
お知らせ
APIコールを使用して、またはパブリッシャーアカウントで手動でアイテムを作成、更新、または無効化できます。ただし、アイテムごとに個別のリクエストやアクションを実行する必要があります。インポートを使用すると、1つのJSONファイルで指定することで、複数のアイテムに対してこれらのアクションを同時に実行できます。
このツールを使用すると、次のことが可能になります：
機能：
- 以下のタイプのアイテムをサポート：
- 仮想アイテム
- 仮想通貨
- 仮想通貨パッケージ
- バンドル
- データの検証。ファイルの構造やデータ形式が要件を満たしていない場合、インポート時にエラーのリストが表示されます。
制限事項：
- インポートはゲームキー、プロモーション、リワードシステムには利用できません。
- アップロードするJSONファイルのサイズは7MBを超えないようにしてください。
- JSONファイルのパラメータ形式は、対応する製品作成方法で指定された形式と一致している必要があります：
お知らせ
事前に作成されたアイテムの場合は、CSVファイルから地域の価格をインポートできます。
アイテムカタログのインポート
ファイルからアイテムカタログをインポートするには：
- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想通貨、アイテムカタログ > 仮想アイテム、またはアイテムカタログ > バンドルセクションに移動します。
- 「アイテムをインポート」をクリックします。
- アクションを選択します：
- 新規アイテムの追加 — 新しいSKUを持つアイテムのみが追加されます。
- 新規アイテムの追加、既存アイテムの更新 — 新しいSKUのアイテムが追加され、既存のアイテムのデータが更新されます。
- 新規アイテムの追加、既存アイテムの更新、欠落アイテムの無効化 — ファイルからSKUを持つアイテムが追加/更新されます。カタログにアイテムがあるが、ファイルにそのようなSKUがない場合、パブリッシャーアカウントのアイテムのステータスは一部利用可能（アイテムは個別に購入できませんが、バンドルまたはボーナスの一部として購入できます）に変更されます。
- インポート用のファイルを記入します：
- ダウンロードウィンドウでファイルテンプレートをダウンロードし、以下の例に従って入力します。
- アイテムをエクスポートし、エクスポートされたファイルをテンプレートとして使用します。
- 独自のJSONファイルを作成し、以下の例に従って記入します。
完全なJSONファイルの例：
Copy
- json
1{
2 "virtual_currency": [
3 {
4 "sku": "Gem_test_import",
5 "name": {
6 "en": "Gem_test_import"
7 },
8 "type": "virtual_currency",
9 "description": {
10 "en": "my test imported currency"
11 },
12 "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
13 "description": {
14 "en": "my test imported currency",
15 "de": "meine importierte Testwährung"
16 },
17 "attributes": [],
18 "is_free": false,
19 "order": 1,
20 "groups": [],
21 "regional_prices": [],
22 "prices": [
23 {
24 "amount": 2,
25 "currency": "USD",
26 "is_default": true,
27 "is_enabled": true
28 }
29 ],
30 "media_list": [],
31 "vc_prices": [],
32 "is_enabled": true,
33 "is_show_in_store": true,
34 "regions": [],
35 "limits": {
36 "per_user": null,
37 "per_item": null,
38 "recurrent_schedule": null
39 },
40 "periods": [],
41 "inventory_options": {
42 "consumable": true,
43 "expiration_period": null
44 },
45 "is_hard": false
46 }
47 ],
48 "virtual_items": [
49 {
50 "sku": "event_access_test_import",
51 "name": {
52 "en": "Special Event Access_test_import"
53 },
54 "type": "virtual_good",
55 "description": {
56 "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
57 },
58 "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
59 "long_description": null,
60 "attributes": [],
61 "is_free": false,
62 "order": 1,
63 "groups": [
64 "my_test_group"
65 ],
66 "regional_prices": [],
67 "prices": [
68 {
69 "amount": 35,
70 "currency": "USD",
71 "is_default": true,
72 "is_enabled": true
73 }
74 ],
75 "media_list": [],
76 "vc_prices": [],
77 "is_enabled": true,
78 "is_show_in_store": true,
79 "regions": [],
80 "limits": {
81 "per_user": null,
82 "per_item": null,
83 "recurrent_schedule": null
84 },
85 "periods": [],
86 "inventory_options": {
87 "consumable": true,
88 "expiration_period": null
89 }
90 }
91 ],
92 "virtual_currency_packages": [
93 {
94 "item_id": 441982,
95 "sku": "small_gold_pack_test_import",
96 "type": "bundle",
97 "name": {
98 "en": "Small gold pack"
99 },
100 "bundle_type": "virtual_currency_package",
101 "description": {
102 "en": "Gold x100"
103 },
104 "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105 "vc_prices": [],
106 "regional_prices": [],
107 "prices": [
108 {
109 "amount": 5,
110 "currency": "USD",
111 "is_default": true,
112 "is_enabled": true
113 }
114 ],
115 "is_enabled": true,
116 "is_show_in_store": true,
117 "regions": [],
118 "limits": {
119 "per_user": null,
120 "per_item": null,
121 "recurrent_schedule": null
122 },
123 "periods": [],
124 "attributes": [],
125 "long_description": null,
126 "media_list": [],
127 "order": 100000000,
128 "is_free": false,
129 "groups": [],
130 "content": [
131 {
132 "sku": "Gem_test_import",
133 "quantity": 100
134 }
135 ]
136 }
137 ],
138 "bundles": [
139 {
140 "item_id": 684024,
141 "sku": "start_pack_test_import_test_import",
142 "type": "bundle",
143 "name": {
144 "en": "Legendary Start Pack"
145 },
146 "bundle_type": "standard",
147 "description": {
148 "en": "Crystal x 1\nGem x 1"
149 },
150 "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151 "regional_prices": [],
152 "prices": [
153 {
154 "amount": 20,
155 "currency": "USD",
156 "is_default": true,
157 "is_enabled": true
158 }
159 ],
160 "virtual_prices": [],
161 "is_enabled": true,
162 "is_show_in_store": true,
163 "regions": [],
164 "limits": {
165 "per_user": null,
166 "per_item": null,
167 "recurrent_schedule": null
168 },
169 "periods": [],
170 "attributes": [],
171 "long_description": null,
172 "media_list": [],
173 "order": 5,
174 "is_free": false,
175 "groups": [
176 "my_test_group"
177 ],
178 "content": [
179 {
180 "sku": "Gem_test_import",
181 "quantity": 1
182 },
183 {
184 "sku": "event_access_test_import",
185 "quantity": 1
186 }
187 ]
188 }
189 ]
190}
- インポートウィンドウの対応するフィールドに完全なファイルをアップロードします。
- インポート中にエラーが発生した場合は、そのエラーのリストと修正推奨事項がインポートウィンドウに表示されます。ファイルに必要な変更を加え、再度アップロードしてください。
アップロードに成功すると、指定したSKUのアイテムが作成、更新、または無効になります。
お知らせ
アイテムをインポートするには、JSONファイル経由でアイテムをインポートするAPIコールを使用します。
インポート時のエラーを避けるため、上記の推奨事項に従ってファイルを記入してください。
インポート時のエラーを避けるため、上記の推奨事項に従ってファイルを記入してください。
アイテムカタログのエクスポート
アイテムまたはアイテムカタログをJSONファイルにエクスポートするには：
- パブリッシャーアカウントでプロジェクトを開き、アイテムカタログ > 仮想通貨、アイテムカタログ > 仮想アイテム、またはアイテムカタログ > バンドルセクションに移動します。
- 「アイテムをエクスポート」をクリックします。
- アクションを選択します：
- すべてのアイテムのエクスポート — このプロジェクトのすべてのタイプのアイテムカタログ全体がエクスポートされます。例えば、仮想通貨セクションに移動してすべてのアイテムをエクスポートすると、JSONファイルにはプロジェクトの仮想通貨、仮想通貨パッケージ、仮想アイテム、ゲームキーパッケージが含まれます。
- 選択されたアイテムのみのエクスポート — 開いたウィンドウでエクスポートするアイテムを選択します。
- 「エクスポート」をクリックします。
JSONファイルのダウンロードが自動的に開始されます。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
