<ph type="x-smartling-placeholder"></ph>
現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細
既存のデベロッパーが Monetization に移行する必要がある場合:
- 担当するデベロッパーの API プロダクト、API パッケージ、料金プランを作成する 自動的に移行されます。詳細については、次をご覧ください。 <ph type="x-smartling-placeholder">
- 料金プランの公開の説明に沿って、料金プランを公開します。
- アプリ デベロッパーを登録するの説明に沿って、新しいデベロッパーを組織に追加します。
- 前払いアカウントの管理の説明に沿って、各デベロッパーの前払い残高をチャージします。 残高。
- 購入率の説明に沿って、料金プランに同意します。
API を使用してプランを作成します。
注: すでにデベロッパーへの請求が行われている場合に設定料を免除するには、
waivefees
クエリ パラメータをtrue
に追加する。 - 移行するデベロッパーに既存のトランザクションがある場合は、
次のリソースを使用して、トランザクションの使用状況を手動で転送できます。
/organizations/{org_name}/transactions
({org_name}
は 組織名を入力します。注: デベロッパーに既存の取引がない場合は、この手順をスキップできます。 示します。
transactions
リソースは、 新しい値を反映するようにすべての内部カウンタを更新します。たとえば、移行前にデベロッパーが 1,000 回の API 呼び出しを発行した場合、 現在のアクティビティをキャプチャするには、
transactions
リソースを作成し、batchSize
プロパティを 1,000 に設定します。 作成します。次の表に、Google Cloud コンソールで指定できる構成プロパティ トランザクションの数、デフォルト値、トランザクションの有無を 必須ではありません。
プロパティ 説明 デフォルト 必須 application
デベロッパー アプリの ID。
なし ○ batchSize
転送するトランザクションの数。
1 いいえ custAttn
カスタム属性の値。batchSize で トランザクションの使用状況を表します。
メッセージのカスタム属性番号は正の整数で指定してください または、小数点(小数点以下は 4 桁まで)の値。負の値は使用できません。
カスタム属性は次の場所で定義する必要があります。
- API プロダクトのトランザクション記録ポリシー。詳細については、 トランザクション記録ポリシーをご覧ください。
- API プロダクトの有効な料金プラン。詳細については、 カスタム属性を含む料金プランをご覧ください。
なし ○ product
API プロダクトの ID。
なし ○ type
CHARGE
(デフォルト)に設定する必要があります。CHARGE
いいえ 検証手順をスキップしてトランザクション数を強制的に設定するには、
force
クエリ パラメータをtrue
にマッピング(例:?force=true
)。デフォルトでは、?force=false
と検証ステップは 実行されます。(例: 前払いデベロッパーのアカウントの残高とアクティビティがない場合) 一時停止され、?force=false
の場合、リクエストは検証中に失敗します。たとえば、次のリクエストでは、指定されたトランザクションのトランザクション数を 50 に設定しています。 API プロダクト:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize":50 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password
次のリクエストでは、指定したアプリケーションのトランザクション使用量を 12.5 に設定しています。 API プロダクト。リクエストでは、
batchSize
が125
に設定され、値が API プロダクトに定義された最初のカスタム属性が、0.1
に設定されます。日時 掛け合わせると、125 × 0.1 は 12.5 です。$ curl -H "Content-Type:application/json" -X POST -d \ '{ "application":{ "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b" }, "product":{ "id":"testproduct" }, "batchSize": 125, "custAtt1" : 0.1 }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password
- 必要な設定料金や定期的な料金がデベロッパーに請求されていない場合は、手動で
次のリソースを使用して、料金プランの設定料金または定期的な料金を請求します。
/organizations/{org_name}/transactions
({org_name}
は 組織名を入力します。注: セットアップ料金や定期的な料金がデベロッパーにすでに請求されている場合は、 スキップします
transactions
リソースを呼び出しても、設定や 定期的な料金の支払いが発生します。次の表に、Google Cloud コンソールで指定できる構成プロパティ リクエスト本文は、料金プランの設定料金または定期的な料金を手動で請求します。 必須かどうかを指定できます
プロパティ 説明 デフォルト 必須 currency
料金プランで使用される通貨。通貨の ISO 4217 コードを指定します(例: 米ドルの場合は usd、スイス フランの場合は chf です。
なし ○ developer
デベロッパーの ID。
なし ○ rate
設定料金または定期的な請求料金。
なし ○ ratePlan
料金プランの ID。
なし ○ type
SETUPFEES
またはRECURRINGFEES
に設定します。CHARGE
○ 検証手順をスキップして料金を強制的に請求するには、
force
クエリを設定します。 パラメータをtrue
に設定します(例:?force=true
)。デフォルトでは?force=false
と検証ステップが実行されます。たとえば、前払いの デベロッパーの残高がゼロで、そのアカウントに対するアクティビティが強制停止される場合、?force=false
: 検証中にリクエストが失敗します。たとえば、次のリクエストでは、セットアップ料金として 10 米ドルが請求されます。 料金プランに登録したデベロッパー:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "developer":{ "id":"dev1@myorg.com" }, "currency":{ "id":"usd" }, "ratePlan":{ "id":"mypackage_rateplan1" }, "rate":10, "type":"SETUPFEES" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \ -u email:password