設定免費增值方案

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件

免費增值方案可讓應用程式開發人員根據用量、持續時間或兩者來免費使用一段時間。您可以為任何費率方案類型設定免費增值方案,但可調整的通知除外。

透過使用者介面設定免費增值方案

按照以下說明建立房價方案免費增值方案。

邊緣

如要在建立費率方案時使用 Edge UI 設定免費增值方案,請選取「費率」或「編輯」費率方案類型。接著,在「免費增值通知」部分選取免費費率方案,然後選取下列其中一個選項:

  • 優惠用量 (API 呼叫次數)
  • 依時段提供優惠
  • 兩者取其先

請根據您的選項,設定下列其中一或兩個欄位:

欄位 說明
免費使用量 (API 呼叫) 注意:如果選取「優惠數量」或「兩者皆適用」,則為必要欄位。

開發人員未收取的交易數量 (或交易記錄政策中記錄的自訂屬性值)。系統會計算 API 產品的數量。

免費增值時段 注意:如果選取 [優惠持續時間] 或 [優先提供],則為必要欄位。

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

傳統版 Edge (私有雲)

如何使用傳統版 Edge UI 設定免費增值方案:

  1. 選取「免費增值」分頁。

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

    免費額度。選取下列其中一個圓形按鈕:

    • 數量。免費試用期是以「磁碟區」欄位中指定的數量為準。
    • 時間長度。免費試用期是根據在「免費時間時間」欄位中指定的時間間隔為準。
    • (兩者取其先)。當「音量」欄位中的數量或「免費增值持續時間」欄位中的時間間隔 (兩者取其先) 時,免費試用期就會結束。
    • 否。這不是免費增值方案。此為預設值。
    免費增值服務

    向開發人員收取的交易量 (或交易記錄政策中記錄的自訂屬性數量)。這個量是測量 API 套件中所有產品的量。輸入音量數字,例如 5000。 也就是說,開發人員開始執行方案時,不必針對前 5,000 筆交易進行交易 (或前 5,000 次使用自訂屬性相關商品)。只有在「免費套件」欄位中選取「按數量」或「兩者最高」時,才會啟用這個欄位。

    免費增長

    開發人員不收費的時間。輸入數字並選取時間範圍,例如 1 個月。也就是說,開發人員在購買方案開始日期後的 1 個月內無須付費。只有在「freem Package」欄位中選取「By Duration」或「Neverever first」後,才能啟用這個欄位。

使用 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"

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