אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
מבוא
אחרי שמפרסמים תוכנית מחירים קיימת, אפשר לשנות רק את תאריך הסיום שלה. עם זאת, אתם יכולים ליצור גרסה חדשה של התוכנית שתכלול מאפיינים ששונו, כמו מחירים ששונו בתוכנית המחירים. אפשר להגדיר שהשינוי ייכנס לתוקף בתאריך עתידי. התוכנית המקורית מסתיימת כשהשינוי נכנס לתוקף.
לדוגמה, נניח שיצרתם תוכנית תמחור רגילה שתוקפה יפוג ב-31 בדצמבר 2019, ואתם רוצים להחליף אותה בתוכנית אחרת שתתחיל ב-1 בינואר 2020. כדי לעשות את זה, יוצרים תוכנית מחירים עתידית ומגדירים שהיא תיכנס לתוקף ב-1 בינואר 2020.
אם לא הוגדר תאריך סיום לתוכנית התמחור הנוכחית, אפשר להחליף תוכנית תמחור קיימת בתוכנית תמחור עתידית שתתחיל כבר היום. צריך להגדיר את תוכנית התמחור הנוכחית כלא פעילה, כמו שמתואר במאמר הגדרת תוכנית תמחור שפורסמה כלא פעילה.
המפתחים מקבלים הודעה על תוכנית התמחור המעודכנת. מפתחים שמקבלים את תוכנית התמחור המקורית נרשמים אוטומטית לגרסה המתוקנת (אבל יש להם אפשרות לדחות את הגרסה המתוקנת).
אתם יכולים ליצור תוכנית תמחור עתידית באמצעות ממשק הניהול או ה-API של המוניטיזציה, כמו שמתואר בקטעים הבאים.
יצירת תוכנית תמחור עתידית באמצעות ממשק המשתמש
יוצרים תוכנית תמחור עתידית, כמו שמתואר בהמשך.
Edge
כדי ליצור גרסה עתידית של תוכנית תמחור שתתחיל מתישהו אחרי היום באמצעות ממשק המשתמש של Edge, מבצעים את השלבים הבאים.
- בדף Rate Plans, מציבים את הסמן בשורה שמשויכת לתוכנית התמחור שרוצים ליצור לה תוכנית תמחור עתידית.
לתוכנית התמחור חייב להיות תאריך סיום. - לוחצים על +עתידי.
- בקטע תוכנית עתידית, בוחרים אחת מהאפשרויות הבאות:
- הפעלה מחדש של תקופת החוזה המלאה בתאריך כניסה לתוקף חדש: תוכנית התמחור העתידית תיכנס לתוקף בתאריך הכניסה לתוקף. תקופת החידוש של תוכנית התמחור העתידית זהה לזו של תוכנית התמחור הנוכחית.
- ניכוי הזמן שחלף בחוזה הקודם מהתקופה החדשה, במועד הכניסה לתוקף: תוכנית התמחור העתידית תיכנס לתוקף במועד הכניסה לתוקף. הזמן שבו השתמשתם בתוכנית התמחור הנוכחית מנוכה מתקופת החידוש של תוכנית התמחור העתידית. כלומר, אם מפתח משתמש בתוכנית הנוכחית במשך 3 חודשים, תקופת החידוש תקוצר ב-3 חודשים.
- מגדירים את השדות הבאים בחלונית העליונה:
הערה: שדות אחרים הם לקריאה בלבד.שדה תיאור ברירת מחדל חובה שם תוכנית התמחור השם של תוכנית התמחור.
הערה: השם לא צריך להיות זהה לשם המקורי של תוכנית התמחור.
שם התוכנית הקיימת כן תאריך התחלה התאריך שבו תוכנית התמחור נכנסת לתוקף. מזינים תאריך התחלה או בוחרים תאריך באמצעות היומן. היום לא תאריך סיום התאריך שבו תוכנית התמחור מסתיימת. כדי לציין תאריך סיום, מפעילים את המתג יש תאריך סיום ומזינים תאריך סיום או בוחרים תאריך באמצעות היומן. הערה: תוכנית התמחור תהיה בתוקף עד סוף היום בתאריך שצוין. לדוגמה, אם רוצים להגדיר שתוקף תוכנית המחירים יפוג ב-1 בדצמבר 2018, צריך להגדיר את הערך של endDate ל-2018-11-30. במקרה כזה, תוקף תוכנית התמחור יפוג בסוף היום ב-30 בנובמבר 2018, וכל הבקשות ב-1 בדצמבר 2018 ייחסמו.
ללא לא גלוי לפורטלים קובעים אם תוכנית התמחור תהיה גלויה לכולם או פרטית. השוואה בין תוכניות תמחור ציבוריות לפרטיות מופעל לא - מגדירים את העמלות לתוכנית התמחור. הגדרת עמלות
הערה: לא רלוונטי לתוכניות התראות שניתנות להתאמה. - אם בוחרים חבילת מוצרים שמכילה יותר ממוצר API אחד, צריך להגדיר את ההעדפות הבאות בקטע Specific or generic rate plan:
הערה: השלב הזה לא רלוונטי לתוכניות עם התראות שניתנות להתאמה.
שדה תיאור ברירת מחדל הגדרת כל מוצר בנפרד דגל שמציין אם להגדיר תוכנית תמחור נפרדת לכל מוצר API. מושבת הגדרת מבצע פרימיום לכל מוצר בנפרד דגל שמציין אם להגדיר תוכנית פרימיום לכל מוצר API. מושבת בחר מוצר אם מפעילים את אחד מהדגלים או את שניהם, צריך לבחור כל מוצר בנפרד מהתפריט הנפתח ולהגדיר את פרטי תוכנית התמחור שלו. הערה: חשוב להגדיר את כל המוצרים בחבילת המוצרים.
לא רלוונטי - מגדירים את פרטי תוכנית התמחור בהתאם לסוג תוכנית התמחור שנבחר:
- לוחצים על אחת מהאפשרויות הבאות:
כפתור תיאור עדכון הטיוטה שומרים את תוכנית התמחור כטיוטה. תוכנית התמחור לא תהיה גלויה למפתחי אפליקציות עד שתפרסמו אותה. אפשר לערוך כל שדה בתוכנית תמחור בסטטוס טיוטה.
פרסום טיוטה מפרסמים את התוכנית. הערה: אחרי שמפרסמים תוכנית מחירים, אפשר לשנות רק את תאריך הסיום, אם הוא עדיין לא הוגדר. אי אפשר למחוק תוכנית תמחור אחרי שהיא פורסמה, אבל אפשר להגדיר שהיא תפוג ולהחליף אותה בתוכנית תמחור עתידית, כמו שמתואר במאמר הגדרת תפוגה לתוכנית תמחור שפורסמה.
Classic Edge (ענן פרטי)
כדי ליצור גרסה עתידית של תוכנית תמחור שתתחיל מתישהו אחרי היום באמצעות ממשק המשתמש הקלאסי של Edge, מבצעים את השלבים הבאים.
- בקטלוג החבילות, לוחצים על +עתידי בעמודה 'טיוטה/עתידי' של תוכנית התמחור שרוצים להחליף.
ייפתח חלון עם תוכנית מחירים עתידית.
ההבדל העיקרי בין חלון של תוכנית מחירים עתידית לבין חלון של תוכנית מחירים נוכחית הוא הוספה של קטע 'מינויים קיימים'.
- כמו בכל תוכנית מחירים:
- מזינים שם לתוכנית בשדה Rate Plan Name (שם תוכנית התמחור). השם לא צריך להיות זהה לשם של תוכנית התמחור המקורית.
- הגדרת עמלות לתוכנית תמחור (אופציונלי).
- מגדירים את פרטי תוכנית התמחור בהתאם לסוג תוכנית התמחור שנבחר:
- מציינים תאריך שבו התוכנית העתידית תיכנס לתוקף (ראו פרסום תוכניות תמחור), ותאריך סיום (אפשר גם לבחור באפשרות 'ללא תאריך סיום' אם לא רוצים שתאריך הסיום של תוכנית התמחור העתידית יהיה תאריך ספציפי). אם מוגדר תאריך סיום לתוכנית הנוכחית, תאריך הכניסה לתוקף של התוכנית העתידית צריך להיות אחרי תאריך הסיום של התוכנית הנוכחית.
- בקטע 'מנויים קיימים', בוחרים באחת מהאפשרויות הבאות:
- התחלה מחדש של תקופת החוזה המלאה במועד כניסה לתוקף חדש. תוכנית התמחור העתידית תיכנס לתוקף בתאריך התחילה. תקופת החידוש של תוכנית התמחור העתידית זהה לזו של תוכנית התמחור הנוכחית.
- הזמן שחלף מאז החוזה הקודם ינוכה מהתקופה החדשה, במועד הכניסה לתוקף. התוכנית העתידית תיכנס לתוקף בתאריך התחילה. הזמן שבו השתמשתם בתוכנית התמחור הנוכחית מנוכה מתקופת החידוש של תוכנית התמחור העתידית. כלומר, אם מפתח משתמש בתוכנית הנוכחית במשך 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