Method: subscriptions.changePlan

עדכון של תוכנית מנויים. אפשר להשתמש בשיטה הזו כדי לעדכן תוכנית לתקופת ניסיון של 30 יום או למינוי בתוכנית גמישה לתוכנית בהתחייבות שנתית עם תשלומים חודשיים או שנתיים.

אופן העדכון של התוכנית משתנה בהתאם לתוכנית ולמוצרים. מידע נוסף זמין בתיאור שבמאמר ניהול מינויים.

בקשת HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

המזהה הזה יכול להיות שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח. אם שם הדומיין של הלקוח משתנה, לא ניתן להשתמש בשם הדומיין הישן כדי לגשת ללקוח, אבל תמיד אפשר להשתמש במזהה הייחודי של הלקוח (כפי שמוחזר על ידי ה-API). מומלץ לשמור את המזהה הייחודי במערכות, היכן שהדבר רלוונטי.
subscriptionId

string

זהו נכס חובה. subscriptionId הוא מזהה המינוי, והוא ייחודי לכל לקוח. subscriptionId משתנה כשמינוי מתעדכן, ולכן מומלץ לא להשתמש במזהה הזה כמפתח לנתונים קבועים. כמו כן, ניתן למצוא את subscriptionId באמצעות השיטה אחזור כל המינויים למפיצים.

גוף הבקשה

גוף הבקשה מכיל מופע של ChangePlanRequest.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Subscription.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/apps.order

למידע נוסף, ניתן לעיין במדריך ההרשאות.

ChangePlanRequest

תבנית JSON עבור בקשת ה-rpc של subscription.changePlan.

ייצוג JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
שדות
kind

string

מזהה את המשאב כבקשה לשינוי תוכנית המינוי. ערך: subscriptions#changePlanRequest
planName

string

המאפיין planName נדרש. זהו השם של תוכנית התמחור והתשלומים של המינוי. מידע נוסף על תוכניות התמחור והתשלומים של Google זמין במאמר מושגים של Google API.

הערכים האפשריים הם:

  • ANNUAL_MONTHLY_PAY - תוכנית ההתחייבות השנתית עם תשלומים חודשיים
  • ANNUAL_YEARLY_PAY - תוכנית ההתחייבות השנתית עם תשלומים שנתיים
  • FLEXIBLE – התוכנית הגמישה
  • TRIAL – תקופת הניסיון בחינם למשך 30 יום

seats

object (Seats)

זהו נכס חובה. מאפיין המושבים מייצג את מספר רישיונות העמדות של המשתמשים.
purchaseOrderId

string

זהו מאפיין אופציונלי. הפרטים של הזמנת הרכש (PO) מיועדים למפיצים לשימוש במעקב של החברה שלהם. אם הוזן ערך של purchaseOrderId, הוא יופיע בתשובות ה-API ויופיע בחשבונית. אפשר להזין בנכס עד 80 תווים של טקסט פשוט.
dealCode

string

קוד מאת Google (100 תווים לכל היותר) לתמחור מוזל של תוכניות מנויים. יש לכלול את קוד המבצע בבקשה changePlan כדי לקבל תעריף מוזל. המאפיין הזה הוא אופציונלי. אם כבר נוסף קוד עסקה למינוי, יכול להיות להשאיר את הנכס הזה ריק והתעריף המוזל הקיים עדיין יהיה תקף (אם הוא לא ריק, צריך לציין רק את קוד המבצע שכבר קיים במינוי). אם קוד עסקה מעולם לא נוסף למינוי, והנכס הזה נשאר ריק, יחול המחיר הרגיל.