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 ב-Subscriptions.changePlan.

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

string

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

string

המאפיין planName הוא חובה. זהו השם של תוכנית התמחור והתשלומים של המינוי. למידע נוסף על תוכניות התמחור והתשלומים של 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. המאפיין הזה הוא אופציונלי. אם כבר הוספתם קוד עסקה למינוי, יכול להיות שהנכס הזה יישאר ריק והתעריף המוזל הקיים עדיין יחול (אם השדה לא ריק, יש לספק רק את קוד העסקה שכבר קיים במינוי). אם אף פעם לא נוסף קוד עסקה למינוי והנכס הזה נשאר ריק, יחול המחיר הרגיל.