サブスクリプションベースの製品とプラングループを設定する方法

サブスクリプションベースの製品は、ユーザーがサブスクリプションを購入したときに提供されるサービスまたはサービスのセットです。製品作成は、異なるサービスのために別々のサブスクリプションを販売するように設定する場合、またはユーザーが同時に複数のサブスクリプションを取得できるようにする場合に必要です。ストリーマーのチャンネル、ゲーム、または固有のアイテム/固有の能力へのサブスクリプションベースの製品アクセスの例。

プランのグループは、同じgroup_idパラメータ値を持つプランのセットです。このgroup_idパラメータは、プランのグループを形成し、このグループをサブスクリプションベースの製品に関連付けるために使用されます。プランのグループを作成すると、次のことが可能になります：

• 製品サブスクリプションとして選択できるプランの数を制限する
• ユーザーがグループ内の別のプランに切り替えられるようにする

グループ、プラン、および製品は、以下のルールに従って相互に連携します：

• 1つのプランは1つのグループにしか属せません。
• 1つの製品を1つのグループのみに基づいて作成できます。
• 1つのグループを複数の製品にリンクできます。

サブスクリプションベースの製品およびプラングループを作成するには、以下のパラメータを製品の作成APIコールに渡します：

• name製品の名前
• group_idプラングループの名前で

すべての製品を変更、削除、またはリストを取得するには、対応するAPIコールを使用します：

• 製品の更新
• 製品の削除

• 製品の取得

プランをプラングループと製品にリンクするには、プラングループの名前を含むgroup_idパラメータを更新のプランAPIコールに渡します。グループを削除するには、“group_id”:nullを渡してください。

製品にリンクされたプランを購入するときに決済インターフェイスを開くには、次のパラメータをトークンを作成するAPIコールに渡します：

• プランID付きのpurchase.subscription.plan_id

• group_id経由でプランに関連付けられた製品のIDを持つpurchase.subscription.product_id

例

• 1つのサブスクリプションオプションだけでゲームアクセスを販売したい場合は、サブスクリプションプランを設定する必要がありますが、製品を設定する必要はありません。
• 1ヶ月と3ヶ月など、異なる条件でゲームへのアクセスを販売したい場合は、適切な条件で2つのサブスクリプションプランを設定する必要があります。製品を設定する必要もありません。プランにはデフォルトで“group_id”:nullパラメータがあります。つまり、プランは一般グループに含まれます。ユーザーは、サブスクリプションを購入する時にこれらのプランを自由に選択し、プランの切り替えもできるようになります。
• 1ヶ月、3ヶ月のゲームへのアクセスだけでなく、例えば6ヶ月の剣のアップグレードなど、追加のサブスクリプションも売りたい場合：
  1. 製品ごとに固有のnameパラメータとgroup_idパラメータを製品の作成APIコールに渡すことで、2つの製品「ゲーム」と「剣」を作成します。
  2. 次のいずれかの方法で、1、3、および6ヶ月のプランを作成します：
     • アドミンページでプランをセットアップし、更新のプランAPIコールを使用して、製品group_idパラメータ「ゲーム」をゲームの販売のためのサブスクリプションプランに渡し、製品group_idパラメータ「剣」を剣の販売のためのサブスクリプションプランプランに渡します。
     • プランの作成APIコールを使用し、プランに関するデータと、ゲームを販売するためのサブスクリプションプランには「ゲーム」製品のgroup_idパラメータを、剣を販売するためのサブスクリプションプランには「剣」製品のgroup_idパラメータを渡します。
  3. ストアインターフェースに「ゲーム定期購入」「刀剣アップグレード定期購入」製品の表示を実装します。

最終更新日: 2024年7月31日