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

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Giới thiệu

Sau khi xuất bản một kế hoạch giá hiện có, bạn chỉ có thể thay đổi ngày kết thúc của kế hoạch đó. Tuy nhiên, bạn có thể tạo một phiên bản mới của kế hoạch có các thuộc tính đã thay đổi, chẳng hạn như mức giá của kế hoạch 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. Gói cước ban đầu sẽ kết thúc khi bản 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 này bằng một gói khác có hiệu lực từ ngày 1 tháng 1 năm 2020. Để làm việc đó, 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 từ 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, bạn có thể thay thế 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 phải hết hạn gói giá hiện tại, như mô tả trong phần Hết hạn gói giá đã xuất bản.

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 kế hoạch tỷ lệ ban đầu sẽ tự động đăng ký phiên bản sửa đổi (nhưng có thể từ chối phiên bản sửa đổi).

Bạn có thể tạo một kế hoạch giá trong tương lai bằ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 kế hoạch giá trong tương lai như mô tả bên dưới.

Edge

Để tạo một phiên bản trong tương lai của kế hoạch giá bắt đầu vào một thời điểm nào đó sau 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 Kế hoạch giá, hãy di chuyển con trỏ vào hàng liên kết với kế hoạch giá mà bạn muốn tạo kế hoạch giá cho tương lai.
    Kế hoạch giá phải có ngày kết thúc.
  2. Nhấp vào +Future (Tương lai).
  3. Trong phần Kế hoạch 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 có hiệu lực mới: Gói giá trong tương lai sẽ có hiệu lực vào ngày có hiệu lực. Kỳ hạn gia hạn của gói giá trong tương lai giống với kỳ hạn gia hạn của gói giá hiện tại.
    • Trừ thời gian đã sử dụng trong hợp đồng trước đó khỏi thời gian của hợp đồng 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 sử dụng gói cước hiện tại sẽ được trừ vào thời hạn gia hạn của gói cước trong tương lai. Điều này có nghĩa là nếu nhà phát triển sử dụng gói hiện tại trong 3 tháng, thì thời gian gia hạn sẽ giảm đi 3 tháng.
  4. Đị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ỉ có thể đọc.
    Trường Mô tả Mặc định Bắt buộc
    Tên gói giá

    Tên của gói giá.

    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 một 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 bật/tắt 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 hết ngày vào ngày được chỉ định. Ví dụ: Nếu muốn hết hạn một kế hoạch 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, kế hoạch 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ị trên cổng thông tin Đặt xem gói giá là Công khai hay Riêng tư. Xem phần Gói giá công khai so với gói giá ưu đãi chọn lọc. Đang bật Không
  5. Định cấu hình các khoản phí cho gói giá. Xem phần Định cấu hình phí.
    Lưu ý: Không áp dụng cho các gói 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 đặt 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 gói thông báo có thể điều chỉnh.
    Trường Mô tả Mặc định
    Định cấu hình từng sản phẩm riêng lẻ Cờ chỉ định có định cấu hình một kế hoạch giá riêng cho từng sản phẩm API hay không. Đã tắt
    Định cấu hình ưu đãi freemium của từng sản phẩm riêng lẻ Cờ chỉ định có định cấu hình gói freemium 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ờ này, bạn phải chọn từng sản phẩm riêng lẻ trong danh sách thả xuống và định cấu hình thông tin chi tiết về gói giá của sản phẩm đó.

    Lưu ý: Đảm bảo rằng bạn đị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. Định cấu hình thông tin chi tiết về gói giá, dựa trên loại gói giá đã chọn:
  8. Nhấp vào một trong các lựa chọn sau:
    Nút Mô tả
    Cập nhật bản nháp Lưu kế hoạch giá dưới dạng bản nháp.

    Các nhà phát triển ứng dụng sẽ không thấy được kế hoạch giá cho đến khi bạn xuất bản kế hoạch đó. Bạn có thể chỉnh sửa mọi trường trong kế hoạch giá nháp.

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

    Lưu ý: Sau khi xuất bản một kế hoạch giá, bạn chỉ có thể sửa đổi ngày kết thúc nếu ngày này chưa được đặt. Bạn không thể xoá một kế hoạch giá sau khi kế hoạch đó được xuất bản, nhưng bạn có thể đặt ngày hết hạn cho kế hoạch giá đó và thay thế bằng một kế hoạch giá trong tương lai, như mô tả trong phần Đặt ngày hết hạn cho kế hoạch giá đã xuất bản.

Classic Edge (Private Cloud)

Để tạo một phiên bản trong tương lai của kế hoạch giá bắt đầu vào một thời điểm 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 +Future trong cột Bản nháp/Trong tương lai cho kế hoạch giá mà bạn muốn thay thế.

    Thao tác này sẽ mở cửa sổ Kế hoạch giá trong tương lai.

    Điểm khác biệt chính giữa cửa sổ kế hoạch giá trong tương lai và cửa sổ kế hoạch giá hiện tại là việc bổ sung phần Người đăng ký hiện tại.

  2. Như bạn vẫn làm đối với mọi gói giá:
  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 có hiệu lực mới. Gói giá trong tương lai sẽ có hiệu lực vào ngày có hiệu lực. Kỳ hạn gia hạn của gói giá trong tương lai giống với kỳ hạn gia hạn của gói giá hiện tại.
    • Trừ thời gian đã sử dụng trong hợp đồng trước đó vào thời gian của hợp đồng mới, kể từ ngày có hiệu lực. Kế hoạch giá trong tương lai sẽ có hiệu lực vào ngày có hiệu lực. Thời gian sử dụng gói cước hiện tại sẽ được trừ vào thời hạn gia hạn của gói cước trong tương lai. Điều này có nghĩa là nếu nhà phát triển sử dụng gói hiện tại trong 3 tháng, thì thời gian 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 kế hoạch 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 kế hoạch giá trong tương lai bằng API bằng cách đưa ra 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 của gói API.
  • {plan_Id} là thông tin nhận dạng của 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ã nhận dạng của gói giá ban đầu.
  • startDate chỉ đị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 với tên của gói ban đầu. Ngoài ra, mã này phải là mã duy nhất trong tất cả các gói giá của bạn. Nếu bạn muốn giữ nguyên 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ề chế độ cài đặt cấu hình, hãy xem phần Chế độ cài đặt cấu hình cho kế hoạch giá.

Ví dụ: yêu cầu sau đây sẽ tạo một kế hoạch 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