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