Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Giới thiệu
Sau khi xuất bản gói giá hiện tại, cơ sở lưu trú duy nhất bạn có thể thay đổi là ngày kết thúc của gói giá đó. Tuy nhiên, bạn có thể tạo một phiên bản mới của kế hoạch bao gồm các thuộc tính đã thay đổi, chẳng hạn như mức giá gói giá đã thay đổi. Bạn có thể thiết lập để bản sửa đổi có hiệu lực vào một ngày trong tương lai. Chiến lược phát hành đĩa đơn gói giá ban đầu kết thúc khi sửa đổi có hiệu lực.
Ví dụ: giả sử bạn đã tạo một gói giá tiêu chuẩn hết hạn vào ngày 31 tháng 12 năm 2019 và bạn muốn thay thế gói đó bằng một gói khác có hiệu lực vào ngày 1 tháng 1 năm 2020. Để làm được điều đó, bạn tạo một kế hoạch giá trong tương lai và thiết lập để kế hoạch đó có hiệu lực vào ngày 1 tháng 1 năm 2020.
Nếu chưa đặt ngày kết thúc cho gói giá hiện tại, thì bạn có thể thay thế gói giá hiện tại bằng một gói giá trong tương lai có giá bắt đầu từ hôm nay. Bạn sẽ cần hết hạn gói giá hiện tại, như mô tả trong bài viết Hết hạn gói giá đã công bố.
Nhà phát triển sẽ được thông báo về gói giá được sửa đổi. Những nhà phát triển chấp nhận bản gốc gói giá được tự động đăng ký cho bản sửa đổi (nhưng có thể từ chối bản sửa đổi).
Bạn có thể tạo một gói giá trong tương lai bằng giao diện người dùng quản lý hoặc API Kiếm tiền, theo mô tả trong phần các phần sau đây.
Tạo gói giá trong tương lai bằng giao diện người dùng
Tạo một gói giá trong tương lai như mô tả dưới đây.
Edge
Để tạo phiên bản trong tương lai của một gói giá bắt đầu vào một thời điểm sau hôm nay bằng cách sử dụng giao diện người dùng Edge, hãy thực hiện các bước sau đây.
- Trên trang Gói giá,
đặt con trỏ vào hàng tương ứng với gói giá mà bạn muốn tạo gói giá trong tương lai.
Gói giá phải có ngày kết thúc. - Nhấp vào +Tương lai.
- Trong phần Gói giá trong tương lai, hãy chọn một trong các mục sau:
- Bắt đầu lại toàn bộ thời hạn hợp đồng vào ngày mới có hiệu lực: Gói giá trong tương lai sẽ bắt đầu tính vào ngày có hiệu lực. Thời hạn gia hạn của gói giá trong tương lai giống như đối với gói giá hiện tại.
- Khấu trừ thời gian dành cho hợp đồng trước đây cho giai đoạn mới, vào ngày có hiệu lực: gói giá trong tương lai sẽ có hiệu lực vào ngày có hiệu lực. Thời gian dành cho việc sử dụng gói giá sẽ được khấu trừ vào thời hạn gia hạn của gói giá trong tương lai. Điều này có nghĩa là nếu một nhà phát triển sử dụng gói hiện tại trong 3 tháng và thời gian gia hạn được giảm đi 3 tháng.
- Định cấu hình các trường sau trong bảng điều khiển trên cùng:
Lưu ý: Các trường khác ở chế độ chỉ đọc.Trường Mô tả Mặc định Bắt buộc Tên gói giá Tên gói giá của bạn.
Lưu ý: Tên không cần phải khớp với tên gói giá ban đầu.
Tên kế hoạch hiện tại Có Ngày bắt đầu Ngày gói giá có hiệu lực. Nhập ngày bắt đầu hoặc chọn ngày bằng lịch. Hôm nay Không Ngày kết thúc Ngày kết thúc gói giá. Để chỉ định ngày kết thúc, hãy bật nút chuyển Có ngày kết thúc rồi nhập ngày kết thúc hoặc chọn ngày bằng lịch. Lưu ý: Gói giá sẽ có hiệu lực cho đến cuối ngày của ngày đã chỉ định. Ví dụ: nếu muốn gói giá hết hạn vào ngày 1 tháng 12 năm 2018, bạn nên đặt giá trị endDate thành 2018-11-30. Trong trường hợp này, gói giá sẽ hết hạn vào cuối ngày 30/11/2018; tất cả các yêu cầu vào ngày 1 tháng 12 năm 2018 sẽ bị chặn.
Không có Không Hiển thị cho cổng Đặt gói giá là Công khai hay Riêng tư. Xem phần Gói giá công khai và riêng tư. Đang bật Không - Định cấu hình phí cho gói giá. Xem phần Định cấu hình phí.
Lưu ý: Không áp dụng cho gói thông báo có thể điều chỉnh. - Nếu bạn chọn một gói sản phẩm chứa nhiều sản phẩm API, hãy thiết lập các lựa chọn ưu tiên sau trong phần Gói giá cụ thể hoặc gói giá chung:
Lưu ý: Bước này không áp dụng cho các gói thông báo có thể điều chỉnh.
Trường Mô tả Mặc định Thiết lập riêng từng sản phẩm Cờ cho biết liệu có định cấu hình gói giá riêng lẻ cho mỗi sản phẩm API hay không. Đã tắt Định cấu hình riêng ưu đãi thu phí trong miễn phí của từng sản phẩm Cờ chỉ định việc có định cấu hình gói miễn phí thu phí trong miễn phí cho từng sản phẩm API hay không. Đã tắt Chọn sản phẩm Nếu bật một hoặc cả hai cờ, bạn phải chọn từng sản phẩm riêng lẻ trong danh sách thả xuống và thiết lập thông tin chi tiết về gói giá của sản phẩm đó. Lưu ý: Hãy đảm bảo rằng bạn đã thiết lập tất cả sản phẩm trong gói sản phẩm.
Không áp dụng - Thiết lập thông tin chi tiết về gói giá, dựa trên loại gói giá đã chọn:
- Nhấp vào một trong các mục sau:
Nút Mô tả Cập nhật bản nháp Lưu gói giá dưới dạng bản nháp. Các nhà phát triển ứng dụng sẽ không nhìn thấy gói giá cho đến khi bạn xuất bản. Bạn có thể chỉnh sửa bất kỳ trường nào trong gói giá dự thảo.
Xuất bản bản nháp Xuất bản kế hoạch. Lưu ý: Sau khi xuất bản gói giá, bạn chỉ có thể sửa đổi ngày kết thúc nếu chưa đặt ngày đó. Bạn không thể xoá gói giá sau khi xuất bản, nhưng có thể hết hạn và thay thế gói giá đó bằng một gói giá trong tương lai, như mô tả trong phần Hết hạn gói giá được công bố.
Classic Edge (Đám mây riêng tư)
Để tạo phiên bản trong tương lai của một gói giá bắt đầu vào một thời điểm sau hôm nay bằng cách sử dụng giao diện người dùng Classic Edge, hãy thực hiện các bước sau.
- Trong danh mục gói, hãy nhấp vào +Trong tương lai trên cột Bản nháp/Trong tương lai để
mà bạn muốn thay thế.
Thao tác này sẽ mở ra cửa sổ Gói giá trong tương lai.
Sự khác biệt chính giữa khoảng thời gian gói giá trong tương lai và khoảng thời gian gói giá hiện tại là thêm phần Người đăng ký hiện tại.
- Giống như đối với gói giá bất kỳ:
- Nhập tên cho gói giá trong trường Tên gói giá. Tên không cần phải khớp tên của gói giá ban đầu.
- Định cấu hình phí cho gói giá (không bắt buộc).
- Thiết lập thông tin chi tiết về gói giá, dựa trên loại gói giá đã chọn:
- Chỉ định ngày mà gói giá trong tương lai có hiệu lực (xem phần Xuất bản gói giá), và ngày kết thúc (bạn cũng có thể chọn "Không có ngày kết thúc" nếu bạn không muốn gói giá trong tương lai sẽ kết thúc vào một ngày cụ thể). Nếu bạn đặt ngày kết thúc cho gói hiện tại, thì ngày có hiệu lực của kế hoạch trong tương lai phải sau ngày kết thúc của kế hoạch hiện tại .
- Trong phần Người đăng ký hiện tại, chọn một trong các tùy chọn sau:
- Bắt đầu lại toàn bộ thời hạn hợp đồng vào ngày mới có hiệu lực. Gói giá trong tương lai sẽ bắt đầu áp dụng tính vào ngày có hiệu lực. Thời hạn gia hạn của gói giá trong tương lai giống như đối với gói giá hiện tại.
- Trừ thời gian dành cho hợp đồng cũ từ kỳ mới, vào ngày có hiệu lực. Chiến lược phát hành đĩa đơn gói giá trong tương lai sẽ có hiệu lực vào ngày có hiệu lực. Thời gian dành cho việc sử dụng gói giá sẽ được khấu trừ vào thời hạn gia hạn của gói giá trong tương lai. Điều này có nghĩa là nếu một nhà phát triển sử dụng gói hiện tại trong 3 tháng và thời gian gia hạn được giảm đi 3 tháng.
- Trong trường Ngày có hiệu lực, hãy nhập ngày bắt đầu xảy ra sau ngày kết thúc gói giá hiện tại.
Tạo kế hoạch giá trong tương lai bằng API
Bạn có thể tạo một gói giá trong tương lai bằng API này bằng cách gửi một yêu cầu POST cho
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision
Trong trường hợp:
{org_id}là tên của tổ chức.{package_id}là thông tin nhận dạng gói API.{plan_Id}là thông tin nhận dạng gói giá.
parentRatePlanchỉ định mã của gói giá ban đầu.startDatechỉ định ngày mà gói mới có hiệu lực.
Tên của gói giá trong tương lai không được trùng khớp với tên của kế hoạch ban đầu. Ngoài ra,
riêng biệt trong số tất cả các gói giá của bạn. Nếu bạn muốn giữ lại ngày bắt đầu ban đầu được ghi lại cho
nhà phát triển, hãy đặt cờ keepOriginalStartDate thành true. Cờ này
mặc định là false.
Để biết thêm thông tin về các chế độ cài đặt cấu hình, hãy xem Chế độ cài đặt cấu hình cho gói giá.
Ví dụ: yêu cầu sau đây sẽ tạo một gói giá trong tương lai:
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"parentRatePlan": {
"id": "monetization_package_flat_rate_card_plan_1379513833409"
},
"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": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.05",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2014-01-01 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password