設定免費增值方案

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

應用程式開發人員可透過「買免」方案,在一段時間內免費使用費率方案,時間長度取決於用量、時間長度或兩者。 除了可調整通知外,您可為任何費率方案類型設定買斷方案。

使用 UI 設定免費加值方案

按照下文說明,為費率方案設定免費增值方案。

邊緣

如要使用 Edge UI 設定免費加值方案,請在建立編輯費率方案時,選取任何費率方案類型 (可調整通知除外), 然後在「Freemium」(免費加值) 專區中啟用免費加值方案,並選取下列其中一個選項:

  • 依用量 (API 呼叫次數) 計費
  • 依時間範圍提供
  • 以先到者為準

根據您的選擇,設定下列一或兩個欄位:

欄位 說明
免費增值使用量 (API 呼叫) 注意:如果選取「依數量提供」或「先到先得」,則必須填寫此欄位。

開發人員免付費的交易數量 (或交易記錄政策中記錄的自訂屬性相關價值)。系統會測量 API 產品的用量。

免費增值時間範圍 注意:如果選取「依時間長度提供」或「先到先得」,則必須填寫這項資訊。

開發人員免付費的時間間隔。例如 30 天。指定數量和單位 (天、週或月)。

Classic Edge (Private Cloud)

如要使用傳統 Edge 使用者介面設定免費加值方案,請按照下列步驟操作:

  1. 選取「Freemium」分頁標籤。

  2. 輸入下列資訊:
    欄位 說明
    免費增值套裝方案?

    免費使用期長度。選取下列其中一個圓形按鈕:

    • 依數量。免費期會根據「數量」欄位中指定的數量計算。
    • 依時間長度。免費期是根據「Freemium Duration」(免費期長度) 欄位中指定的時間間隔計算。
    • 以先到期者為準。達到「數量」欄位中的數量或「免費期長度」欄位中的時間間隔時 (以先發生者為準),免費期就會結束。
    • 否,這不是免費增值方案。此為預設值。
    免費增值方案

    開發人員需付費的交易量 (或交易記錄政策中記錄的自訂屬性相關交易量)。API 套件中所有產品的用量都會計入。輸入音量值,例如 5000。 也就是說,開發人員開始使用方案時,前 5,000 筆交易 (或前 5,000 次使用自訂屬性相關項目) 不會產生費用。只有在「Freemium Package?」(免費增值套裝組合?) 欄位中選取「By Quantity」(依數量) 或「Whichever comes first」(先到先得) 時,這個欄位才會啟用。

    免費增值時間長度

    開發人員免付費的時間間隔。輸入數字並選取時間範圍,例如 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"

如需費率方案選項的完整清單,請參閱費率方案設定