您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
免费增值方案使应用开发者能够在一段时间内免费使用该价格方案，具体时间取决于用量、时长或两者兼而有之。 您可以为任何费率方案类型（可调整通知除外）配置免费增值方案。
使用界面配置免费增值方案
为费率方案配置免费增值方案，如下所述。
Edge
如需在创建或修改费率方案时使用 Edge 界面配置免费增值方案，请选择任意费率方案类型（“可调整的通知”除外），然后在免费增值部分中启用免费增值方案，并选择以下选项之一：
- 按用量（API 调用次数）提供的方案
- 按周期提供的优惠
- 以先到者为准
根据您的选择，配置以下一个或两个字段：
| 字段 | 说明 |
|---|---|
| 免费增值使用情况（API 调用） | 注意：如果您选择按数量提供或先到先得，则必须提供此信息。
开发者无需付费的交易数量（或交易记录政策中记录的与自定义属性相关的值）。系统会针对 API 产品衡量此流量。 |
| 免费增值时间段 | 注意：如果您选择按时长提供或先到先得，则必须提供此信息。
开发者无需付费的时间间隔。例如，30 天。指定数量和单位（天、周或月）。 |
经典边缘（私有云）
如需使用 Classic Edge 界面配置免费增值方案，请执行以下操作：
- 选择“Freemium”标签页。
- 输入以下信息：
字段 说明 免费增值套餐？ 免费期的时长。选择以下单选按钮之一：
- 按数量。免费期基于“数量”字段中指定的数量。
- 按时长。免费期基于“Freemium Duration”（免费增值时长）字段中指定的时间间隔。
- 以先到者为准。当达到“数量”字段中的数量或“免费增值时长”字段中的时间间隔时（以先达到的条件为准），免费期即会结束。
- 不是。这不是免费增值方案。这是默认值。
Freemium Volume 开发者需要付费的交易量（或与交易记录政策中记录的自定义属性相关的交易量）。流量是根据 API 软件包中的所有产品来衡量的。输入一个音量值，例如 5000。 这意味着，当开发者开始使用此方案时，前 5,000 笔交易（或前 5,000 次使用与自定义属性相关的项）不会产生费用。 只有在“Freemium Package?”字段中选择“按数量”或“先到先得”时，此字段才会启用。
免费增值时长 开发者无需付费的时间间隔。输入一个数字并选择一个时间段，例如“1 个月”。这意味着，在购买的方案开始日期后的 1 个月内，开发者不会被收取费用。只有在“freemium Package?”字段中选择“按时长”或“以先到者为准”时，此字段才会启用。
使用 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 软件包的交易数量或交易记录政策中记录的与自定义属性相关的交易量），请将其指定为免费增值单位的数量。例如，以下属性分配指定了免费增值基于 5,000 个免费增值单位：
"freemiumUnit": "5000"
如需查看费率方案选项的完整列表，请参阅费率方案配置设置。