# Shop Builder API # Overview * **Version:** 2.0.0 * **Servers**: `https://store.xsolla.com/api` * **[Contact Us by Email](mailto:integration@xsolla.com)** * **Contact URL:** https://xsolla.com/ * **Required TLS version:** 1.2 Shop Builder API provides a third-party solution for implementing the server side for your store interface. Use the endpoints to manage in-game items, in-game currencies, cart, player inventory, promotions, game library, etc. Version: 2.0.0 ## Servers ``` https://store.xsolla.com/api ``` ## Security ### AuthForCart ゲーム付きカートを販売する場合、[認証なしでエンドポイントを呼び出すこと](/ja/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)ができます。 そのためには： * ゲームのヘッダーの`x-unauthorized-id`パラメータに一意の識別子を追加します。 * ゲームのヘッダーで`x-user`パラメータ（Base64でエンコードされた）にユーザーのメールアドレスを追加します。 デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。 [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。 Type: http Scheme: bearer ### XsollaLoginUserJWT デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。 [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。 Type: http Scheme: bearer Bearer Format: JWT ### basicAuth エクソーラのAPIは基礎アクセス認証を使用します。APIへのすべてのリクエストは `Authorization: Basic ` ヘッダーを含む必要があり、`your_authorization_basic_key`はBase64標準に従ってエンコードされた`project_id:api_key` ペアです。 必要に応じて、`project_id`の代わりに`merchant_id`を使用することができます。機能には影響しません。 [パブリッシャーアカウント](https://publisher.xsolla.com/)に移動して、パラメータの値を確認します： * `merchant_id`が表示されます： * **会社設定 > 会社**セクションで * 任意のパブリッシャーアカウントページのブラウザアドレスバーにあるURL。URLは以下の形式です：`https://publisher.xsolla.com/`。 * `api_key`は、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます： * **会社設定＞APIキー** * **プロジェクト設定 > APIキー** * `project_id`表示： * プロジェクト名の横にあるパブリッシャーアカウントで表示されます。 * パブリッシャーアカウントでプロジェクトを操作する際に、ブラウザのアドレスバーに表示されるURL。URLは以下の形式です：`https://publisher.xsolla.com//projects/`。 APIキーの操作に関する詳細は、[APIリファレンス](https://developers.xsolla.com/ja/api/getting-started/#api_keys_overview)を参照してください。 Type: http Scheme: basic ### basicMerchantAuth エクソーラAPIはベーシックアクセス認証を使用します。APIへのすべてのリクエストは`Authorization: Basic `ヘッダーを含む必要があり、`your_authorization_basic_key`はBase64標準に従ってエンコードされた`merchant_id:api_key`ペアです。 [パブリッシャーアカウント](https://publisher.xsolla.com/)に移動して、パラメータの値を確認します： * `merchant_id`が表示されます： * **会社設定 > 会社**セクションで * 任意のパブリッシャーアカウントページのブラウザアドレスバーにあるURL。URLは以下の形式です：`https://publisher.xsolla.com/` * `api_key`は、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます： * **会社設定 > APIキー** * **プロジェクト設定 > APIキー** APIキーの操作に関する詳細は、[APIリファレンス](https://developers.xsolla.com/ja/api/getting-started/#api_keys_overview)を参照してください。 Type: http Scheme: basic ## Download OpenAPI description [Shop Builder API](https://developers.xsolla.com/_bundle/@l10n/ja/api/shop-builder/index.yaml) ## 管理者 ### 属性リストを取得する（管理者） - [GET /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-get-attribute-list.md): 管理用プロジェクトから属性のリストを取得します。 ### 属性を作成 - [POST /v2/project/{project_id}/admin/attribute](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-create-attribute.md): 属性を作成します。 ### 属性を削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/delete-attribute.md): 属性を削除します。 注意アイテム属性を削除すると、そのすべてのデータおよびアイテムとの関連付けが失われます。 ### 指定された属性を取得 - [GET /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-get-attribute.md): 指定された属性を取得します。 ### 属性を更新 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-update-attribute.md): 属性を更新します。 ### 属性値をすべて削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-delete-all-attribute-value.md): 属性のすべての値を削除します。 注意属性の値を削除すると、その属性とアイテム間のすべての関連付けが失われます。アイテムの属性値を変更するには、値を削除して新しい値を作成するのではなく、属性値を更新するAPIコールを使用してください。 ### 属性値を作成 - [POST /v2/project/{project_id}/admin/attribute/{external_id}/value](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-create-attribute-value.md): 属性値を作成します。 注意すべてのプロジェクトには、応答で得られる属性値に制限があります。初期値および最大値は、1属性あたり20個の値。 ### 属性値を削除 - [DELETE /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-delete-attribute-value.md): 一つの属性値を削除します。 注意属性の値を削除すると、その属性とアイテム間のすべての関連付けが失われます。アイテムの属性値を変更するには、値を削除して新しい値を作成するのではなく、属性値を更新するAPIコールを使用してください。 ### 属性値を更新 - [PUT /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}](https://developers.xsolla.com/ja/api/shop-builder/attribute-admin/admin-update-attribute-value.md): 属性値を更新します。 ## 個人用カタログ ユーザー属性に応じたルールを指定することができるAPIです。 ユーザーが具体的なルールの条件をすべて満たした場合、パーソナライズされたアイテムが表示されます。 パーソナライズされたプロモーションについては、[プロモーションセクション](/ja/api/shop-builder/tag/promotions-discounts)を参照してください。 購入前に属性を渡すには、[Xsolla Login API](/ja/api/login/operation/update-users-attributes-from-server/)を使うか、[Pay Station API](/ja/api/pay-station/operation/create-token)を使ってトークンを生成する際にそれをuser.attributesプロパティに渡します。 ### カタログフィルタルールのリストを取得 - [GET /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/get-filter-rules.md): ユーザー属性に適用されるすべてのルールを取得します。 ### カタログフィルタルールを作成 - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/create-filter-rule.md): ユーザー属性のルールを作成します。 ### クライアントサイドで検索するためのすべてのカタログルールを取得します - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/get-all-filter-rules.md): クライアントサイドで検索するためのすべてのカタログルールのリストを取得します。 注意ルールID、名前、is_enabledのみを返します。 ### カタログフィルタルールを削除 - [DELETE /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/delete-filter-rule-by-id.md): 特定のルールを削除します。 ### カタログフィルタルールを取得 - [GET /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/get-filter-rule-by-id.md): ユーザー属性に適用される特定のルールを取得します。 ### カタログフィルタルールを修正 - [PATCH /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/patch-filter-rule-by-id.md): ユーザー属性に適用される特定のルールを更新します。指定されていないプロパティには、現在の値が使用されます。 ### カタログフィルタールールを更新 - [PUT /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}](https://developers.xsolla.com/ja/api/shop-builder/personalized-catalog/update-filter-rule-by-id.md): ユーザー属性に適用される特定のルールを更新します。指定されていないプロパティはデフォルト値が使用されます（プロパティが必須でない場合）。 ## 管理者 ### バンドルのリストを取得 - [GET /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-get-bundle-list.md): 管理用のプロジェクト内のバンドルリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### バンドルを作成 - [POST /v2/project/{project_id}/admin/items/bundle](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-create-bundle.md): バンドルを作成します。 ### 指定されたグループexternal IDのバンドルリストを取得する - [GET /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-external-id.md): 管理用のグループ内のバンドルリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 指定されたグループIDのバンドルリストを取得する - [GET /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-get-bundle-list-in-group-by-id.md): 管理用のグループ内のバンドルリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### バンドルを削除 - [DELETE /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-delete-bundle.md): バンドルを削除します。 ### バンドルを取得 - [GET /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-get-bundle.md): 管理用プロジェクト内のバンドルを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### バンドルを更新 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-update-bundle.md): バンドルを更新します。 ### カタログにバンドルを非表示 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-hide-bundle.md): カタログにバンドルを非表示します。 ### カタログにバンドルを表示 - [PUT /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show](https://developers.xsolla.com/ja/api/shop-builder/bundles-admin/admin-show-bundle.md): カタログにバンドルを表示します。 ## カタログ ### バンドルのリストを取得 - [GET /v2/project/{project_id}/items/bundle](https://developers.xsolla.com/ja/api/shop-builder/bundles-catalog/get-bundle-list.md): カタログ構築のために、バンドルのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループのバンドルリストを取得する - [GET /v2/project/{project_id}/items/bundle/group/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/bundles-catalog/get-bundle-list-in-group.md): カタログ構築のために、グループ内のバンドルのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたバンドルを取得する - [GET /v2/project/{project_id}/items/bundle/sku/{sku}](https://developers.xsolla.com/ja/api/shop-builder/bundles-catalog/get-bundle.md): 指定されたバンドルを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## カート（クライアント側） ### 現在のユーザーのカートを取得 - [GET /v2/project/{project_id}/cart](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/get-user-cart.md): 現在のユーザーのカートを返します。 ### 現在のカートからすべてのカートアイテムを削除 - [PUT /v2/project/{project_id}/cart/clear](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/cart-clear.md): カートのアイテムをすべて削除します。 ### カートにアイテムを入れる - [PUT /v2/project/{project_id}/cart/fill](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/cart-fill.md): カートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。 ### 現在のカートからアイテムを削除 - [DELETE /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/delete-item.md): カートからアイテムを削除します。 ### 現在のカートからカートのアイテムを更新 - [PUT /v2/project/{project_id}/cart/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/put-item.md): 既存のカートアイテムを更新するか、カート内のアイテムを作成します。 ### カートIDによりカートを取得 - [GET /v2/project/{project_id}/cart/{cart_id}](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/get-cart-by-id.md): カートIDによりユーザーのカートを返します。 ### カートIDによるすべてカートアイテムを削除 - [PUT /v2/project/{project_id}/cart/{cart_id}/clear](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/cart-clear-by-id.md): カートのアイテムをすべて削除します。 ### カートに特定のアイテムを入れる - [PUT /v2/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/cart-fill-by-id.md): カートに特定のアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテム位置が渡された値で置き換えられます。 ### カートIDによるカートアイテムを削除 - [DELETE /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/delete-item-by-cart-id.md): カートからアイテムを削除します。 ### カートIDによるカートアイテムを更新 - [PUT /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/cart-client-side/put-item-by-cart-id.md): 既存のカートアイテムを更新するか、カート内のアイテムを作成します。 ## カート（サーバー側） ### カートにアイテムを入れる - [PUT /v2/admin/project/{project_id}/cart/fill](https://developers.xsolla.com/ja/api/shop-builder/cart-server-side/admin-cart-fill.md): 現在のカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。 ### カートIDでカートにアイテムを入れる - [PUT /v2/admin/project/{project_id}/cart/{cart_id}/fill](https://developers.xsolla.com/ja/api/shop-builder/cart-server-side/admin-fill-cart-by-id.md): カートIDによるカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。 ## 決済（クライアント側） ### 現在のカートの全アイテムを対象とした注文を作成する - [POST /v2/project/{project_id}/payment/cart](https://developers.xsolla.com/ja/api/shop-builder/payment-client-side/create-order.md): クライアントサーバーへの統合に使用されます。カートからのすべてのアイテムを含む注文を作成し、そのための決済トークンを生成します。作成された注文はnew注文ステータスを取得します。 クライアントIPは、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。 決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：https://secure.xsolla.com/paystation4/?token={token}で{token}受信したトークン。 テスト目的には、以下のリンクを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ### 特定のカートの全アイテムを対象とした注文を作成する - [POST /v2/project/{project_id}/payment/cart/{cart_id}](https://developers.xsolla.com/ja/api/shop-builder/payment-client-side/create-order-by-cart-id.md): クライアントサーバーへの統合に使用されます。特定のカートからのすべてのアイテムを含む注文を作成し、そのための決済トークンを生成します。作成された注文はnew注文ステータスを取得します。 クライアントIPは、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。 決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：https://secure.xsolla.com/paystation4/?token={token}で{token}受信したトークン。 テスト目的には、以下のリンクを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ### 指定したアイテムで注文を作成する - [POST /v2/project/{project_id}/payment/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/payment-client-side/create-order-with-item.md): クライアントサーバーへの統合に使用されます。指定されたアイテムの注文を作成し、そのアイテムに対する決済トークンを生成します。作成された注文はnew注文ステータスを取得します。 クライアントIPは、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。 決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：https://secure.xsolla.com/paystation4/?token={token}で{token}受信したトークン。 テスト目的には、以下のリンクを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token}。 注意このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、ペイステーションの決済方法に影響を与える可能性があります。 ### 有料のオファーチェーンステップの注文を作成する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ja/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): 指定された有料オファーチェーンステップに関連付けられたアイテムの注文を作成します。作成された注文はnewの注文ステータスになります。 新しいウィンドウで決済UIを開くには、以下のリンクを使用してください：https://secure.xsolla.com/paystation4/?token={token}で{token} は受信したトークンです。 テスト目的の場合は、次のURLを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token} 注意 このメソッドはクライアントサイドで使用する必要があります。ユーザーのIPアドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ### 有料のオファーチェーンステップの注文を作成する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): 指定された有料オファーチェーンステップに関連付けられたアイテムの注文を作成します。作成された注文はnewの注文ステータスになります。 新しいウィンドウで決済UIを開くには、以下のリンクを使用してください：https://secure.xsolla.com/paystation4/?token={token}で{token} は受信したトークンです。 テスト目的の場合は、次のURLを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token} 注意 このメソッドはクライアントサイドで使用する必要があります。ユーザーのIPアドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ## クライアント ### 有料のオファーチェーンステップの注文を作成する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ja/api/shop-builder/payment-client-side/order-user-offer-chain-step-reward.md): 指定された有料オファーチェーンステップに関連付けられたアイテムの注文を作成します。作成された注文はnewの注文ステータスになります。 新しいウィンドウで決済UIを開くには、以下のリンクを使用してください：https://secure.xsolla.com/paystation4/?token={token}で{token} は受信したトークンです。 テスト目的の場合は、次のURLを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token} 注意 このメソッドはクライアントサイドで使用する必要があります。ユーザーのIPアドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ### 現在のユーザーのオファーチェーンを取得する - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-client/get-offer-chains-list.md): 現在のユーザーのオファーチェーンを取得します。 注意すべてのプロジェクトには、1つの応答で返されるアイテム数に制限があります。デフォルトおよび最大値は1応答50アイテムです。より多くのデータを取得するには、ページネーションのためにlimitとoffsetクエリパラメータを使用してください。 ### IDで現在のユーザーのオファーチェーンを取得する - [GET /v2/project/{project_id}/user/offer_chain/{offer_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-client/get-user-offer-chain-by-id.md): 現在のユーザーのオファーチェーンをIDで取得します。 ### 無料オファーチェーンステップを請求する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-client/claim-user-offer-chain-step-reward.md): 現在のユーザーのオファーチェーンステップの進行を完了させ、関連する報酬を付与します。 注意 このコールは、オファーチェーン内の無料ステップにのみ使用してください。 実際通貨での支払いが必要なステップには、代わりに有料オファーチェーンステップの注文を作成するコールを使用してください。 ### 有料のオファーチェーンステップの注文を作成する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-client/order-user-offer-chain-step-reward.md): 指定された有料オファーチェーンステップに関連付けられたアイテムの注文を作成します。作成された注文はnewの注文ステータスになります。 新しいウィンドウで決済UIを開くには、以下のリンクを使用してください：https://secure.xsolla.com/paystation4/?token={token}で{token} は受信したトークンです。 テスト目的の場合は、次のURLを使用してください：https://sandbox-secure.xsolla.com/paystation4/?token={token} 注意 このメソッドはクライアントサイドで使用する必要があります。ユーザーのIPアドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ## 決済（サーバー側） ### 購入用の決済トークンを作成する - [POST /v3/project/{project_id}/admin/payment/token](https://developers.xsolla.com/ja/api/shop-builder/payment-server-side/admin-create-payment-token.md): 注文とその支払いトークンを生成します。注文はリクエストボディに渡されたアイテムに基づいて生成されます。 決済UIを新しいウィンドウで開くには、次のリンクを使用します：https://secure.xsolla.com/paystation4/?token={token}。そこで、{token}は受信したトークンです。 テスト目的では、次のURLを使用します：https://sandbox-secure.xsolla.com/paystation4/?token={token}。 通知 user.country.valueパラメータは、注文の通貨を選択するために使用されます。ユーザーの国が不明な場合は、 X-User-IpヘッダーにユーザーのIPを指定することもできます。この方法の正しい動作には、これら2つのオプションのいずれかが必要です。選択した通貨は、ペイステーションでの決済方法に使用されます。 ## 注文 ### 注文する - [GET /v2/project/{project_id}/order/{order_id}](https://developers.xsolla.com/ja/api/shop-builder/order/get-order.md): 指定された注文を取得します。 ### 指定期間の注文リストを取得する - [POST /v3/project/{project_id}/admin/order/search](https://developers.xsolla.com/ja/api/shop-builder/order/admin-order-search.md): 作成日の古いものから新しいものへと並べられた注文リストを取得します。 ## 無料アイテム ### 無料カートで注文を作成する - [POST /v2/project/{project_id}/free/cart](https://developers.xsolla.com/ja/api/shop-builder/free-item/create-free-order.md): 無料カートのすべてのアイテムを含む注文を作成します。作成された注文はdoneという注文状況を取得します。 ### 特定の無料カートで注文を作成する - [POST /v2/project/{project_id}/free/cart/{cart_id}](https://developers.xsolla.com/ja/api/shop-builder/free-item/create-free-order-by-cart-id.md): 特定の無料カートのすべてのアイテムを含む注文を作成します。作成された注文はdoneという注文状況を取得します。 ### 指定された無料アイテムで注文を作成する - [POST /v2/project/{project_id}/free/item/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/free-item/create-free-order-with-item.md): 指定された無料アイテムで注文を作成します。作成された注文は doneという注文状況を取得します。 ## ウェブフック ### ウェブフック設定に関する情報を取得 - [GET /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ja/api/shop-builder/common-webhooks/get-webhook.md): ストアのウェブフック設定に関する情報を取得します。 詳しくは、ウェブフックのドキュメントをご覧ください。 ### ウェブフック設定に関する情報を更新 - [PUT /v2/project/{project_id}/admin/webhook](https://developers.xsolla.com/ja/api/shop-builder/common-webhooks/update-webhook.md): ストアのウェブフック設定に関する情報を更新します。 詳しくは、ウェブフックのドキュメントをご覧ください。 ## 先行予約 ### アイテムの先行予約制限の数量を削除 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/remove-pre-order-limit.md): アイテムの先行予約制限の数量を削除します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### アイテム先行予約制限に関する情報を取得 - [GET /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/get-pre-order-limit.md): アイテムの先行予約制限の取得を設定します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### アイテム先行予約制限に数量を追加 - [POST /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/add-pre-order-limit.md): アイテムの先行予約数に数量を追加します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### アイテムの先行予約制限の数量を設定 - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/set-pre-order-limit.md): アイテムの先行予約制限の数量を設定します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id} ### アイテムの先行予約制限の数量をすべて削除 - [DELETE /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/remove-all-pre-order-limit.md): アイテムの先行予約制限のすべての数量を削除します。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all ### アイテムの先行予約制限をトグル - [PUT /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle](https://developers.xsolla.com/ja/api/shop-builder/common-pre-orders/toggle-pre-order-limit.md): アイテムの先行予約制限を有効/無効にします。 Pre-Order limit APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います： * ゲームキー * 仮想アイテム & 通貨 * バンドル このエンドポイントの別名： * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle ## マーチャント ### プロジェクトを取得 - [GET /v2/merchant/{merchant_id}/projects](https://developers.xsolla.com/ja/api/shop-builder/common-merchant/get-projects.md): マーチャントのプロジェクトのリストを取得します。 注意このAPIコールには、project_idパスパラメータが含まれていないため、会社の全プロジェクトで有効なAPIキーを使用して認可を設定する必要があります。 ## カタログ このAPIは販売可能なアイテムや特定のアイテムを取得することができます。 ### 販売可能なアイテムのリストを取得 - [GET /v2/project/{project_id}/items](https://developers.xsolla.com/ja/api/shop-builder/common-catalog/get-sellable-items.md): カタログ構築のために、販売可能なアイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループの販売可能なアイテムリストを取得 - [GET /v2/project/{project_id}/items/group/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/common-catalog/get-sellable-items-group.md): カタログ構築のために、指定されたグループから販売可能なアイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### IDによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/common-catalog/get-sellable-item-by-id.md): IDによる販売可能なアイテムを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### SKUによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/sku/{sku}](https://developers.xsolla.com/ja/api/shop-builder/common-catalog/get-sellable-item-by-sku.md): カタログを作成するためにSKUによる販売可能なアイテムを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## 共通地域 ### 地域リストを取得する - [GET /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ja/api/shop-builder/common-regions/admin-get-regions.md): 地域を取得します。 地域制限を管理するためにリージョンを使用することができます。 ### 地域を作成する - [POST /v2/project/{project_id}/admin/region](https://developers.xsolla.com/ja/api/shop-builder/common-regions/admin-create-region.md): 地域を作成します。 地域制限を管理するためにリージョンを使用することができます。 ### 地域を削除する - [DELETE /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/shop-builder/common-regions/admin-delete-region.md): 特定の地域を削除します。 ### 地域を取得する - [GET /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/shop-builder/common-regions/admin-get-region.md): 特定地域を取得します。 地域制限を管理するために地域を使用することができます。 ### 地域を更新する - [PUT /v2/project/{project_id}/admin/region/{region_id}](https://developers.xsolla.com/ja/api/shop-builder/common-regions/admin-update-region.md): 特定地域を更新します。 地域制限を管理するために地域を使用することができます。 ## カタログ ### ゲームリストを取得 - [GET /v2/project/{project_id}/items/game](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-games-list.md): カタログ構築のために、ゲームのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### DRMリストを取得 - [GET /v2/project/{project_id}/items/game/drm](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-drm-list.md): 利用可能なDRMのリストを取得します。 ### 指定されたグループによるゲームリストを取得 - [GET /v2/project/{project_id}/items/game/group/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-games-group.md): カタログ構築のために、指定されたグループからゲームリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループのゲームキーリストを取得 - [GET /v2/project/{project_id}/items/game/key/group/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-game-keys-group.md): カタログ構築のために、指定されたグループからゲームキーのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### カタログ用のゲームキーを取得する - [GET /v2/project/{project_id}/items/game/key/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-game-key-by-sku.md): カタログのゲームキーを取得します。 注意このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### カタログ用ゲームを取得する - [GET /v2/project/{project_id}/items/game/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-catalog/get-game-by-sku.md): カタログのゲームを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## 資格 ### 資格付与（管理者） - [POST /v2/project/{project_id}/admin/entitlement/grant](https://developers.xsolla.com/ja/api/shop-builder/game-keys-entitlement/grant-entitlement-admin.md): ユーザーに権利を付与します。 注意 ゲームコードやDRM-freeプラットフォームのゲームのみ付与可能です。 ### 資格の取り消し（管理者） - [POST /v2/project/{project_id}/admin/entitlement/revoke](https://developers.xsolla.com/ja/api/shop-builder/game-keys-entitlement/revoke-entitlement-admin.md): ユーザーの権利を取り消します。 注意ゲームコードやDRMフリープラットフォームのゲームのみ取り消すことができます。 ### ユーザーが所有しているゲームソフトのリストを取得 - [GET /v2/project/{project_id}/entitlement](https://developers.xsolla.com/ja/api/shop-builder/game-keys-entitlement/get-user-games.md): ユーザーが所有しているゲームソフトのリストを取得します。レスポンスには特定のユーザーが所有するゲームの配列が含まれます。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、LIMITとOFFSETフィールドを使用してください。 ### クライアントによるゲームコードを引き換える - [POST /v2/project/{project_id}/entitlement/redeem](https://developers.xsolla.com/ja/api/shop-builder/game-keys-entitlement/redeem-game-pin-code.md): 提供されたゲームコードで権利を付与します。 注意DRM-freeプラットフォームでのみコードの引き換えが可能です。 ## 管理者 ### ゲームリストを取得する（管理者） - [GET /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-game-list.md): 管理用プロジェクト内のゲームのリストを取得します。 ゲームは、ユーザーが購入可能なゲームキーで構成されています。 注意このエンドポイントは、ストアカタログの構築に使用しないでください。 ### ゲームを作成 - [POST /v2/project/{project_id}/admin/items/game](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-create-game.md): プロジェクト内のゲームを作成します。 ### IDによるゲームを削除 - [DELETE /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-delete-game-by-id.md): IDによるプロジェクト内のゲームを削除します。 ### IDでゲームを取得する（管理者） - [GET /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-game-by-id.md): 管理用ゲームを取得します。 ゲームは、ユーザーが購入可能なゲームキーで構成されています。 注意このエンドポイントは、ストアカタログの構築に使用しないでください。 ### IDによるゲームを更新 - [PUT /v2/project/{project_id}/admin/items/game/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-update-game-by-id.md): IDによるプロジェクト内のゲームを更新します。 ### IDによるコードを削除 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-delete-codes-by-id.md): ゲームキーIDによりすべてのコードを削除します。 ### コードを削除 - [DELETE /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-delete-codes-by-sku.md): ゲームキーSKUによる全コードを削除します。 ### IDによるコードを取得 - [GET /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-codes-by-id.md): ゲームキーIDによる一定数のコードを取得します。 ### コードを取得 - [GET /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-codes-by-sku.md): ゲームキーSKUによる一定数のコードを取得します。 ### IDによるコードをアップロード - [POST /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-upload-codes-by-id.md): ゲームキーIDによるコードをアップロードします。 ### コード読み込みセッションに関する情報を取得 - [GET /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-codes-session.md): コード読み込みセッションに関する情報を取得します。 ### コードをアップロード - [POST /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-upload-codes-by-sku.md): ゲームキーSKUによるコードをアップロードします。 ### ゲームをSKUで削除 - [DELETE /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-delete-game-by-sku.md): SKUによるプロジェクト内のゲームを削除します。 ### ゲームを取得する（管理者） - [GET /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-get-game-by-sku.md): 管理用ゲームを取得します。 ゲームは、ユーザーが購入可能なゲームキーで構成されています。 注意このエンドポイントは、ストアカタログの構築に使用しないでください。 ### SKUによるゲームを更新 - [PUT /v2/project/{project_id}/admin/items/game/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/game-keys-admin/admin-update-game-by-sku.md): SKUによるプロジェクト内のゲームを更新します。 ## 通常 ### プロモーションをアクティブ化にする - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/ja/api/shop-builder/promotions-common/activate-promotion.md): プロモーションをアクティブ化にします。 ### プロモーションを停止 - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/ja/api/shop-builder/promotions-common/deactivate-promotion.md): プロモーションを停止にします。 ### プロモーションコードを検証する - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/ja/api/shop-builder/promotions-common/verify-promotion-code.md): コードがプロモーションコードであるかクーポンコードであるか、およびユーザーがそれを適用できるかどうかを決定します。 ### すべてのプロモーションリストを取得 - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/ja/api/shop-builder/promotions-common/get-promotion-list.md): プロジェクトのプロモーションリストを取得します。 ### コードで引き換え可能なプロモーションを入手する - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/ja/api/shop-builder/promotions-common/get-redeemable-promotion-by-code.md): プロモーションコードまたはクーポンコードを取得します。 ## クーポン このAPIを使用すると、クーポンを管理できます。 ### 一意のクーポンコード制限を取得する - [GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupon-code-limit.md): コードの残り使用可能回数を取得します。コードのフィルタリングには、codesクエリパラメータを使用します。 コードの上限を設定するには、管理セクションに移動します： * クーポン ### クーポンプロモーションをアクティブ化にする - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/activate-coupon.md): クーポンプロモーションをアクティブ化にします。 作成されたクーポンのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、クーポンのプロモーションをアクティブ化にします。 ### クーポンコードを取得 - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupon-codes.md): クーポンコードを取得します。 ### クーポンコードを作成 - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/create-coupon-code.md): クーポンコードを作成します。 ### クーポンコードを生成 - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/generate-coupon-codes.md): クーポンコードを生成します。 ### クーポンプロモーションを非アクティブ化にする - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/deactivate-coupon.md): クーポンプロモーションを非アクティブ化にします。 作成されたクーポンのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、クーポンのプロモーションを無効化または非アクティブ化します。 ### 指定したユーザーのクーポン上限を取得する - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupon-user-limit.md): 指定したユーザがクーポンを使用できる残り回数を取得します。 User limit APIを使用すると、ユーザーがクーポンを使用できる回数を制限することができます。ユーザー制限自体の設定は、管理セクションにアクセスしてください： * クーポン ### クーポン特典を入手 - [GET /v2/project/{project_id}/coupon/code/{coupon_code}/rewards](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupon-rewards-by-code.md): このコードによりクーポン特典を入手します。 ユーザーが多くのアイテムの中から1つをボーナスとして選択できるようにするために使用することができます。 通常のケースでは、クーポンにボーナスとしてゲームが含まれている場合、DRMを選択します（type=unit）。 ### クポーンコードを引き換える - [POST /v2/project/{project_id}/coupon/redeem](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/redeem-coupon.md): クーポンコードを引き換えます。クーポンが引き換えられた後、ユーザーはボーナスを得ることができます。 ### クーポンプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupons.md): プロジェクトのクーポンプロモーションのリストを取得します。 ### クーポンプロモーションを作成 - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/admin-create-coupon.md): クーポンプロモーションを作成します。 ### クーポンプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/delete-coupon-promotion.md): クーポンプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログに適用されなくなります。 削除後、プロモーションを復元することはできません。 削除されたプロモーションのクーポンコードは、既存のプロモーションに追加することができます。 ### クーポンプロモーションを取得 - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/get-coupon.md): 指定されたクーポンプロモーションを取得します。 ### クーポンプロモーションを更新 - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-coupons/update-coupon-promotion.md): クーポンプロモーションを更新しました。 ## プロモーションコード このAPI を使用すると、プロモーションコードを管理できます。 ### コードのプロモーションコード制限を取得する - [GET /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promo-code-code-limit.md): コードの残り使用可能回数を取得します。コードのフィルタリングには、codesクエリパラメータを使用します。 コードの上限を設定するには、管理セクションに移動します： * プロモーションコード ### プロモーションコードのプロモーションをアクティブ化 - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/activate](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/activate-promo-code.md): プロモーションコードのプロモーションをアクティブ化にします。 作成されたプロモーションコードのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、プロモーションコードのプロモーションを有効化またはアクティブ化します。 ### プロモーションコードのプロモーション用のコードを取得 - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promocode-codes.md): プロモーションコードのプロモーション用のコードを取得します。 ### プロモーションコードのプロモーション用のコードを作成 - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/create-promo-code-code.md): プロモーションコードのプロモーション用のコードを作成します。 ### プロモーションコードのプロモーション用のコードを生成 - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/code/generate](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/generate-promo-code-codes.md): プロモーションコードのプロモーション用のコードを生成します。 ### プロモーションコードのプロモーションを非アクティブ化 - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/deactivate-promo-code.md): プロモーションコードのプロモーションを非アクティブ化にします。 作成されたプロモーションコードのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、プロモーションコードのプロモーションを無効化または非アクティブ化します。 ### 指定したユーザーのプロモーションコード上限を取得する - [GET /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promo-code-user-limit.md): 指定したユーザがプロモーションコードを使用できる残り回数を取得します。 User limit APIを使用すると、ユーザーがプロモーションコードを使用できる回数を制限することができます。ユーザー制限自体の設定は、管理セクションにアクセスしてください： * プロモーションコード ### プロモーションコードの特典を入手 - [GET /v2/project/{project_id}/promocode/code/{promocode_code}/rewards](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promo-code-rewards-by-code.md): このコードによりプロモーションコードの特典を入手します。 ユーザーが多くのアイテムの中から1つをボーナスとして選択できるようにするために使用することができます。 通常のケースでは、プロモーションコードにボーナスとしてゲームが含まれている場合、DRMを選択します（type=unit）。 ### プロモーションコードを引き換える - [POST /v2/project/{project_id}/promocode/redeem](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/redeem-promo-code.md): プロモーションコードを引き換えます。 プロモーションコードを引き換えた後、ユーザーは無料でアイテムを入手したり、カートや特定のアイテムの価格を下げたりすることができます。 ### カートからプロモーションコードを削除 - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/remove-cart-promo-code.md): プロモーションコードをカートから削除します。 プロモーションコードを削除した後、カート内のすべてのアイテムの合計金額は、プロモーションコードによるボーナスや割引を除いて再計算されます。 ### プロモーションコードのプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promo-codes.md): プロジェクトのプロモーションコードリストを取得します。 ### プロモーションコードのプロモーションを作成 - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/create-promo-code.md): プロモーションコードのプロモーションを作成します。 ### プロモーションコードのプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/delete-promo-code.md): プロモーションコードのプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消える。 * アイテムカタログとカートに適用されなくなる。 削除後、プロモーションを復元することはできません。 削除されたプロモーションのプロモーションコードを既存のプロモーションに追加できます。 ### プロモーションコードのプロモーションを取得 - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/get-promo-code.md): 指定されたプロモーションコードを取得します。 ### プロモーションコードのプロモーションを更新 - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-promo-codes/update-promo-code.md): プロモーションコードのプロモーションを更新しました。 ## ユニークなカタログオファー このAPIを使用すると、ユニークなカタログオファーを管理することができます。 ### ユニークなカタログオファープロモーションをアクティブ化にする - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/activate-unique-catalog-offer.md): ユニークなカタログオファープロモーションをアクティブ化にします。 作成されたユニークなカタログオファープロモーションは、デフォルトでは無効になっています。 アクティブ化するまで引き換えることはできません。 このエンドポイントを使用して、クーポンプロモーションを有効化およびアクティブ化します。 ### ユニークなカタログオファーコードを取得する - [GET /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer-codes.md): ユニークなカタログオファーコードを取得する ### ユニークなカタログオファーコードを作成する - [POST /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/create-unique-catalog-offer-code.md): ユニークなカタログオファーコードを作成します。 ### ユニークなカタログオファーコードを生成する - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/generate-unique-catalog-offer-codes.md): ユニークなカタログオファーコードを生成します。 ### ユニークカタログオファープロモーションを非アクティブ化する - [PUT /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): ユニークなカタログオファープロモーションを非アクティブ化にします。 作成されたユニークなカタログオファープロモーションは、デフォルトでは無効になっています。 アクティブ化するまで引き換えることはできません。 このエンドポイントを使用して、クーポンプロモーションを無効化および非アクティブ化します。 ### ユニークなカタログオファープロモーションのリストを取得します。 - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offers.md): プロジェクトのユニークなカタログオファープロモーションのリストを取得します。 ### ユニークなカタログオファープロモーションを作成する - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/admin-create-unique-catalog-offer.md): ユニークなカタログオファープロモーションを作成します。 ### ユニークなカタログオファープロモーションを削除 - [DELETE /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/delete-unique-catalog-offer-promotion.md): ユニークなカタログオファープロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログとカートに適用されなくなります。 削除後、プロモーションは復元できません。 ### ユニークなカタログオファープロモーションを取得 - [GET /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/get-unique-catalog-offer.md): 指定されたユニークなカタログオファープロモーションを取得します。 ### ユニークカタログオファープロモーションをアップデート - [PUT /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/promotions-unique-catalog-offers/update-unique-catalog-offer-promotion.md): ユニークカタログオファープロモーションをアップデート ## ディスカウント このAPIを使用すると、割引キャンペーンを管理することができます。 ### アイテムプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ja/api/shop-builder/promotions-discounts/get-item-promotion-list.md): プロジェクトのアイテムプロモーションのリストを取得します。 プロモーションは、アイテムの割引（％）を提供します。 指定したアイテムの全価格に割引が適用されます。 ### アイテムの割引プロモーションを作成 - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ja/api/shop-builder/promotions-discounts/create-item-promotion.md): アイテムの割引キャンペーンを作成します。 キャンペーンは、アイテムの割引（％）を提供します。 指定したアイテムの全価格に割引が適用されます。 ### アイテムプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/shop-builder/promotions-discounts/delete-item-promotion.md): 割引プロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログとカートに適用されなくなります。 削除後、プロモーションは復元できません。 ### アイテムプロモーションを取得 - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/shop-builder/promotions-discounts/get-item-promotion.md): 特定のアイテムに適用されるプロモーションを取得します。 プロモーションは、商品の割引（％）を提供します。 指定した商品の全価格に割引が適用されます。 ### アイテムプロモーションを更新する - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/shop-builder/promotions-discounts/update-item-promotion.md): プロモーションを更新します。 注意新しいデータは古いデータに取って代わります。プロモーションの一部だけを更新したい場合は、必要なデータもすべてリクエストで転送する必要があります。 プロモーションは、商品の割引（％）を提供します。 指定した商品の全価格に割引が適用されます。 ## ボーナス このAPIを使用すると、ボーナスプロモーションを管理できます。 ### ボーナスプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ja/api/shop-builder/promotions-bonuses/get-bonus-promotion-list.md): プロジェクトのボーナスプロモーションのリストを取得します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを作成 - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ja/api/shop-builder/promotions-bonuses/create-bonus-promotion.md): ボーナスプロモーションを作成します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/shop-builder/promotions-bonuses/delete-bonus-promotion.md): ボーナスプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログとカートに適用されなくなります。 削除後、プロモーションを復元することはできません。 ### ボーナスプロモーションを取得 - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/shop-builder/promotions-bonuses/get-bonus-promotion.md): ボーナスプロモーションを取得します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを更新 - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/shop-builder/promotions-bonuses/update-bonus-promotion.md): プロモーションを更新します。 注意新しいデータは古いデータに置き換わります。プロモーションの一部だけを更新したい場合は、必要なデータもすべてリクエストで転送する必要があります。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ## 管理者 ### 仮想通貨のリストを取得する - [GET /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currencies-list.md): 管理用のプロジェクト内の仮想通貨リストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想通貨を作成 - [POST /v2/project/{project_id}/admin/items/virtual_currency](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency.md): 仮想通貨を作成します。 ### 仮想通貨パッケージリストを取得する（管理者） - [GET /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-packages-list.md): 管理用のプロジェクト内の仮想通貨パッケージリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想通貨パッケージを作成 - [POST /v2/project/{project_id}/admin/items/virtual_currency/package](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-currency-package.md): 仮想通貨パッケージを作成します。 ### 仮想通貨パッケージを削除 - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency-package.md): 仮想通貨パッケージを削除します。 ### 仮想通貨パッケージを取得 - [GET /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency-package.md): 管理用のプロジェクト内の仮想通貨パッケージを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想通貨パッケージを更新 - [PUT /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency-package.md): 仮想通貨パッケージを更新します。 ### 仮想通貨を削除する - [DELETE /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-currency.md): 仮想通貨を削除します。 ### 仮想通貨を取得する - [GET /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-currency.md): 管理用のプロジェクト内の仮想通貨を取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想通貨を更新する - [PUT /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-currency.md): 仮想通貨を更新します。 ### 仮想アイテムのリストを取得する - [GET /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list.md): 管理用のプロジェクト内の仮想アイテムリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想アイテムを作成 - [POST /v2/project/{project_id}/admin/items/virtual_items](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-create-virtual-item.md): 仮想アイテムを作成します。 ### 指定されたグループ外部IDによる仮想アイテムのリストを取得します。 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-external-id.md): 管理用のグループ内の仮想アイテムリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 指定されたグループIDによる仮想アイテムのリストを取得します。 - [GET /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-items-list-by-group-id.md): 管理用のグループ内の仮想アイテムリストを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想アイテムを削除 - [DELETE /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-delete-virtual-item.md): 仮想アイテムを削除します。 ### 仮想アイテムを取得 - [GET /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-get-virtual-item.md): 管理用のプロジェクト内の仮想アイテムを取得します。 注このエンドポイントは、ストアカタログの構築に使用しないでください。 ### 仮想アイテムを更新 - [PUT /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-admin/admin-update-virtual-item.md): 仮想アイテムを更新します。 ## カタログ ### アイテムグループリストを取得する - [GET /v2/project/{project_id}/items/groups](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-item-groups.md): カタログを構築するためのアイテムグループリストを取得します。 ### 仮想通貨リストを取得する - [GET /v2/project/{project_id}/items/virtual_currency](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency.md): カタログ構築のために、仮想通貨のリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 仮想通貨パッケージリストを取得 - [GET /v2/project/{project_id}/items/virtual_currency/package](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package.md): カタログ構築のために、仮想通貨パッケージを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### SKUによる販売可能なアイテムを取得する - [GET /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-package-sku.md): カタログを作成するためにSKUによる仮想通貨パッケージを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### SKUによる仮想通貨を取得する - [GET /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-currency-sku.md): カタログを作成するためにSKUによる仮想通貨を取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### 仮想アイテムリストを取得 - [GET /v2/project/{project_id}/items/virtual_items](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-items.md): カタログ構築のために、仮想アイテムのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答50アイテムです。ページごとに多くのデータを取得するには、制限とオフセットフィールドを使用します。 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### すべての仮想アイテムリストを取得する - [GET /v2/project/{project_id}/items/virtual_items/all](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-all-virtual-items.md): クライアント側での検索のために、すべての仮想アイテムのリストを取得します。 注意アイテムのSKU、名前、グループ、および説明のみを返します 注意事項アイテムカタログAPIコールの利用は、認証なしで可能ですが、パーソナライズされたカタログを取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。 ### 指定されたグループによるアイテムリストを取得する - [GET /v2/project/{project_id}/items/virtual_items/group/{external_id}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-group.md): カタログを作成するために、指定されたグループからアイテムリストを取得します。 注意すべてのプロジェクトで、応答で取得できるアイテム数に制限があります。デフォルトおよび最大値は、1応答50アイテムです。ページごとにさらに多くのデータを取得するには、「制限」と「オフセット」フィールドを使用します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ### SKUによる仮想アイテムを取得する - [GET /v2/project/{project_id}/items/virtual_items/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-items-currency-catalog/get-virtual-items-sku.md): カタログを作成するためにSKUによる仮想アイテムを取得します。 注このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、パーソナライズされた結果のためのユーザー固有の詳細で応答の質を高めます。 ## 仮想決済 ### 仮想通貨で購入した指定商品で注文を作成する - [POST /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}](https://developers.xsolla.com/ja/api/shop-builder/virtual-payment/create-order-with-item-for-virtual-currency.md): 仮想通貨を利用したアイテム購入を構築します。 ## 管理 ### 指定したユーザーのすべての購入制限を更新する - [DELETE /v2/project/{project_id}/admin/user/limit/item/all](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/reset-all-user-items-limit.md): ユーザーが再度購入できるように、アイテムの購入制限を更新します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定したユーザーが利用できるアイテムの数を減らす - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/remove-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を減らします。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定されたユーザが利用できるアイテムの数を取得する - [GET /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/get-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を取得します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 通貨 * バンドル ### 指定したユーザーが使用できるアイテムの数を増やす - [POST /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/add-user-item-limit.md): 適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を増やします。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ### 指定されたユーザーが利用できるアイテムの数を設定する - [PUT /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/set-user-item-limit.md): 指定されたユーザーが、増減後に適用された制限の範囲内で購入できる数量を設定します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ### 購入制限を更新する - [DELETE /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/reset-user-item-limit.md): ユーザーが再び購入できるように、アイテムの購入制限を更新します。userパラメータがnullである場合、このコールはすべてのユーザーに対してこの制限を更新します。 User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの 管理セクションに移動します： * ゲームキー * 仮想アイテム & 仮想通貨 * バンドル ### 指定したユーザーのプロモーション制限をすべて更新する - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/reset-all-user-promotions-limit.md): して、これらのプロモーションを再度使用できるため、指定されたユーザーのすべてのプロモーションのすべての制限を更新します。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ### 指定したユーザーのプロモーション制限を減らす - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/remove-user-promotion-limit.md): 指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を減らします。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ### 指定したユーザーのプロモーション制限を取得する - [GET /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/get-user-promotion-limit.md): 指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を取得します。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ### 指定したユーザーのプロモーション制限を増やす - [POST /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/add-user-promotion-limit.md): 指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を増やします。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ### 指定したユーザーのプロモーション制限を設定する - [PUT /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/set-user-promotion-limit.md): プロモーションの増減後に適用される制限の中で、指定したユーザーが利用できる回数を設定します。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ### ユーザー向けプロモーション制限を更新する - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all](https://developers.xsolla.com/ja/api/shop-builder/user-limits-admin/reset-user-promotion-limit.md): ユーザーがこのプロモーションを再度使用できるように、プロモーション制限を更新します。userパラメータがnullである場合、このコールはすべてのユーザーのこの制限を更新します。 User limit API を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します： * 割引プロモーション * ボーナスプロモーション ## 管理者 ### バリューポイントのリストを取得する - [GET /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-get-value-points-list.md): 管理用のプロジェクト内のバリューポイントのリストを取得します。 ### バリューポイントを作成する - [POST /v2/project/{project_id}/admin/items/value_points](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-create-value-points.md): バリューポイントを作成します。 ### バリューポイントを削除する - [DELETE /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-delete-value-point.md): SKUによって識別されるバリューポイントを削除します。 ### バリューポイントを取得する - [GET /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-get-value-point.md): 管理用のプロジェクト内のSKUによってバリューポイントを取得します。 ### バリューポイントを更新する - [PUT /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-update-value-point.md): SKUで特定されるバリューポイントを更新します。 ### アイテムからバリューポイントを削除する - [DELETE /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-delete-items-value-point-reward.md): すべてのアイテムからバリューポイント報酬を削除します。 ### バリューポイントを持つアイテムのリストを取得する - [GET /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-get-items-value-point-reward.md): 管理用に、プロジェクト内のバリューポイントを持つすべてのアイテムリストを取得します。 ### アイテムのバリューポイントを部分的に更新する - [PATCH /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-patch-items-value-point-reward.md): SKUに基づいて、1つまたは複数のアイテムのバリューポイント数を部分的に更新します。 バリューポイント更新の原則： * アイテムがまだバリューポイントを持っていない場合、amountフィールドにゼロ以外の値を送信すると、バリューポイントが作成されます。 * アイテムがすでにバリューポイントを持っている場合、amountフィールドに 0 以外の値を送信すると、バリューポイントが更新されます。 * amountが0に設定された場合、そのアイテムの既存のバリューポイントは削除されます。 PUTメソッド（アイテムにバリューポイントを設定する）とは異なり、このPATCHメソッドは、プロジェクト内のアイテムの既存のバリューポイントをすべて上書きするのではなく、指定されたアイテムのみを更新します。 1 つのリクエストで最大100アイテムまで更新できます。重複するアイテム SKU を同じリクエストに含めることはできません。 ### アイテムのバリューポイントを設定する - [PUT /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-set-items-value-point-reward.md): SKUによって1つまたは複数のアイテムにバリューポイントを割り当てます。ユーザーはこれらのアイテムを購入した後にバリューポイントを受け取ります。 このPUT要求は、プロジェクト内のアイテムの以前に設定されたすべてのバリューポイントを上書きすることに注意してください。 意図しないバリューポイントの削除を避けるため、各PUTリクエストにすべてのアイテムとそれぞれのバリューポイントを含めてください。 特定のアイテムのバリューポイントだけを更新し、他のアイテムのバリューポイントを保持したい場合は、GETリクエストを使って現在のバリューポイントセットを取得し、ご希望のアイテムのバリューポイントを修正し、修正したバリューポイントセットを特定のアイテムの更新されたバリューポイントと一緒に送り返す必要があります。 ### 報酬チェーンのリストを取得する - [GET /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chains.md): 報酬チェーンのリストを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答あたり10アイテムです。ページごとにより多くのデータを取得するには、LIMITとOFFSETフィールドを使用してください。 ### 報酬チェーンを作成する - [POST /v3/project/{project_id}/admin/reward_chain](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-create-reward-chain.md): 報酬チェーンを作成します。 ### 報酬チェーンを削除する - [DELETE /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-delete-reward-chain.md): 特定の報酬チェーンを削除します。 ### 報酬チェーンを取得する - [GET /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-get-reward-chain.md): 特定の報酬チェーンを取得します。 ### 報酬チェーンを更新する - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-update-reward-chain.md): 特定の報酬チェーンを更新します。 ### 報酬チェーンのリセット - [POST /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-reset-reward-chain.md): 報酬チェーン内の全ユーザーのバリューポイントと進捗状況をリセットします。リセット後、報酬チェーンの有効期間を更新することができ、ユーザーは再び報酬チェーンを進めることができます。 注意 有効期間中に報酬チェーンをリセットしないでください。この場合、ユーザーは報酬を請求する前に獲得したバリューポイントを失う可能性があります。 ### 報酬チェーンの切り替え - [PUT /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-value-points-admin/admin-toggle-reward-chain.md): 報酬チェーンを有効/無効にします。 ## クライアント ### 現在のユーザーの報酬チェーンを取得する - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-client/get-reward-chains-list.md): クライアントエンドポイント。現在のユーザー報酬チェーンを取得します。 注意すべてのプロジェクトには、応答で得られるアイテムの数に制限があります。初期値および最大値は、1応答あたり50アイテムです。ページごとにより多くのデータを取得するには、LIMITとOFFSETフィールドを使用してください。 ### 現在のユーザーのバリューポイント残高を取得する - [GET /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-client/get-user-reward-chain-balance.md): クライアントのエンドポイント。現在のユーザーのバリューポイント残高を取得します。 ### ステップ報酬を請求する - [POST /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim](https://developers.xsolla.com/ja/api/shop-builder/reward-chain-client/claim-user-reward-chain-step-reward.md): クライアントのエンドポイント。報酬チェーンから現在のユーザーのステップ報酬を請求します。 ## クランクライアント ### クランの下で報酬チェーンへの貢献度トップ10を獲得する - [GET /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top](https://developers.xsolla.com/ja/api/shop-builder/clan-reward-chain-client/get-user-clan-top-contributors.md): 現在のユーザーのクランの下にある特定の報酬チェーンのトップ10の貢献者のリストを取得します。ユーザーがクランに属していない場合、コールは空の配列を返します。 ### 現在のユーザーのクランを更新する - [PUT /v2/project/{project_id}/user/clan/update](https://developers.xsolla.com/ja/api/shop-builder/clan-reward-chain-client/user-clan-update.md): ユーザー属性を通じて現在のユーザーのクランを更新します。以前のクランで請求されなかった報酬チェーンのすべての報酬を請求し、応答に返します。クランに所属していたユーザーが、現在はクランに所属していない場合、クランへの所属は取り消されます。ユーザーがクランを変更した場合、クランは変更されます。 ## 管理者 ### オファーチェーンのリストを取得する - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-get-offer-chains.md): 管理用のオファーチェーンリストを取得します。 注意すべてのプロジェクトには、1つの応答で返されるアイテム数に制限があります。デフォルトおよび最大値は1応答あたり10アイテムです。より多くのデータを取得するには、ページネーションのためにlimitとoffsetクエリパラメータを使用してください。 ### オファーチェーンを作成する - [POST /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-create-offer-chain.md): オファーチェーンを作成します。 ### オファーチェーンを削除する - [DELETE /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-delete-offer-chain.md): 特定のオファーチェーンを削除します。 削除後：ユーザーがすでに受け取ったすべての報酬は保持されます。未完了のステップは利用不可になり、その報酬は取得できなくなります。 オファーチェーンの有効/無効切り替えるコールによるオファーチェーンの無効化とは異なり、削除は元に戻すことができず、ユーザーの進捗状況は保持されません。 ### オファーチェーンを取得する - [GET /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-get-offer-chain.md): 管理用の特定のオファーチェーンを取得します。 ### オファーチェーンを更新する - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-update-offer-chain.md): 特定のオファーチェーンを更新するします。 ### オファーチェーンの有効/無効切り替え - [PUT /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle](https://developers.xsolla.com/ja/api/shop-builder/offer-chain-admin/admin-toggle-offer-chain.md): オファーチェーンを有効または無効にします。 オファーチェーンが無効になると、ユーザーは一時的にアクセスできなくなりますが、進行状況は保持されます。 オファーチェーンが再度有効になった後、ユーザーは中断したステップから再開できます。 ## 管理者 ### デイリー報酬のリストを取得する - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-get-daily-chains.md): 管理用にデイリー報酬のリストを取得します。 注意このメソッドはページ分割されたアイテムリストを返します。1 回のレスポンスで返されるアイテム数の上限とデフォルト値は50件です。それ以上のアイテムを取得する場合は、limitおよび offset パラメータを使用して追加のページを取得してください。例：limit = 25、offset = 100を指定した場合、全体リストの 101 件目から始まる 25 件が返されます。 ### デイリー報酬の作成 - [POST /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-create-daily-chain.md): デイリー報酬を作成します。 ### デイリー報酬の削除 - [DELETE /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-delete-daily-chain.md): 特定のデイリー報酬を削除します。 ### デイリー報酬を取得する - [GET /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-get-daily-chain.md): 管理用の特定のデイリー報酬を取得します。 ### デイリー報酬を更新する - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-update-daily-chain.md): 特定のデイリー報酬を更新します。 ### デイリー報酬をリセット - [POST /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-reset-daily-chain.md): デイリー報酬における全ユーザーの進行状況をリセットします。rollingタイプのデイリー報酬にのみ適用されます。 ### デイリー報酬のトグルを切り替える - [PUT /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-admin/admin-toggle-daily-chain.md): デイリー報酬を有効/無効にします。 ## クライアント ### 現在のユーザーのデイリー報酬を取得する - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-client/get-daily-chains-list.md): クライアントエンドポイント。現在のユーザーのデイリー報酬のリストを取得します。 注意このメソッドはページ分割されたアイテムリストを返します。1 回のレスポンスで返されるアイテム数の上限とデフォルト値は50件です。それ以上のアイテムを取得する場合は、limitおよび offset パラメータを使用して追加のページを取得してください。例：limit = 25、offset = 100を指定した場合、全体リストの 101 件目から始まる 25 件が返されます。 ### ID を指定して現在のユーザーのデイリー報酬を取得します。 - [GET /v2/project/{project_id}/user/daily_chain/{daily_chain_id}](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-client/get-user-daily-chain-by-id.md): クライアントエンドポイント。ID を指定して現在のユーザーのデイリー報酬を取得します。 ### デイリー報酬ステップを受け取る - [POST /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim](https://developers.xsolla.com/ja/api/shop-builder/daily-chain-client/claim-user-daily-chain-step-reward.md): クライアントエンドポイント。現在のユーザーがデイリー報酬からステップ報酬を受け取ります。すべてのステップは順番通りにしか受け取ることができません。取り逃したステップの報酬は、仮想通貨や実際通貨、または広告を視聴することで得ることはできません ## 管理者 ### プロジェクトのアップセル情報を入手 - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/shop-builder/upsell-admin/get-upsell-configurations-for-project-admin.md): プロジェクト内のアップセルに関する情報を取得します：アップセルが有効かどうか、アップセルのタイプ、アップセルの一部であるアイテムのSKUリスト。 ### アップセルを作成 - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/shop-builder/upsell-admin/post-upsell.md): プロジェクトのアップセルを作成します。 ### アップセルを更新 - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/shop-builder/upsell-admin/put-upsell.md): プロジェクトのアップセルを更新します。 ### プロジェクトのアップセルをアクティブ化/非アクティブ化 - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/ja/api/shop-builder/upsell-admin/put-upsell-toggle-active-inactive.md): プロジェクト内のアップセルのステータスをアクティブまたは非アクティブに変更します。 ## クライアント ### プロジェクト内のアップセルアイテムのリストを取得する - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/ja/api/shop-builder/upsell-client/get-upsell-for-project-client.md): プロジェクト内のアップセルアイテムがすでに設定されている場合、そのリストを取得します。 ## 管理者 ### アイテムのインポート状況を取得する - [GET /v1/admin/projects/{project_id}/connectors/import_items/import/status](https://developers.xsolla.com/ja/api/shop-builder/connector-admin/get-items-import-status.md): プロジェクトへのアイテムのインポートの進行状況に関する情報を取得します。このAPIコールでは、APIまたはPublisher Account APIを通じて最後に実行されたインポートに関するデータを取得します。 ### JSONファイル経由でアイテムをインポートする - [POST /v1/projects/{project_id}/import/from_external_file](https://developers.xsolla.com/ja/api/shop-builder/connector-admin/import-items-from-external-file.md): 指定したURLを介してJSONファイルからストアにアイテムをインポートします。JSONファイルからのインポートの詳細については、ドキュメントを参照してください。