Tạo gói giá trong tương lai

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 mà bạn có thể thay đổi là ngày kết thúc của cơ sở lưu trú đó. Tuy nhiên, bạn có thể tạo một phiên bản mới của gói dịch vụ chứa các cơ sở lưu trú đã thay đổi, chẳng hạn như mức giá đã thay đổi của gói giá. 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. Gói giá gốc sẽ kết thúc khi nội dung 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 việc này, bạn tạo một gói giá trong tương lai và thiết lập để gói đó có hiệu lực từ ngày 1 tháng 1 năm 2020.

Nếu không đặt ngày kết thúc cho gói giá hiện tại, bạn có thể thay thế một gói giá hiện tại bằng một gói giá trong tương lai 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 phần Hết hạn gói giá đã phát hành.

Nhà phát triển sẽ nhận được thông báo về gói giá sửa đổi. Những nhà phát triển chấp nhận gói giá ban đầu sẽ tự động được đă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 gói giá trong tương lai bằng cách sử dụng giao diện người dùng quản lý hoặc API kiếm tiền, như mô tả trong các phần sau.

Tạo kế hoạch 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 theo mô tả dưới đây.

Edge

Để tạo phiên bản trong tương lai của gói giá sẽ bắt đầu từ hôm nay bằng giao diện người dùng Edge, hãy thực hiện các bước sau.

  1. Trên trang Gói giá, hãy đặt con trỏ trong hàng liên kết 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.
  2. Nhấp vào +Tương lai.
  3. Trong phần Gói giá trong tương lai, hãy chọn một trong các lựa 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ẽ có hiệu lực 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 với thời hạn gia hạn của gói giá hiện tại.
    • Khấu trừ thời gian dùng hợp đồng trước đó từ kỳ mới vào ngày có hiệu lực: Gói giá trong tương lai có hiệu lực kể từ ngày có hiệu lực. Thời gian sử dụng gói giá hiện tại sẽ được khấu trừ vào thời hạn gia hạn của gói giá trong tương lai. Tức là nếu nhà phát triển sử dụng gói hiện tại trong 3 tháng và kỳ hạn gia hạn sẽ giảm đi 3 tháng.
  4. Hãy định cấu hình các trường sau trong bảng trên cùng:
    Lưu ý: Các trường khác ở chế độ chỉ có thể đọc.
    Trường Nội dung 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 khớp với tên gói giá ban đầu.

    Tên gói hiện tại
    Ngày bắt đầu Ngày gói giá có hiệu lực. Nhập ngày bắt đầu hoặc dùng lịch để chọn ngày. 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 một ngày bằng lịch.

    Lưu ý: Gói giá sẽ có hiệu lực cho đến cuối ngày vào ngày đã chỉ định. Ví dụ: nếu muốn hết hạn một gói giá 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 tháng 11 năm 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 thông tin Hãy đặt gói giá là Công khai hoặc Riêng tư. Xem phần Gói giá công khai và riêng tư. Đang bật Không
  5. Thiết lập mức phí cho gói giá. Xem phần Định cấu hình phí.
    Lưu ý: Không áp dụng cho các kế hoạch thông báo có thể điều chỉnh.
  6. Nếu bạn chọn một gói sản phẩm có 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 chung:
    Lưu ý: Bước này không áp dụng cho các kế hoạch thông báo có thể điều chỉnh.
    Trường Nội dung mô tả Mặc định
    Định cấu hình riêng từng sản phẩm Cờ chỉ định xem có thiết lập một gói giá riêng cho từng sản phẩm API hay không. Đã tắt
    Thiết lập ưu đãi thu phí trong miễn phí của từng sản phẩm Cờ chỉ định xem có định cấu hình gói thu phí trong miễn phí cho từng sản phẩm API hay không. Đã tắt
    Chọn một sản phẩm Nếu bật một hoặc cả hai cờ, bạn phải chọn riêng từng sản phẩm trong danh sách thả xuống rồi định cấu hình chi tiết gói giá.

    Lưu ý: Hãy nhớ định cấu hình tất cả sản phẩm trong gói sản phẩm.

    Không áp dụng
  7. Thiết lập chi tiết gói giá dựa trên loại gói giá đã chọn:
  8. Nhấp vào một trong các mục sau:
    Nút Nội dung mô tả
    Cập nhật bản nháp Lưu gói giá dưới dạng bản nháp.

    Nhà phát triển ứng dụng sẽ không nhìn thấy gói giá cho đến khi bạn phát hành gói giá đó. Bạn có thể chỉnh sửa bất kỳ trường nào trong gói giá nháp.

    Phát hành bản nháp Xuất bản kế hoạch.

    Lưu ý: Sau khi xuất bản một gói giá, bạn chỉ có thể sửa đổi ngày kết thúc nếu chưa đặt ngày kết thúc. Bạn không thể xoá một gói giá sau khi xuất bản, nhưng bạn 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ố.

Phiên bản cũ (Đám mây riêng tư)

Để tạo phiên bản trong tương lai của gói giá sẽ bắt đầu vào một lúc nào đó 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.

  1. Trong danh mục gói, hãy nhấp vào +Tương lai trong cột Bản nháp/Tương lai của gói giá mà bạn muốn thay thế.

    Thao tác này sẽ mở ra một cửa sổ Gói giá trong tương lai.

    Điểm khác biệt chính giữa khung thời gian của gói giá trong tương lai và khung thời gian hiện tại của gói giá là việc thêm mục Người đăng ký hiện tại.

  2. Giống như đối với gói giá bất kỳ:
    • Nhập tên cho kế hoạch trong trường Tên gói giá. Tên không cần phải khớp với 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 chi tiết gói giá, dựa trên loại gói giá đã chọn:
    • Chỉ định ngày mà kế hoạch 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 không muốn gói giá trong tương lai kết thúc vào một ngày cụ thể). Nếu bạn đặt ngày kết thúc cho kế hoạch 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.
  3. Trong phần Người đăng ký hiện tại, hãy chọn một trong các lựa 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ẽ có hiệu lực kể từ 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 với thời hạn gia hạn của gói giá hiện tại.
    • Trừ thời gian đã sử dụng cho hợp đồng trước đó từ kỳ mới, vào ngày có hiệu lực. Gói giá trong tương lai sẽ có hiệu lực kể từ ngày có hiệu lực. Thời gian sử dụng gói giá hiện tại sẽ được khấu trừ vào thời hạn gia hạn của gói giá trong tương lai. Tức là nếu nhà phát triển sử dụng gói hiện tại trong 3 tháng và kỳ hạn gia hạn sẽ giảm đi 3 tháng.
  4. Trong trường Ngày có hiệu lực, hãy nhập ngày bắt đầu sau ngày kết thúc của gói giá hiện tại.

Tạo kế hoạch giá trong tương lai bằng API

Bạn có thể sử dụng API để tạo gói giá trong tương lai bằng cách gửi yêu cầu POST đến /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à giá trị nhận dạng gói API.
  • {plan_Id} là thông tin nhận dạng gói giá.
Khi tạo bản sửa đổi, bạn phải chỉ định các thuộc tính sau trong nội dung yêu cầu:
  • parentRatePlan chỉ định mã của gói giá ban đầu.
  • startDate chỉ định ngày kế hoạch mới có hiệu lực.

Tên của gói giá trong tương lai không cần phải khớp với tên của gói ban đầu. Nếu bạn muốn giữ lại ngày bắt đầu ban đầu được ghi lại cho các 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 phần Chế độ cài đặt cấu hình cho gói giá.

Ví dụ: yêu cầu sau đây tạo ra 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