您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
免費增值方案可讓應用程式開發人員在一段時間內免費使用費率方案，具體取決於用量和/或時間長度。 您可以為任何費率方案類型設定免費增值方案，但可調整通知除外。
透過 UI 設定免費增值方案
為費率方案設定免費增值方案，詳情請見下方說明。
Edge
如要在建立或編輯費率方案時，使用 Edge UI 設定免費增值方案，請選取任何費率方案類型 (可調整通知除外)，然後在「免費增值」部分啟用免費增值方案，並選取下列其中一個選項：
- 按用量提供 (API 呼叫次數)
- 優惠 (按期間劃分)
- 先達到者
根據您的選擇，設定以下其中一個欄位或同時設定兩者：
| 欄位 | 說明 |
|---|---|
| 免費增值用量 (API 呼叫) | 注意：如果選取「依數量提供優惠」或「先採用者」，則為必填。
開發人員無須支付費用的交易 (或與交易記錄政策中記錄的自訂屬性相關價值) 數量。系統會測量 API 產品的數量。 |
| 免費增值期 | 注意：如果您選取「優惠期限」或「先採用者」，則為必填屬性。
開發人員不收費的時間間隔。例如 30 天。指定數字和單位 (日、週或月)。 |
傳統邊緣 (Private Cloud)
如何使用傳統版 Edge UI 設定免費增值方案：
- 選取 [Freemium] 標籤。
- 輸入下列資訊：
欄位 說明 有免費增值禮包？ 免費期間的範圍。選取下列其中一個圓形按鈕：
- 依數量。免費期間是根據「磁碟區」欄位中指定的數量而定。
- 依據時間長度。免費期限是依據「Freemium Duration」欄位中指定的時間間隔。
- 先從何者開始。只要「磁碟區」欄位中的數量或達到 Freemium Duration 欄位的時間間隔 (兩者取其先)，就會結束免費週期。
- 否，這不是免費增值方案。此為預設值。
免費增值量 開發人員須支付的交易量 (或交易記錄政策中記錄的自訂屬性相關量)。系統會評估 API 套件中所有產品的用量。輸入音量數字，例如 5000。 也就是說，開發人員開始製定方案時，系統不會針對前 5000 筆交易 (或前 5, 000 次使用自訂屬性相關項目使用) 收費。只有在「免費增值方案套件」欄位中選取「依數量」或「先發生者」，才能啟用這個欄位。
免費增值時間 開發人員不收費的時間間隔。輸入數字並選取時間範圍，例如 1 個月。也就是說，開發人員不必支付購買方案開始日期後的 1 個月費用。只有在「免費增值方案套件」欄位中選取「依時間長度」或「先發生者」，才能啟用這個欄位。
使用 API 為費率方案設定免費增值方案
你可以在建立或更新房價方案時新增免費增值方案。您可以在呼叫的要求主體中指定免費增值屬性。
舉例來說，下列要求會建立標準費率方案，並將免費增值期設為 30 天。(免費增值相關規格則醒目顯示)。
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Simple rate plan",
"currency": {
"id" : "usd"
},
"description": "Simple rate plan",
"displayName" : "Simple rate plan",
"freemiumDuration": "30",
"freemiumDurationType": "DAY",
"monetizationPackage": {
"id": "location_package"
},
"organization": {
"id": "{org_name}
},
"published": "true",
"ratePlanDetails": [
{
…
}
],
"startDate": "2013-09-15",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password
如要指定以免費增值為主的數量 (例如涉及 API 套件的交易次數，或與交易記錄政策中記錄的自訂屬性相關的磁碟區)，請將其指定為免費增值單位的數量。舉例來說，下列屬性指派作業會指定免費增值單位是按照 5000 個免費增值單位計算：
"freemiumUnit": "5000"
如需費率方案選項的完整清單，請參閱「費率方案設定」。