このページは Cloud Translation API によって翻訳されました。

将来の料金プランを作成する

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。詳細

はじめに

既存の料金プランが公開された後、変更できるプロパティは終了日のみです。ただし、次のような変更済みプロパティを含む新しいバージョンのプランを作成することはできます。料金プランのレートを変更できます将来の日付で有効になるようにリビジョンを設定できます。「リビジョンが有効になると、元の料金プランは終了します。

たとえば、有効期限が 2019 年 12 月 31 日の標準料金プランを作成し、 2020 年 1 月 1 日に施行される別のプランに置き換える場合。そのためには将来の料金プランを作成し、2020 年 1 月 1 日から有効になるように設定します。

現在の料金プランに終了日が設定されていない場合は、既存の料金プランを開始日が本日より早くなります現在の料金プランは、公開料金プラン。

デベロッパーには、変更された料金プランが通知されます。従来のプラットフォームをそのリビジョンに自動的に登録されますが、できます。

将来の料金プランは、以下で説明するように、管理 UI または Monetization API を使用して作成できます。説明します。

UI を使用して将来の料金プランを作成する

以下で説明するように、将来の料金プランを作成します。

Edge

料金プランの今後のバージョンを本日より後に開始する次の手順を実施します

[料金プラン] ページで、次の操作を行います。将来の料金プランを作成する料金プランに関連付けられた行にカーソルを合わせます。
料金プランには終了日が必要です。
[+Future] をクリックします。
[将来の料金プラン] セクションで、次のいずれかを選択します。 <ph type="x-smartling-placeholder">
- 新しい発効日に契約期間全体を再開: 将来の料金プランが開始すると、有効になります。将来の料金プランの更新期間は現在の料金プランで異なります
- 発効日の新しい期間から前の契約に費やした時間を差し引く: 発効日に有効になります。現在のは、将来の料金プランの更新期間から差し引かれます。つまりデベロッパーが現在のプランを 3 か月間使用し、更新期間が 3 か月短縮される数か月。

上部パネルで次のフィールドを構成します。
注: 他のフィールドは読み取り専用です。

フィールド	説明	デフォルト	必須
料金プラン名	料金プランの名前。注: 元の料金プランの名前と一致している必要はありません。	既存のプラン名	○
開始日	料金プランが有効になる日付。開始日を入力するか、カレンダーで日付を選択します。	今日	×
終了日	料金プランの終了日。終了日を指定するには、[終了日がある] 切り替えスイッチを有効にして終了日を入力するか、カレンダーで日付を選択します。注: 料金プランは、指定した日の月末まで有効です。たとえば、料金プランを 2018 年 12 月 1 日に期限切れにする場合は、endDate の値を 2018-11-30 に設定する必要があります。この場合、料金プランは 2018 年 11 月 30 日の終わりに期限切れになります。2018 年 12 月 1 日以降のリクエストはすべてブロックされます。	なし	×
ポータルに表示	料金プランが公開か非公開かを設定します。公開料金プランと非公開料金プランをご覧ください。	有効	×

料金プランの料金を構成します。料金の構成をご覧ください。
注: 調整可能な通知プランには適用されません。

複数の API プロダクトを含むプロダクトバンドルを選択する場合は、[特定の料金プランまたは一般的な料金プラン] セクションで次の設定を設定します。
注: このステップは、調整可能な通知プランには適用されません。

フィールド	説明	デフォルト
各プロダクトを個別に設定する	API プロダクトごとに個別の料金プランを構成するかどうかを指定するフラグ。	無効
各プロダクトのフリーミアム特典を個別に設定する	API プロダクトごとにフリーミアムプランを構成するかどうかを指定するフラグ。	無効
プロダクトを選択	一方または両方のフラグを有効にする場合は、プルダウンリストから各プロダクトを個別に選択し、料金プランの詳細を構成する必要があります。注: 商品バンドル内のすべての商品を設定してください。	なし

選択した料金プランのタイプに基づいて、料金プランの詳細を構成します。
<ph type="x-smartling-placeholder">

次のいずれかをクリックします。

ボタン	説明
ドラフトを更新	料金プランを下書きとして保存します。料金プランは、公開するまでアプリデベロッパーには表示されません。下書き料金プランの任意のフィールドを編集できます。
ドラフトを公開	プランを公開します。注: 料金プランを公開した後、終了日を変更できるのは、終了日が未設定の場合のみです。公開後に料金プランを削除することはできませんが、料金プランを期限切れにして、将来の料金プランに置き換えることはできます。詳しくは、公開されている料金プランを期限切れにするをご覧ください。

ボタン

説明

ドラフトを更新

料金プランを下書きとして保存します。

料金プランは、公開するまでアプリデベロッパーには表示されません。下書き料金プランの任意のフィールドを編集できます。

ドラフトを公開

プランを公開します。

注: 料金プランを公開した後、終了日を変更できるのは、終了日が未設定の場合のみです。公開後に料金プランを削除することはできませんが、料金プランを期限切れにして、将来の料金プランに置き換えることはできます。詳しくは、公開されている料金プランを期限切れにするをご覧ください。

Classic Edge（プライベートクラウド）

料金プランの今後のバージョンを本日より後に開始する Classic Edge UI を使用する場合は、次の手順を行います。

パッケージカタログの [Draft/Future] 列の [+Future] をクリックします。新しい料金プランを選択します

将来の料金プランのウィンドウが開きます。

将来の料金プランの期間と現在の料金プランの期間の主な違いは次のとおりです。 [既存のチャンネル登録者]セクションを追加します
他の料金プランの場合と同様に、次のようになります。 <ph type="x-smartling-placeholder">
- [料金プラン名] フィールドにプランの名前を入力します。名前が一致している必要はありません元の料金プランの名前が返されます
- 料金プランの料金の構成（省略可）。
- 選択した料金プランのタイプに基づいて、料金プランの詳細を構成します。 <ph type="x-smartling-placeholder">
  - Freemium
  - レート表
  - 収益分配率
  - 調整可能な通知
- 将来のプランを有効にする日付を指定します（料金プランの公開をご覧ください）。と終了日を設定します（または、開始日を特定の日付に終了する将来の料金プランなど）。現在のプランの終了日が設定されている場合、将来のプランの発効日は現在の期間の終了日より後にするできます
[既存のサブスクライバー] セクションで、次のいずれかを選択します。 <ph type="x-smartling-placeholder">
- 新しい発効日に全契約期間を再開する。将来の料金プランは有効になります。将来の料金プランの更新期間は現在の料金プランで異なります
- 発効日に、前の契約にかかった時間を新しい期間から差し引きます。「発効日に有効になります。現在のは、将来の料金プランの更新期間から差し引かれます。つまりデベロッパーが現在のプランを 3 か月間使用し、更新期間が 3 か月短縮される数か月。
[発効日] フィールドに、終了日より後の開始日を入力します。選択することもできます

API を使用して将来の料金プランを作成する

API を使用して将来の料金プランを作成するには、POST リクエストを次のリクエストを送信します。 /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision。

ここで

{org_id} は組織の名前です。
{package_id} は、API パッケージの ID です。
{plan_Id} は料金プランの ID です。

リビジョンを作成するときは、リクエスト本文で次のプロパティを指定する必要があります。 <ph type="x-smartling-placeholder">

parentRatePlan には、元の料金プランの ID を指定します。
startDate には、新しいプランが有効になる日付を指定します。

将来の料金プランの名前は、元のプランの名前と一致してはなりません。また、すべての料金プランで一意の値が使用されます。元の開始日を開発者は、keepOriginalStartDate フラグを true に設定します。このフラグデフォルトは false です。

設定の詳細については、料金プランの構成。

たとえば、次のリクエストでは将来の料金プランが作成されます。

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password