# LiveOps 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 LiveOps APIは、プレイヤーエンゲージメントを高めるためのエンドポイントを提供します。 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 [LiveOps API](https://developers.xsolla.com/_bundle/@l10n/ja/api/liveops/index.yaml) ## 通常 ### プロモーションをアクティブ化にする - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/activate](https://developers.xsolla.com/ja/api/liveops/promotions-common/activate-promotion.md): プロモーションをアクティブ化にします。 ### プロモーションを停止 - [PUT /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate](https://developers.xsolla.com/ja/api/liveops/promotions-common/deactivate-promotion.md): プロモーションを停止にします。 ### プロモーションコードを検証する - [GET /v2/project/{project_id}/promotion/code/{code}/verify](https://developers.xsolla.com/ja/api/liveops/promotions-common/verify-promotion-code.md): コードがプロモーションコードであるかクーポンコードであるか、およびユーザーがそれを適用できるかどうかを決定します。 ### すべてのプロモーションリストを取得 - [GET /v3/project/{project_id}/admin/promotion](https://developers.xsolla.com/ja/api/liveops/promotions-common/get-promotion-list.md): プロジェクトのプロモーションリストを取得します。 ### コードで引き換え可能なプロモーションを入手する - [GET /v3/project/{project_id}/admin/promotion/redeemable/code/{code}](https://developers.xsolla.com/ja/api/liveops/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/liveops/promotions-coupons/get-coupon-code-limit.md): コードの残り使用可能回数を取得します。コードのフィルタリングには、codesクエリパラメータを使用します。 コードの上限を設定するには、管理セクションに移動します： * クーポン ### クーポンプロモーションをアクティブ化にする - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/activate](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/activate-coupon.md): クーポンプロモーションをアクティブ化にします。 作成されたクーポンのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、クーポンのプロモーションをアクティブ化にします。 ### クーポンコードを取得 - [GET /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/get-coupon-codes.md): クーポンコードを取得します。 ### クーポンコードを作成 - [POST /v2/project/{project_id}/admin/coupon/{external_id}/code](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/create-coupon-code.md): クーポンコードを作成します。 ### クーポンコードを生成 - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/code/generate](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/generate-coupon-codes.md): クーポンコードを生成します。 ### クーポンプロモーションを非アクティブ化にする - [PUT /v2/project/{project_id}/admin/coupon/{external_id}/deactivate](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/deactivate-coupon.md): クーポンプロモーションを非アクティブ化にします。 作成されたクーポンのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、クーポンのプロモーションを無効化または非アクティブ化します。 ### 指定したユーザーのクーポン上限を取得する - [GET /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/promotions-coupons/redeem-coupon.md): クーポンコードを引き換えます。クーポンが引き換えられた後、ユーザーはボーナスを得ることができます。 ### クーポンプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/get-coupons.md): プロジェクトのクーポンプロモーションのリストを取得します。 ### クーポンプロモーションを作成 - [POST /v3/project/{project_id}/admin/coupon](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/admin-create-coupon.md): クーポンプロモーションを作成します。 ### クーポンプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/delete-coupon-promotion.md): クーポンプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログに適用されなくなります。 削除後、プロモーションを復元することはできません。 削除されたプロモーションのクーポンコードは、既存のプロモーションに追加することができます。 ### クーポンプロモーションを取得 - [GET /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/liveops/promotions-coupons/get-coupon.md): 指定されたクーポンプロモーションを取得します。 ### クーポンプロモーションを更新 - [PUT /v3/project/{project_id}/admin/coupon/{external_id}](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/promotions-promo-codes/activate-promo-code.md): プロモーションコードのプロモーションをアクティブ化にします。 作成されたプロモーションコードのプロモーションは、デフォルトで無効になっています。 アクティブ化されるまで、引き換えの準備ができません。 このエンドポイントを使用して、プロモーションコードのプロモーションを有効化またはアクティブ化します。 ### プロモーションコードのプロモーション用のコードを取得 - [GET /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/get-promocode-codes.md): プロモーションコードのプロモーション用のコードを取得します。 ### プロモーションコードのプロモーション用のコードを作成 - [POST /v2/project/{project_id}/admin/promocode/{external_id}/code](https://developers.xsolla.com/ja/api/liveops/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/liveops/promotions-promo-codes/generate-promo-code-codes.md): プロモーションコードのプロモーション用のコードを生成します。 ### プロモーションコードのプロモーションを非アクティブ化 - [PUT /v2/project/{project_id}/admin/promocode/{external_id}/deactivate](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/promotions-promo-codes/redeem-promo-code.md): プロモーションコードを引き換えます。 プロモーションコードを引き換えた後、ユーザーは無料でアイテムを入手したり、カートや特定のアイテムの価格を下げたりすることができます。 ### カートからプロモーションコードを削除 - [PUT /v2/project/{project_id}/promocode/remove](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/remove-cart-promo-code.md): プロモーションコードをカートから削除します。 プロモーションコードを削除した後、カート内のすべてのアイテムの合計金額は、プロモーションコードによるボーナスや割引を除いて再計算されます。 ### プロモーションコードのプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/get-promo-codes.md): プロジェクトのプロモーションコードリストを取得します。 ### プロモーションコードのプロモーションを作成 - [POST /v3/project/{project_id}/admin/promocode](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/create-promo-code.md): プロモーションコードのプロモーションを作成します。 ### プロモーションコードのプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/delete-promo-code.md): プロモーションコードのプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消える。 * アイテムカタログとカートに適用されなくなる。 削除後、プロモーションを復元することはできません。 削除されたプロモーションのプロモーションコードを既存のプロモーションに追加できます。 ### プロモーションコードのプロモーションを取得 - [GET /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/liveops/promotions-promo-codes/get-promo-code.md): 指定されたプロモーションコードを取得します。 ### プロモーションコードのプロモーションを更新 - [PUT /v3/project/{project_id}/admin/promocode/{external_id}](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/promotions-unique-catalog-offers/deactivate-unique-catalog-offer.md): ユニークなカタログオファープロモーションを非アクティブ化にします。 作成されたユニークなカタログオファープロモーションは、デフォルトでは無効になっています。 アクティブ化するまで引き換えることはできません。 このエンドポイントを使用して、クーポンプロモーションを無効化および非アクティブ化します。 ### ユニークなカタログオファープロモーションのリストを取得します。 - [GET /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ja/api/liveops/promotions-unique-catalog-offers/get-unique-catalog-offers.md): プロジェクトのユニークなカタログオファープロモーションのリストを取得します。 ### ユニークなカタログオファープロモーションを作成する - [POST /v3/project/{project_id}/admin/unique_catalog_offer](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/promotions-discounts/get-item-promotion-list.md): プロジェクトのアイテムプロモーションのリストを取得します。 プロモーションは、アイテムの割引（％）を提供します。 指定したアイテムの全価格に割引が適用されます。 ### アイテムの割引プロモーションを作成 - [POST /v3/project/{project_id}/admin/promotion/item](https://developers.xsolla.com/ja/api/liveops/promotions-discounts/create-item-promotion.md): アイテムの割引キャンペーンを作成します。 キャンペーンは、アイテムの割引（％）を提供します。 指定したアイテムの全価格に割引が適用されます。 ### アイテムプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/liveops/promotions-discounts/delete-item-promotion.md): 割引プロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログとカートに適用されなくなります。 削除後、プロモーションは復元できません。 ### アイテムプロモーションを取得 - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/liveops/promotions-discounts/get-item-promotion.md): 特定のアイテムに適用されるプロモーションを取得します。 プロモーションは、商品の割引（％）を提供します。 指定した商品の全価格に割引が適用されます。 ### アイテムプロモーションを更新する - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/item](https://developers.xsolla.com/ja/api/liveops/promotions-discounts/update-item-promotion.md): プロモーションを更新します。 注意新しいデータは古いデータに取って代わります。プロモーションの一部だけを更新したい場合は、必要なデータもすべてリクエストで転送する必要があります。 プロモーションは、商品の割引（％）を提供します。 指定した商品の全価格に割引が適用されます。 ## ボーナス このAPIを使用すると、ボーナスプロモーションを管理できます。 ### ボーナスプロモーションのリストを取得 - [GET /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ja/api/liveops/promotions-bonuses/get-bonus-promotion-list.md): プロジェクトのボーナスプロモーションのリストを取得します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを作成 - [POST /v3/project/{project_id}/admin/promotion/bonus](https://developers.xsolla.com/ja/api/liveops/promotions-bonuses/create-bonus-promotion.md): ボーナスプロモーションを作成します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを削除 - [DELETE /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/liveops/promotions-bonuses/delete-bonus-promotion.md): ボーナスプロモーションを削除します。削除されたプロモーション： * プロジェクトで設定されたプロモーションのリストから消えます。 * アイテムカタログとカートに適用されなくなります。 削除後、プロモーションを復元することはできません。 ### ボーナスプロモーションを取得 - [GET /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/liveops/promotions-bonuses/get-bonus-promotion.md): ボーナスプロモーションを取得します。 プロモーションは、ユーザーによる購入に無料のボーナスアイテムを追加します。 プロモーションは、プロジェクト内のすべての購入、または特定のアイテムを含む購入に適用することができます。 ### ボーナスプロモーションを更新 - [PUT /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus](https://developers.xsolla.com/ja/api/liveops/promotions-bonuses/update-bonus-promotion.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/liveops/personalized-catalog/get-filter-rules.md): ユーザー属性に適用されるすべてのルールを取得します。 ### カタログフィルタルールを作成 - [POST /v2/project/{project_id}/admin/user/attribute/rule](https://developers.xsolla.com/ja/api/liveops/personalized-catalog/create-filter-rule.md): ユーザー属性のルールを作成します。 ### クライアントサイドで検索するためのすべてのカタログルールを取得します - [GET /v2/project/{project_id}/admin/user/attribute/rule/all](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/personalized-catalog/update-filter-rule-by-id.md): ユーザー属性に適用される特定のルールを更新します。指定されていないプロパティはデフォルト値が使用されます（プロパティが必須でない場合）。 ## 管理 ### 指定したユーザーのプロモーション制限をすべて更新する - [DELETE /v2/project/{project_id}/admin/user/limit/promotion/all](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/reward-chain-value-points-admin/admin-toggle-reward-chain.md): 報酬チェーンを有効/無効にします。 ## クライアント ### 現在のユーザーの報酬チェーンを取得する - [GET /v2/project/{project_id}/user/reward_chain](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/clan-reward-chain-client/user-clan-update.md): ユーザー属性を通じて現在のユーザーのクランを更新します。以前のクランで請求されなかった報酬チェーンのすべての報酬を請求し、応答に返します。クランに所属していたユーザーが、現在はクランに所属していない場合、クランへの所属は取り消されます。ユーザーがクランを変更した場合、クランは変更されます。 ## 管理者 ### デイリー報酬のリストを取得する - [GET /v2/project/{project_id}/admin/daily_chain](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/daily-chain-admin/admin-toggle-daily-chain.md): デイリー報酬を有効/無効にします。 ## クライアント ### 現在のユーザーのデイリー報酬を取得する - [GET /v2/project/{project_id}/user/daily_chain](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/daily-chain-client/claim-user-daily-chain-step-reward.md): クライアントエンドポイント。現在のユーザーがデイリー報酬からステップ報酬を受け取ります。すべてのステップは順番通りにしか受け取ることができません。取り逃したステップの報酬は、仮想通貨や実際通貨、または広告を視聴することで得ることはできません ## 管理者 ### オファーチェーンのリストを取得する - [GET /v2/project/{project_id}/admin/offer_chain](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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/liveops/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/liveops/offer-chain-admin/admin-toggle-offer-chain.md): オファーチェーンを有効または無効にします。 オファーチェーンが無効になると、ユーザーは一時的にアクセスできなくなりますが、進行状況は保持されます。 オファーチェーンが再度有効になった後、ユーザーは中断したステップから再開できます。 ## クライアント ### 現在のユーザーのオファーチェーンを取得する - [GET /v2/project/{project_id}/user/offer_chain](https://developers.xsolla.com/ja/api/liveops/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/liveops/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/liveops/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/liveops/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アドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ## payment-client-side ### 有料のオファーチェーンステップの注文を作成する - [POST /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order](https://developers.xsolla.com/ja/api/liveops/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アドレスは国を特定するために使用され、それが通貨や利用可能な決済方法に影響を与えます。このメソッドをサーバーサイドから使用すると、通貨の検出が不正確になり、ペイステーションでの決済方法に影響を与える可能性があります。 注意 有料のオファーチェーンステップにのみ、この呼び出しを使用してください。 無料ステップの場合は、代わりに無料オファーチェーンステップを請求するコールを使用してください。 ## 管理者 ### プロジェクトのアップセル情報を入手 - [GET /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin.md): プロジェクト内のアップセルに関する情報を取得します：アップセルが有効かどうか、アップセルのタイプ、アップセルの一部であるアイテムのSKUリスト。 ### アップセルを作成 - [POST /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/liveops/upsell-admin/post-upsell.md): プロジェクトのアップセルを作成します。 ### アップセルを更新 - [PUT /v2/project/{project_id}/admin/items/upsell](https://developers.xsolla.com/ja/api/liveops/upsell-admin/put-upsell.md): プロジェクトのアップセルを更新します。 ### プロジェクトのアップセルをアクティブ化/非アクティブ化 - [PUT /v2/project/{project_id}/admin/items/upsell/{toggle}](https://developers.xsolla.com/ja/api/liveops/upsell-admin/put-upsell-toggle-active-inactive.md): プロジェクト内のアップセルのステータスをアクティブまたは非アクティブに変更します。 ## クライアント ### プロジェクト内のアップセルアイテムのリストを取得する - [GET /v2/project/{project_id}/items/upsell](https://developers.xsolla.com/ja/api/liveops/upsell-client/get-upsell-for-project-client.md): プロジェクト内のアップセルアイテムがすでに設定されている場合、そのリストを取得します。