สร้างแพ็กเกจราคาในอนาคต

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
ข้อมูล

เกริ่นนำ

หลังจากเผยแพร่แพ็กเกจราคาที่มีอยู่แล้ว คุณสามารถเปลี่ยนที่พักเพียงอย่างเดียวได้คือวันที่สิ้นสุด อย่างไรก็ตาม คุณสามารถสร้างแพ็กเกจเวอร์ชันใหม่ซึ่งมีที่พักที่เปลี่ยนแปลง เช่น อัตราแพ็กเกจราคาที่มีการเปลี่ยนแปลง คุณสามารถกำหนดให้การแก้ไขมีผลในภายหลัง แพ็กเกจราคาเดิมจะสิ้นสุดลงเมื่อการแก้ไขมีผล

ตัวอย่างเช่น สมมติว่าคุณสร้างแพ็กเกจราคามาตรฐานซึ่งหมดอายุวันที่ 31 ธันวาคม 2019 และต้องการแทนที่ด้วยแพ็กเกจอื่นซึ่งจะมีผลในวันที่ 1 มกราคม 2020 ดังนั้น คุณต้องสร้างแพ็กเกจราคาในอนาคตและตั้งค่าให้มีผลในวันที่ 1 มกราคม 2020

หากไม่ได้กำหนดวันที่สิ้นสุดสำหรับแพ็กเกจราคาปัจจุบัน คุณแทนที่แพ็กเกจราคาที่มีอยู่ด้วยแพ็กเกจราคาในอนาคตที่เริ่มตั้งแต่วันนี้เลย คุณจะต้องหมดอายุแพ็กเกจราคาปัจจุบันตามที่อธิบายไว้ในหมดอายุแพ็กเกจราคาที่เผยแพร่

นักพัฒนาแอปจะได้รับแจ้งเกี่ยวกับแพ็กเกจราคาที่แก้ไขแล้ว นักพัฒนาซอฟต์แวร์ที่ยอมรับแพ็กเกจราคาเดิมจะได้รับการลงทะเบียนสำหรับการแก้ไขโดยอัตโนมัติ (แต่อาจมีตัวเลือกในการปฏิเสธการแก้ไข)

คุณสร้างแพ็กเกจราคาในอนาคตได้โดยใช้ UI การจัดการหรือ API การสร้างรายได้ตามที่อธิบายไว้ในส่วนต่อไปนี้

การสร้างแพ็กเกจราคาในอนาคตโดยใช้ UI

สร้างแพ็กเกจราคาในอนาคตตามที่อธิบายไว้ด้านล่าง

Edge

หากต้องการสร้างแพ็กเกจราคาเวอร์ชันในอนาคตที่จะเริ่มขึ้นหลังจากวันนี้โดยใช้ Edge UI ให้ทำตามขั้นตอนต่อไปนี้

  1. ในหน้าแพ็กเกจราคา ให้วางเคอร์เซอร์ภายในแถวที่เชื่อมโยงกับแพ็กเกจราคาที่คุณต้องการสร้างแพ็กเกจราคาในอนาคต
    แพ็กเกจราคาต้องมีวันที่สิ้นสุด
  2. คลิก +อนาคต
  3. ในส่วนแพ็กเกจราคาในอนาคต ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
    • เริ่มระยะเวลาตามสัญญาใหม่ในวันที่มีผลใหม่: แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคตจะเหมือนกับของแพ็กเกจราคาปัจจุบัน
    • หักเวลาที่ใช้ในสัญญาก่อนหน้าจากระยะเวลาใหม่ในวันที่มีผล: แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล เวลาที่ใช้แพ็กเกจราคาปัจจุบันจะถูกหักออกจากระยะเวลาต่ออายุของแพ็กเกจราคาในอนาคต ซึ่งหมายความว่าหากนักพัฒนาแอปใช้แพ็กเกจปัจจุบันเป็นเวลา 3 เดือน และระยะเวลาการต่ออายุจะลดลง 3 เดือน
  4. กำหนดค่าช่องต่อไปนี้ในแผงด้านบน:
    หมายเหตุ: ช่องอื่นๆ จะเป็นแบบอ่านอย่างเดียว
    ฟิลด์ คำอธิบาย ค่าเริ่มต้น จำเป็น
    ชื่อแพ็กเกจราคา

    ชื่อแพ็กเกจราคา

    หมายเหตุ: ชื่อไม่จำเป็นต้องตรงกับชื่อแพ็กเกจราคาเดิม

    ชื่อแพ็กเกจที่มีอยู่ มี
    วันที่เริ่มต้น วันที่แพ็กเกจราคามีผล ป้อนวันที่เริ่มต้นหรือเลือกวันที่โดยใช้ปฏิทิน วันนี้ ไม่ได้
    End date วันที่แพ็กเกจราคาสิ้นสุดลง หากต้องการระบุวันที่สิ้นสุด ให้เปิดใช้สวิตช์มีวันที่สิ้นสุด และป้อนวันที่สิ้นสุด หรือเลือกวันที่โดยใช้ปฏิทิน

    หมายเหตุ: แพ็กเกจราคาจะมีผลจนถึงสิ้นสุดวันในวันที่ที่ระบุ ตัวอย่างเช่น หากต้องการให้แพ็กเกจราคาหมดอายุในวันที่ 1 ธันวาคม 2018 คุณควรตั้งค่า endDate เป็น 30-11-2018 ในกรณีนี้ แพ็กเกจราคาจะหมดอายุเมื่อสิ้นสุดวันที่ 30 พฤศจิกายน 2018 และจะบล็อกคำขอทั้งหมดในวันที่ 1 ธันวาคม 2018

    ไม่มี ไม่ได้
    ปรากฏแก่พอร์ทัล กำหนดว่าแพ็กเกจราคาเป็นสาธารณะหรือส่วนตัว ดูแพ็กเกจราคาสาธารณะกับส่วนลดเฉพาะบุคคล เปิดใช้อยู่ ไม่ได้
  5. กำหนดค่าค่าธรรมเนียมสำหรับแพ็กเกจราคา โปรดดูการกำหนดค่าค่าธรรมเนียม
    หมายเหตุ: ใช้ไม่ได้กับแพ็กเกจการแจ้งเตือนแบบปรับเปลี่ยนได้
  6. หากเลือกแพ็กเกจผลิตภัณฑ์ที่มีผลิตภัณฑ์ API มากกว่า 1 รายการ ให้ตั้งค่ากำหนดต่อไปนี้ในส่วนแพ็กเกจราคาที่เจาะจงหรือทั่วไป
    หมายเหตุ: ขั้นตอนนี้ใช้ไม่ได้กับแผนการแจ้งเตือนแบบปรับได้
    ฟิลด์ คำอธิบาย ค่าเริ่มต้น
    กำหนดค่าผลิตภัณฑ์แต่ละรายการแยกกัน แฟล็กที่ระบุว่าจะกำหนดค่าแพ็กเกจราคาแต่ละรายการสำหรับผลิตภัณฑ์ API แต่ละรายการหรือไม่ ปิดใช้
    กำหนดค่าข้อเสนอฟรีเมียมของแต่ละผลิตภัณฑ์แยกกัน แฟล็กที่ระบุว่าจะกำหนดค่าแพ็กเกจ Freemium สำหรับผลิตภัณฑ์ API แต่ละรายการหรือไม่ ปิดใช้
    เลือกไอเทม หากเปิดใช้การตั้งค่าสถานะรายการใดรายการหนึ่งหรือทั้ง 2 รายการ คุณต้องเลือกผลิตภัณฑ์แต่ละรายการจากรายการแบบเลื่อนลง และกำหนดค่ารายละเอียดแพ็กเกจราคา

    หมายเหตุ: ตรวจสอบว่าได้กำหนดค่าผลิตภัณฑ์ทั้งหมดในแพ็กเกจผลิตภัณฑ์แล้ว

    ไม่มีข้อมูล
  7. กำหนดค่ารายละเอียดแพ็กเกจราคาตามประเภทแพ็กเกจราคาที่เลือก ดังนี้
  8. คลิกหนึ่งในตัวเลือกต่อไปนี้
    ปุ่ม คำอธิบาย
    อัปเดตฉบับร่าง บันทึกแพ็กเกจราคาเป็นฉบับร่าง

    นักพัฒนาแอปจะไม่เห็นแพ็กเกจราคาจนกว่าคุณจะเผยแพร่แพ็กเกจ คุณแก้ไขช่องใดก็ได้ในแพ็กเกจราคาฉบับร่าง

    เผยแพร่ฉบับร่าง เผยแพร่แผน

    หมายเหตุ: หลังจากเผยแพร่แพ็กเกจราคา คุณจะแก้ไขวันที่สิ้นสุดได้ในกรณีที่ยังไม่ได้ตั้งค่าเท่านั้น คุณจะลบแพ็กเกจราคาหลังจากที่เผยแพร่แล้วไม่ได้ แต่สามารถทำให้แพ็กเกจราคาหมดอายุและแทนที่ด้วยแพ็กเกจราคาในอนาคตตามที่อธิบายไว้ในแพ็กเกจราคาที่เผยแพร่แล้วหมดอายุ

Classic Edge (Private Cloud)

หากต้องการสร้างแพ็กเกจราคาเวอร์ชันในอนาคตที่จะเริ่มขึ้นหลังจากวันนี้โดยใช้ UI แบบคลาสสิก โปรดทำตามขั้นตอนต่อไปนี้

  1. ในแคตตาล็อกแพ็กเกจ ให้คลิก +อนาคตในคอลัมน์ฉบับร่าง/อนาคตสำหรับแพ็กเกจราคาที่คุณต้องการแทนที่

    การดำเนินการนี้จะเปิดหน้าต่างแพ็กเกจราคาในอนาคตขึ้นมา

    ความแตกต่างหลักระหว่างกรอบเวลาแพ็กเกจราคาในอนาคตกับกรอบเวลาแพ็กเกจราคาปัจจุบันคือการเพิ่มส่วนสมาชิกที่มีอยู่

  2. เช่นเดียวกับที่คุณทำกับแพ็กเกจราคาทั้งหมด
  3. ในส่วน "สมาชิกที่มีอยู่" ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
    • เริ่มระยะเวลาสัญญาทั้งหมดอีกครั้งในวันที่มีผลใหม่ แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคตจะเหมือนกับของแพ็กเกจราคาปัจจุบัน
    • หักเวลาที่ใช้ในสัญญาก่อนหน้าจากระยะเวลาใหม่ในวันที่มีผล แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล เวลาที่ใช้แพ็กเกจราคาปัจจุบันจะถูกหักออกจากระยะเวลาต่ออายุของแพ็กเกจราคาในอนาคต ซึ่งหมายความว่าหากนักพัฒนาแอปใช้แพ็กเกจปัจจุบันเป็นเวลา 3 เดือน และระยะเวลาการต่ออายุจะลดลง 3 เดือน
  4. ในช่องวันที่มีผล ให้ป้อนวันที่เริ่มต้นที่เกิดขึ้นหลังวันที่สิ้นสุดของแพ็กเกจราคาที่มีอยู่

การสร้างแพ็กเกจราคาในอนาคตโดยใช้ API

คุณสร้างแพ็กเกจราคาในอนาคตได้โดยใช้ API โดยการส่งคำขอ POST ไปยัง /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision

โดยที่

  • {org_id} คือชื่อองค์กร
  • {package_id} คือตัวระบุแพ็กเกจ API
  • {plan_Id} คือตัวระบุแพ็กเกจราคา
เมื่อสร้างการแก้ไข คุณต้องระบุพร็อพเพอร์ตี้ต่อไปนี้ในเนื้อหาคำขอ
  • parentRatePlan ระบุรหัสของแพ็กเกจราคาเดิม
  • startDate ระบุวันที่ที่แผนใหม่จะมีผล

ชื่อของแพ็กเกจราคาในอนาคตไม่จำเป็นต้องตรงกับชื่อของแพ็กเกจเดิม หากคุณต้องการบันทึกวันที่เริ่มต้นเดิมสำหรับนักพัฒนาซอฟต์แวร์ไว้ ให้ตั้งค่าแฟล็ก keepOriginalStartDate เป็น true ซึ่งมีค่าเริ่มต้นเป็น false

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าได้ที่ การตั้งค่าการกำหนดค่าสำหรับแพ็กเกจราคา

ตัวอย่างเช่น คำขอต่อไปนี้จะสร้างแพ็กเกจราคาในอนาคต

$ 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