Method: subscriptions.changePlan

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
customerId

string

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

string

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

גוף הבקשה

גוף הבקשה מכיל מופע של 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)

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

string

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

string

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