คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่
เอกสารประกอบของ Apigee X info
บทนำ
หลังจากเผยแพร่แพ็กเกจราคาที่มีอยู่แล้ว พร็อพเพอร์ตี้เดียวที่คุณเปลี่ยนแปลงได้คือวันที่สิ้นสุด อย่างไรก็ตาม คุณสามารถสร้างแพ็กเกจเวอร์ชันใหม่ที่มีพร็อพเพอร์ตี้ที่เปลี่ยนแปลงไป เช่น อัตราแพ็กเกจราคาที่เปลี่ยนแปลง และตั้งค่าให้การแก้ไขมีผลในอนาคตได้ แพ็กเกจราคาเดิมจะสิ้นสุดลงเมื่อการแก้ไขมีผล
ตัวอย่างเช่น สมมติว่าคุณสร้างแพ็กเกจราคามาตรฐานที่หมดอายุในวันที่ 31 ธันวาคม 2019 และ ต้องการแทนที่ด้วยแพ็กเกจอื่นที่จะมีผลในวันที่ 1 มกราคม 2020 คุณต้องสร้างแพ็กเกจราคาในอนาคตและตั้งค่าให้มีผลในวันที่ 1 มกราคม 2020
หากไม่ได้ตั้งค่าวันที่สิ้นสุดสำหรับแพ็กเกจราคาปัจจุบัน คุณสามารถแทนที่แพ็กเกจราคาที่มีอยู่ด้วย แพ็กเกจราคาในอนาคตที่จะเริ่มได้เร็วที่สุดคือวันนี้ คุณจะต้องทำให้แพ็กเกจราคาปัจจุบันหมดอายุตามที่อธิบายไว้ในหัวข้อทำให้แพ็กเกจราคาที่เผยแพร่หมดอายุ
นักพัฒนาแอปจะได้รับการแจ้งเตือนเกี่ยวกับแพ็กเกจราคาที่แก้ไขแล้ว นักพัฒนาแอปที่ยอมรับแพ็กเกจราคาเดิม จะได้รับการลงทะเบียนสำหรับการแก้ไขโดยอัตโนมัติ (แต่มีตัวเลือกในการปฏิเสธการ แก้ไข)
คุณสามารถสร้างแพ็กเกจราคาในอนาคตได้โดยใช้ UI การจัดการหรือ Monetization API ตามที่อธิบายไว้ใน ส่วนต่อไปนี้
การสร้างแพ็กเกจราคาในอนาคตโดยใช้ UI
สร้างแพ็กเกจราคาในอนาคตตามที่อธิบายไว้ด้านล่าง
Edge
หากต้องการสร้างแพ็กเกจราคาเวอร์ชันในอนาคตที่จะเริ่มหลังจากวันนี้ โดยใช้ Edge UI ให้ทำตามขั้นตอนต่อไปนี้
- ในหน้า แพ็กเกจราคา
ให้วางเคอร์เซอร์ไว้ในแถวที่เชื่อมโยงกับแพ็กเกจราคาที่คุณต้องการสร้างแพ็กเกจราคาในอนาคต
แพ็กเกจราคาต้องมีวันที่สิ้นสุด - คลิก +อนาคต
- ในส่วนแพ็กเกจราคาในอนาคต ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
- เริ่มระยะเวลาสัญญาเต็มรูปแบบใหม่ในวันที่มีผลใหม่: แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคตจะเหมือนกับ แพ็กเกจราคาปัจจุบัน
- หักเวลาที่ใช้ในสัญญาเดิมออกจากระยะเวลาใหม่ในวันที่มีผล: แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระบบจะหักเวลาที่ใช้แพ็กเกจราคาปัจจุบัน ออกจากระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคต ซึ่งหมายความว่าหากนักพัฒนาแอปใช้แพ็กเกจปัจจุบันเป็นเวลา 3 เดือน ระยะเวลาการต่ออายุจะลดลง 3 เดือน
- กำหนดค่าช่องต่อไปนี้ในแผงด้านบน:
หมายเหตุ: ช่องอื่นๆ เป็นแบบอ่านอย่างเดียวช่อง คำอธิบาย ค่าเริ่มต้น ต้องระบุ ชื่อแพ็กเกจราคา ชื่อแพ็กเกจราคา
หมายเหตุ: ชื่อไม่จำเป็นต้องตรงกับชื่อแพ็กเกจราคาเดิม
ชื่อแพ็กเกจที่มีอยู่ ใช่ วันที่เริ่มต้น วันที่แพ็กเกจราคามีผล ป้อนวันที่เริ่มต้นหรือเลือกวันที่โดยใช้ปฏิทิน วันนี้ ไม่ วันที่สิ้นสุด วันที่แพ็กเกจราคาสิ้นสุด หากต้องการระบุวันที่สิ้นสุด ให้เปิดใช้ปุ่มเปิด/ปิดมีวันที่สิ้นสุด แล้วป้อนวันที่สิ้นสุดหรือเลือกวันที่โดยใช้ปฏิทิน หมายเหตุ: แพ็กเกจราคาจะมีผลจนถึงสิ้นวัน ในวันที่ระบุ เช่น หากต้องการให้แพ็กเกจราคาสิ้นสุดในวันที่ 1 ธันวาคม 2018 คุณควรตั้งค่า endDate เป็น 2018-11-30 ในกรณีนี้ แพ็กเกจราคาจะหมดอายุในสิ้นวันที่ 30 พฤศจิกายน 2018 และระบบจะบล็อกคำขอทั้งหมดในวันที่ 1 ธันวาคม 2018
ไม่มี ไม่ แสดงต่อพอร์ทัล ตั้งค่าว่าแพ็กเกจราคาเป็นแบบสาธารณะหรือส่วนตัว ดูแพ็กเกจราคาสาธารณะกับอัตราส่วนลดเฉพาะบุคคล เปิดใช้อยู่ ไม่ - กำหนดค่าธรรมเนียมสำหรับแพ็กเกจราคา ดูการกำหนดค่าธรรมเนียม
หมายเหตุ: ใช้ไม่ได้กับแพ็กเกจการแจ้งเตือนที่ปรับได้ - หากคุณเลือกชุดผลิตภัณฑ์ที่มีผลิตภัณฑ์ API มากกว่า 1 รายการ ให้ตั้งค่ากำหนดต่อไปนี้ในส่วนแพ็กเกจราคาเฉพาะหรือทั่วไป
หมายเหตุ: ขั้นตอนนี้ใช้ไม่ได้กับแพ็กเกจการแจ้งเตือนที่ปรับได้
ช่อง คำอธิบาย ค่าเริ่มต้น กำหนดค่าผลิตภัณฑ์แต่ละรายการแยกกัน แฟล็กที่ระบุว่าจะกำหนดค่าแพ็กเกจราคาแต่ละรายการสำหรับผลิตภัณฑ์ API แต่ละรายการหรือไม่ ปิดใช้ กำหนดค่าข้อเสนอฟรีเมียมของผลิตภัณฑ์แต่ละรายการแยกกัน แฟล็กที่ระบุว่าจะกำหนดค่าแพ็กเกจฟรีเมียมสำหรับผลิตภัณฑ์ API แต่ละรายการหรือไม่ ปิดใช้ เลือกผลิตภัณฑ์ หากเปิดใช้แฟล็กอย่างน้อย 1 รายการ คุณต้องเลือกผลิตภัณฑ์แต่ละรายการจากรายการแบบเลื่อนลงและกำหนดค่ารายละเอียดแพ็กเกจราคา หมายเหตุ: ตรวจสอบว่าคุณได้กำหนดค่าสินค้าทั้งหมดในชุดผลิตภัณฑ์แล้ว
ไม่มี - กำหนดค่ารายละเอียดแพ็กเกจราคาตามประเภทแพ็กเกจราคาที่เลือก
- คลิกปุ่มใดปุ่มหนึ่งต่อไปนี้
ปุ่ม คำอธิบาย อัปเดตฉบับร่าง บันทึกแพ็กเกจราคาเป็นฉบับร่าง นักพัฒนาแอปจะมองไม่เห็นแพ็กเกจราคาจนกว่าคุณจะเผยแพร่ คุณแก้ไขช่องใดก็ได้ในแพ็กเกจราคาฉบับร่าง
เผยแพร่ฉบับร่าง เผยแพร่แพ็กเกจ หมายเหตุ: หลังจากเผยแพร่แพ็กเกจราคาแล้ว คุณจะแก้ไขได้เฉพาะวันที่สิ้นสุดหากยังไม่ได้ตั้งค่า คุณไม่สามารถลบแพ็กเกจราคาหลังจากเผยแพร่แล้ว แต่สามารถทำให้แพ็กเกจราคาหมดอายุและแทนที่ด้วยแพ็กเกจราคาในอนาคตได้ตามที่อธิบายไว้ในหัวข้อ ทำให้แพ็กเกจราคาที่เผยแพร่หมดอายุ
Classic Edge (Private Cloud)
หากต้องการสร้างแพ็กเกจราคาเวอร์ชันในอนาคตที่จะเริ่มหลังจากวันนี้ โดยใช้ Classic Edge UI ให้ทำตามขั้นตอนต่อไปนี้
- ในแคตตาล็อกแพ็กเกจ ให้คลิก +อนาคต ในคอลัมน์ฉบับร่าง/อนาคตสำหรับ
แพ็กเกจราคาที่คุณต้องการแทนที่
ซึ่งจะเป็นการเปิดหน้าต่างแพ็กเกจราคาในอนาคต
ความแตกต่างหลักระหว่างหน้าต่างแพ็กเกจราคาในอนาคตกับหน้าต่างแพ็กเกจราคาปัจจุบันคือ การเพิ่มส่วนผู้สมัครใช้บริการที่มีอยู่
- ทำดังนี้เช่นเดียวกับแพ็กเกจราคาอื่นๆ
- ป้อนชื่อแพ็กเกจในช่องชื่อแพ็กเกจราคา ชื่อไม่จำเป็นต้องตรงกับ ชื่อแพ็กเกจราคาเดิม
- กำหนดค่าธรรมเนียมสำหรับแพ็กเกจราคา (ไม่บังคับ)
- กำหนดค่ารายละเอียดแพ็กเกจราคาตามประเภทแพ็กเกจราคาที่เลือก
- ระบุวันที่ที่แพ็กเกจในอนาคตจะมีผล (ดู การเผยแพร่แพ็กเกจราคา) และวันที่สิ้นสุด (คุณยังเลือก "ไม่มีวันที่สิ้นสุด" ได้ด้วยหากไม่ต้องการให้แพ็กเกจราคาในอนาคตสิ้นสุดในวันที่ที่เฉพาะเจาะจง) หากตั้งค่าวันที่สิ้นสุดสำหรับแพ็กเกจปัจจุบัน วันที่มีผลของแพ็กเกจในอนาคตควรอยู่หลังจากวันที่สิ้นสุดของแพ็กเกจปัจจุบัน
- ในส่วนผู้สมัครใช้บริการที่มีอยู่ ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
- เริ่มระยะเวลาสัญญาเต็มรูปแบบใหม่ในวันที่มีผลใหม่ แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคตจะเหมือนกับ แพ็กเกจราคาปัจจุบัน
- หักเวลาที่ใช้ในสัญญาเดิมออกจากระยะเวลาใหม่ในวันที่มีผล แพ็กเกจราคาในอนาคตจะมีผลในวันที่มีผล ระบบจะหักเวลาที่ใช้แพ็กเกจราคาปัจจุบัน ออกจากระยะเวลาการต่ออายุของแพ็กเกจราคาในอนาคต ซึ่งหมายความว่าหากนักพัฒนาแอปใช้แพ็กเกจปัจจุบันเป็นเวลา 3 เดือน ระยะเวลาการต่ออายุจะลดลง 3 เดือน
- ในช่องวันที่มีผล ให้ป้อนวันที่เริ่มต้นที่อยู่หลังจากวันที่สิ้นสุดของ แพ็กเกจราคาที่มีอยู่
การสร้างแพ็กเกจราคาในอนาคตโดยใช้ 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