設定價目表方案

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

簡介

使用價目表方案時,我們會向開發人員收取每筆交易的費用。針對這類企劃書 必須提供更多詳細資料,例如收費模式和收費模式。

您也可以為個別產品 (而非 API) 指定免費增值方案 套件) - 僅適用於產品專屬的方案。

系統何時會向你收取週期性費用和套裝組合方案?

費率方案可包含週期性費用與 API 套裝組合 (磁碟區頻帶和套裝組合方案), 兩者皆包含收費的特定時間,以及套裝組合方案重設為零。 下表說明系統何時會收取週期性費用及重設套裝組合數量。如果 開發人員應用程式無法再次呼叫 API,因為這類應用程式會 也就是 API 呼叫歸零、應用程式交易限制 才能再次撥打電話

如果計畫: ...發生這個情況
  • 已將非零的週期性費用設為「Month」
  • 音量頻帶或套裝組合方案

週期性費用和套裝組合方案會在每月第一天重設 (預設值)。

如需每月週期性的費率方案,請使用管理頁面 API,並使用 RecurringStartUnit 屬性表示日期 (如上所述) 請參閱「使用 API 建立費率方案」一文。

  • 已將非零的週期性費用設為「週」
  • 音量頻帶或套裝組合方案
週期性費用和套裝組合方案會在開發人員費率的 7 天後重設 方案開始日期。
  • 已將非零的週期性費用設為「Day」
  • 音量頻帶或套裝組合方案
週期性費用和套裝組合方案會在以下日期後每 X 天重設一次 開發人員的費率方案開始日期。
  • 無 (或零美元) 週期性費用
  • 音量頻帶或套裝組合方案

系統會根據價目表定義的匯總基準,重設套裝組合方案。適用對象 舉例來說,假設開發人員在當月 19 日開始費率方案,而匯總函式 基礎為每 1 個月進行一次,之後的套裝組合用量會在每月 19 日重設。

注意:每個月的日子不一定相同。舉例來說 方案的開始日期為 12 月 31 日,非閏年則會變成 28 日 2 月,因為 2 月只有 28 天。第 28 天則維持不變 。

設定價目表方案時,請使用 使用者介面

按照下文說明設定價目表方案。

Edge

如要設定價目表方案,請在建立編輯時設定。 費率方案,請選取「價目表」或「價目表和收益分潤」費率方案類型,然後在「價目表」部分中選取下列其中一種收費模式:

充電模式 說明
固定費率 開發人員必須針對每筆交易支付固定費率,
寬頻音量 視交易量而定,開發人員必須支付變動費率。
套裝組合 我們會向開發人員預先收取每筆交易的固定金額費用。無論是否完全使用套裝組合,開發人員一律都會收取指定金額。

注意:選取「價目表」和「收益分潤」時,無法使用這個選項。

然後根據所選的充電模式設定下列資訊。

充電模式 欄位 說明
全部 計算頻率 計算交易量 (或自訂屬性相關數量) 的期間。選取月數 (1 到 24 個月)。
固定費率 固定費率 每筆交易的收費費率。請輸入十進位數字 (最多到小數點後四位數)。

注意:您可以設定可透過 API (而非 UI) 計費的小數位數。詳情請參閱「設定費率方案費率的小數位數」。

舉例來說,假設你輸入 0.10,而幣別為美元,則開發人員須為每筆交易支付 $0.10 美元 (或根據交易中傳輸的位元組數等自訂屬性,向開發人員收取指定位元組數的 $0.10 美元)。

寬頻音量 音量頻帶 以音量頻帶充電模式來說,交易量 (或根據客戶屬性計算) 的一或多個範圍 (每個範圍皆為「音量頻帶」)。每個音量頻帶都可以指定費率。該費率適用於適用音量頻帶的所有交易。指定第一個錶帶的上限,例如最多 1000 個 (下限為大於 0)。

按一下「+ 新增」即可新增其他錶帶。

將最後一個錶帶上限留空,表示此等級以上的所有交易。

注意:您可以設定可透過 API (而非 UI) 計費的小數位數。詳情請參閱「設定費率方案費率的小數位數」。

舉例來說,如果您在「音量錶帶」部分 (>0-1000 和 1000 及以上) 中指定了兩個音量頻帶,則 >0-1000 音量頻帶可輸入 0.15,而 1000 及以上音量腕帶則輸入 0.10。如果選取的貨幣是美元,那麼前 1,000 筆交易的匯率為每次交易的 $0.15 美元,而交易超過 1,000 筆交易時,每筆交易的匯率都是 $0.10 美元。

套裝組合 API 套裝組合價格 組合中的交易次數 (或與自訂屬性相關的數字,例如套裝組合中傳輸的位元組總數)。每個套裝組合都可以指定價格。價格會套用至整個套裝組合。指定第一個套裝組合的上限,例如最多 1000 個 (下限預設為大於 0)。

按一下「+ 新增」即可新增更多組合。你必須指定最後一個套裝組合上限,除非您想向開發人員收取最後一個套裝組合中不限交易次數的固定金額。

注意:您可以設定可透過 API (而非 UI) 計費的小數位數。詳情請參閱「設定費率方案費率的小數位數」。

舉例來說,如果您在「套裝組合大小」部分指定兩個套件 (大於 0 到 1000,且大於 1000,最多 2000),那麼針對數量大於 0 的組合,可以為大於 0 的組合輸入 50,而數量大於 1000 的組合時則輸入 40。如果所選貨幣是美元,第一個套裝組合的價格為 $50 美元,第二個套裝組合的價格為 $40 美元。無論開發人員在套裝組合中使用的交易次數為何,開發人員一律都會依適用的套裝組合價格支付費用 (也就是說,開發人員會在套裝組合中的第一筆交易完成後,立即收取套裝組合價格)。

如果您已為 API 產品定義自訂屬性,就可以設定自訂評分參數,根據每筆交易中的自訂屬性向應用程式開發人員收費。舉例來說,如果您的方案是根據開發人員的每筆交易向開發人員收費,可以根據自訂屬性 (例如後端傳輸的位元組數 (可能會因交易而異)) 設定方案費率。

在這種情況下,請選取「使用自訂評分參數」,然後從下拉式清單中選取自訂屬性。詳情請參閱使用自訂屬性設定費率方案

傳統版 Edge (Private Cloud)

如何使用傳統版 Edge UI 設定價目表方案:

  1. 按照步驟建立費率方案
  2. 在「費率方案類型」下拉式選單中選取「價目表」,即可設定收益模式
  3. 如果所選 API 套件包含多個 API 產品,請選取下列其中一個選項:

    注意:如果 API 套件包含單一 API 產品,您可以略過這個步驟。

    • 產品專屬方案:為每項 API 產品分別設定費率方案詳細資料。
    • 所有產品的一般方案:為所有 API 產品設定費率方案詳細資料。
  4. 按一下一般費率方案或各 API 產品專屬費率方案的「價目表」

    注意:設定 API 產品專屬方案時,您必須設定價目表方案 以及個別的 API 產品

    系統會隨即開啟「價目表」視窗。

  5. 為 API 產品設定免費增值方案,免費增值方案可讓開發人員免費使用 特定期間的 API 產品,或視用量而定。

    輸入下列資訊:

    欄位 說明
    免費增值產品?

    免費試用期的期間。選取下列其中一個圓形按鈕:

    • 數量。免費週期取決於磁碟區中指定的數量 ] 欄位。
    • 依據時間長度。費用週期是以 自由時間長度欄位。
    • 無論先發生哪種情況,免費試用期的截止日期為 磁碟區欄位或「Freemium Duration」欄位中的時間間隔 兩者取其先
    • 否,這不是免費增值方案,此為預設值。
    免費增值量

    交易量 (或與記錄中自訂屬性相關的量) 則無需向開發人員收費。磁碟區為 對 API 產品進行測量。輸入音量號碼,例如 5000。也就是說 當開發人員開始參與方案後,他們不必支付前 5, 000 筆交易的費用 (或是自訂屬性相關項目的前 5000 種使用情形)。這個欄位 必須選取「依數量」才會啟用或「以哪個方式優先」在「Freemium」中 產品?」] 欄位。

    免費增值時長

    系統不會向開發人員收費的時間間隔。請輸入數字 選取時間範圍,例如 [1 個月]。也就是說,開發人員 系統會收取 1 個月的費用。您必須選取 [依時間長度],才能啟用這個欄位或 「以哪個方式優先」「免費增值產品?」] 欄位。

  6. 選取下列其中一種充電模式:
    • 固定費率。在這個模式下,我們會向開發人員收取每一筆交易的固定費率 交易。
    • 音量大小。在此模型中,系統會根據開發人員的 交易量
    • 套裝組合。在此模式下,我們會向開發人員收取一筆固定費用 交易組合無論套裝組合為何,開發人員都必須收取指定金額 例如圖片、提示、說明和圖片

    固定費率模式:請在英國的「定價」部分輸入下列資訊: 一般價目表視窗:

    欄位 說明
    業者 (或機構)

    貴機構的名稱。這個欄位是預設的運算子 (或稱「運算子」), ) 欄位值。

    國家/地區

    貴機構的營運國家/地區。這個欄位預設為使用 機構設定檔中的國家/地區欄位值。

    固定費率

    每筆交易的收費費率。請輸入十進位數字 (最多 4 位數) )

    注意:您可以設定可以指定的小數位數 收取使用 API (而非 UI) 收費。詳情請參閱設定 費率方案費率的小數位數。

    舉例來說,假設您輸入 0.10,貨幣為美元,則開發人員即為 系統會向您收取每筆交易 $0.10 美元的費用 (或根據「 在交易中傳輸的位元組數,系統會針對開發人員收取 $0.10 美元的費用 傳送指定的位元組數)。

    磁碟區頻帶型號:一般價目表視窗會顯示額外項目 用來指定匯總基礎及指定「音量區間」的欄位, 是指可套用不同費率的交易量範圍。

    這類方案通常是設定來鼓勵開發人員藉由 提供音量較高的錶帶折扣費率。

    在「通用價目表」視窗中輸入下列資訊:

    欄位 說明
    匯總基礎

    交易量 (或自訂) 屬性相關量) 為匯總資料。你可以使用匯總磁碟區 調整音量大小和每筆交易適用的稅率。選取月數 (1-12 個月)。

    如要進一步瞭解重設郵件組合的時間,請參閱「重複執行的時機 費用和套裝組合方案重設了嗎?

    音量頻帶

    一或多個交易範圍 (或以客戶屬性為準) 數量 (每個範圍 是「音量錶帶」)。每個音量錶帶都可以指定費率 (設定此速率 「定價」區段的「磁碟區頻帶」欄位)。費率適用於所有 搭配適用的音量錶帶進行交易指定第一個 錶帶,例如最多 1000 個 (下限為大於 0)。按一下 + 例如選擇大於 1000 的錶帶 最多 2000 部按一下「+」即可新增更多 錶帶你可以將最後一個錶帶上限留空,表示全部 高於這個層級的交易次數

    定價
    業者 (或機構)

    貴機構的名稱。這個欄位是預設的運算子 (或稱「運算子」), [機構]) 欄位值。

    國家/地區

    貴機構的營運國家/地區。這個欄位預設為使用 「機構資料」中的國家/地區欄位值。

    幣別

    「基數」貴機構組織使用的幣別或會計幣別這個欄位 預設使用「機構設定檔」中的 [貨幣] 欄位值,但您也可以 這裡已變更。

    音量頻帶

    音量錶帶的速率。指定每個音量錶帶的速率。請輸入 每個錶帶的十進位數字 (最多到小數點後四位)。

    注意:您可以設定可以指定的小數位數 瞭解使用 API (而非 UI) 的音量頻帶速率。詳情請參閱設定 費率方案費率的小數位數。

    舉例來說,如果您在「音量錶帶」部分中指定兩個音量頻段, (>0-1000 和 1000 以上),您可以針對 >0-1000 的磁碟區輸入 0.15 錶帶;1000 以上音量錶帶則為 0.10。如果選取的貨幣是美國, 且前 1000 筆交易的匯率為 $0.15 美元,且 的交易超過 1000 筆,則每筆交易的稅率為 $0.10 美元。

    隨附型號:「一般價目表」視窗會顯示 用於指定匯總基礎 (開發人員可使用的時間長度) 交易組合),以及指定套件相關資訊,例如 軟體包。

    在「通用價目表」視窗中輸入下列資訊:

    欄位 說明
    匯總基礎

    期間,開發人員可以使用交易套裝組合 (或 使用自訂屬性組合)。選取月數 (1 到 12 個月)。更新後 方案到期,開發人員必須購買方案 (和套裝組合) 可以選取「重新建立」,再次生成新的提示

    如要進一步瞭解重設郵件組合的時間,請參閱「重複執行的時機 費用和套裝組合方案重設了嗎?

    套裝組合尺寸

    套裝組合中的交易次數 (或與自訂屬性相關的數字) 例如套裝組合中傳輸的位元組總數)。每個組合都可以指派 價格 (您可以在「定價」部分的「套裝組合大小」欄位中設定這個價格)。 價格會套用到整個套裝組合。指定第一個套件的數量上限; 例如最多 1000 個 (下限預設為大於 0)。按一下「+」即可新增 例如大於 1000 的 2,000 個音樂包。按一下「+」即可新增更多 套裝組合。您必須指定最後一個套裝組合的上限,除非您想要 向開發人員收取過去不限交易金額的固定金額 軟體包。

    定價
    業者 (或機構)

    貴機構的名稱。這個欄位是預設的運算子 (或稱「運算子」), [機構]) 欄位值。

    國家/地區

    貴機構的營運國家/地區。這個欄位預設為使用 「機構資料」中的國家/地區欄位值。

    幣別

    「基數」貴機構組織使用的幣別或會計幣別這個欄位 預設使用「機構設定檔」中的 [貨幣] 欄位值,但您也可以 這裡已變更。

    套裝組合大小 (價格)

    套裝組合價格。指定每個套裝組合的價格。請輸入小數 數字 (最多到小數點後四位數)。

    注意:您可以設定可以指定的小數位數 透過 API (而非 UI) 取得套裝組合費率。詳情請參閱設定 費率方案費率的小數位數。

    舉例來說,如果您在「套裝組合大小」區段中指定兩個套件 (大於 0) 介於 1000 至 1000 之間,且大於 1000 至 2000 之間),此時,您可以輸入 50 代表大於的數字 0 至 1,000 個組合;數量大於 1,000 個,但上限為 2000 個。如果 所選貨幣為美元,第一個套裝組合的價格為 $50 美元,以 第二套組合,價格為 $40 美元開發人員向開發人員收取適用的套裝組合價格 無論在組合中使用多少交易資料 (即 開發人員會在套裝組合中的首筆交易時,立即收取套裝組合價格 )。

  7. 按一下「套用並關閉」,儲存價目表詳細資料並返回標準費率方案 視窗。
  8. 如果是 API 產品專屬費率方案,請視需要設定其他 API 產品的費率方案詳細資料。

使用 API 設定價目表方案

透過 API 設定價目表方案詳細資料,如下各節所述。

使用 API 指定價目表方案詳細資料

建立價目表時,請指定價目表方案詳細資料。您將在 呼叫要求主體中的 ratePlanDetails 屬性 /organizations/{org_name}/monetization-packages/{package_id}/rate-plans。內容 是在 ratePlanDetails 屬性中指定的,視您選擇的充電模式而定: 固定費率、色帶或套裝組合。

指定 固定費率充電模式

如要採用固定費率收費模式,請在費率方案中指定以下內容 詳細資料:

  • 評分參數,表示費率方案是以交易為依據 (VOLUME) 或根據自訂屬性 (例如 MINT_CUSTOM_ATTRIBUTE_1)。預設值為 VOLUME
  • 計量類型 (UNIT),表示費率是每單位 (該類型) 不是根據交易量 (如磁帶或 套裝組合)。
  • 付款到期日 (例如 30 天)。
  • 貴機構的 ID。
  • 「基數」貴公司採用的幣別或會計貨幣
  • 費率方案費率,提供費率計算方式的詳細資料。由於 收費模式是以固定費率為依據,你只能指定一個費率方案費率。

在費率方案費率中指定:

  • 房價方案費率的類型 (RATECARD)。
  • 方案費率。舉例來說,假設您指定 0.10,而貨幣為美元 開發人員的每筆交易須支付 $0.10 美元 (或根據下列自訂屬性, 在交易中傳輸的位元組數,系統會針對開發人員收取 $0.10 美元的費用 傳送指定的位元組數)。
  • 稅率應用程式的起始單位 (0)。也就是說,該費率 從第一筆交易開始

查看費率方案 詳細配置設定

舉例來說,下列指令會建立採用固定收費模式的價目表方案。費率為 每筆交易的支出金額設為 $0.10 美元付款期限為 30 天。(價目表相關詳細資訊如下: highlighted.)

curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "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": "{org_name}"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.10",
        "startUnit": "0"       
       }      
      ], 
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

指定 音量頻帶充電模式

在磁碟區各階段中,您指定了包含一或多個費率方案的費率方案詳細資料 費率,每種費率都適用於「音量頻帶」,也就是交易量範圍 (或一定範圍) 以根據自訂屬性 (如傳輸的位元組數) 為依據。這類方案為 通常會提供折扣費率,以鼓勵開發人員提高銷售量 ,適用於音量較高的錶帶

除了費率方案的費率外,你也可以在費率方案詳細資料中指定以下項目:

  • 評分參數,表示費率方案是以交易為依據 (VOLUME) 或根據自訂屬性 (例如 CUSTOM_ATTRIBUTE_1)。預設值為 VOLUME
  • 計量類型 (VOLUME),表示速率是根據音量 而非單筆交易的固定費率,因為 固定費率充電模式)。
  • 付款到期日 (例如 30 天)。
  • 貴機構的 ID。
  • 「基數」貴公司採用的幣別或會計貨幣
  • 時間長度和時間長度類型可以共同指定磁碟區的時間長度 的交易量 (或自訂屬性相關數量) 會匯總計算。這也稱之為 「匯總基礎」交易量是根據匯總計算而得 ( 例如 1 個月) 來判斷適用的音量錶帶。
  • 用於判斷適用音量頻帶的匯總計數器。

為每個費率方案費率指定:

  • 房價方案費率的類型 (RATECARD)。
  • 方案費率。舉例來說,假設您指定 0.10,而貨幣為美元 開發人員的每筆交易須支付 $0.15 美元 (或根據下列自訂屬性, 在交易中傳輸的位元組數,系統會針對開發人員收取 $0.15 美元的費用 傳送指定的位元組數)。
  • 音量頻帶的起始和結束單位。起始單位指定的 音量限制,結束單位則指定音量頻帶的上限。適用對象 舉例來說,如果您指定的起始單位為 0 和結束單位 1000,則音量頻帶會遮蓋住 匯總期間最多 1000 筆交易。如果貨幣為美元, 匯總期間為 1 個月,前 1,000 筆交易的費率為 0.15, 開發人員必須針對當月最多 1000 筆交易,收取每筆交易 $0.15 美元。

    如要進一步瞭解重設套裝組合的時間,請參閱系統何時收取週期性費用 以及套裝組合方案重設?

    如果您沒有為最終音量錶帶指定結束單位,則該錶帶的費率為 在交易次數超過起始單位後套用至所有交易 新的錶帶例如,如果最後一個錶帶的起始單位是 1000,而您沒有 指定該錶帶的結束單位,該錶帶的費率會套用至所有交易。 且不超過匯總週期中的 1,000 筆交易。

查看費率方案 詳細配置設定

例如,下列指令會使用磁碟區頻帶充電模式來建立價目表方案。 前 1, 000 筆交易的費率會設為 $0.15 美元,超過 1000 筆交易的費率則是 $0.10 美元。 匯總結果為 1 個月。付款期限為 30 天。(價目表詳細資料 會以醒目方式顯示)。

curl -H "Content-Type:application/json" -X POST -d \

'{
     "name": "Volume banded rate card plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },     
     "frequencyDuration": "30",
     "description": "Volume banded rate card plan",
     "displayName" : "Volume banded 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"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "VOLUME",
      "organization": {
       "id": "{org_name}"
      },      
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "0.15",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "0.10",
       "startUnit": "1000"      
      }
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

指定 隨附充電模式

採用組合收費模式時,開發人員會預先支付「套裝組合」的費用的交易資料 ( )。您指定 計算每個套件和匯總基準的比率,即開發人員時間範圍 可以使用這個套件

舉例來說,假設您設定了兩個套裝組合,其中第一個套件大小為 1 到 1000。 第二個套裝組合大小是 1001 到 2000 筆交易。費率為 $50 美元 第一個套裝組合,第二個套裝組合為 $40,匯總基礎為 1。如果開發人員 購買了第一批價目表方案,他在 1, 000 筆交易中支付了 $50 美元 (預付) 一個月。無論是否完全使用套裝組合,開發人員一律都會收取指定金額。 匯總期間結束後,方案就會到期。如果開發人員想使用套裝組合 就必須再次購買該方案和套裝組合。

你在費率方案詳細資料中指定的基本上與你在 音量頻帶充電型號的費率方案詳細資訊。兩者的差異如下:

  • 您指定的每個費率方案都是套裝組合,而非音量錶帶。
  • 你必須為最後一個套裝組合指定上限,除非您想收取 開發人員在上一個套裝組合中獲得固定交易金額,但交易次數沒有上限。

查看費率方案 詳細配置設定

舉例來說,下列指令會使用隨附的收費模式建立價目表方案。費率為 第 1 個套裝組合 (最多 1,000 筆交易) 設為 $50 美元,第二個套裝組合則為 $40 美元 (更多 超過 1,000 件及 2,000 筆交易)。匯總結果為 1 個月。付款期限為 30 天 天。

curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Bundled rate plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },    
     "frequencyDuration": "30",
     "description": "Bundled rate plan",
     "displayName" : "Bundled rate plan",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },    
     "paymentDueDays": "30",
     "prorate": "true",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "STAIR_STEP",
      "organization": {
       "id": "{org_name}"
      },
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "50",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "40",
       "startUnit": "1000",
       "endUnit": "2000"
      }
      ],
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

使用 API 為個別產品指定免費增值方案

在價目表方案中,您可以為個別產品設定免費增值方案 (而非 API 套件)。免費增值方案可讓開發人員在 或視用量而定

為 API 產品設定免費增值方案時,請在價目表方案詳細資料中指定 開發人員可自由使用 API 產品所提供的資源 費用。時間範圍可以採用下列任一項目:

  • 時間長度,也就是生效日期與結束日期之間的時間。
  • 數量,例如與 API 產品相關的交易次數或銷售量 與交易記錄政策中記錄的自訂屬性有關。

如果免費增值期是以數量為依據,請將其指定為免費增值單位數量。適用對象 以下範例說明如何建立包含 5, 000 冊數量的免費增值方案價目表方案 單位 (免費增值相關規格以醒目方式顯示)。

curl -H "Content-Type:application/json" -X POST -d \
'{
      "name": "Flat rate card plan with freemium period",
      "developer":null,
      "developerCategory":null,      
      "advance": "false",
      "currency": {
       "id" : "usd"
      },     
      "description": "Flat rate card plan with freemium period",
      "displayName" : "Flat rate card plan with freemium period",
      "frequencyDuration": "30",
      "frequencyDurationType": "DAY",
      "earlyTerminationFee": "10",     
      "monetizationPackage": {
       "id": "location"
      },
      "organization": {
       "id": "myorg"
      },
      "paymentDueDays": "30",
      "prorate": "false",
      "published": "false",
      "ratePlanDetails": [
      {
       "currency": {
       "aggregateFreemiumCounters" : true,
       "aggregateStandardCounters" : true,
        "id" : "usd"
       },
       "product" : {
        "id" : "location",
        "displayName":"Location"
       },
       "paymentDueDays": "30",      
       "meteringType": "UNIT",
       "organization": {
        "id": "myorg"
       },
       "ratePlanRates": [
        {
         "type": "RATECARD",
         "rate": "0.10",
         "startUnit": "0"       
        }      
       ],
      "freemiumUnit": "5000",
      "freemiumDuration": "0",
      "freemiumDurationType": "DAY",
      "ratingParameterUnit":"MB",
      "customPaymentTerm": "false",
      "ratingParameter": "VOLUME",
      "type": "RATECARD"
      }],
      "recurringStartUnit": 1,
      "recurringType": "CALENDAR",
      "recurringFee": "10",
      "setUpFee": "10",
      "startDate": "2013-09-15 00:00:00",
      "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password