עדכון של תוכנית מנויים. אפשר להשתמש בשיטה הזו כדי לעדכן תוכנית לתקופת ניסיון של 30 יום או למינוי בתוכנית גמישה לתוכנית בהתחייבות שנתית עם תשלומים חודשיים או שנתיים.
אופן העדכון של התוכנית משתנה בהתאם לתוכנית ולמוצרים. מידע נוסף זמין בתיאור שבמאמר ניהול מינויים.
בקשת HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
המזהה הזה יכול להיות שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח. אם שם הדומיין של הלקוח משתנה, לא ניתן להשתמש בשם הדומיין הישן כדי לגשת ללקוח, אבל תמיד אפשר להשתמש במזהה הייחודי של הלקוח (כפי שמוחזר על ידי ה-API). מומלץ לשמור את המזהה הייחודי במערכות, היכן שהדבר רלוונטי. |
subscriptionId |
זהו נכס חובה. |
גוף הבקשה
גוף הבקשה מכיל מופע של ChangePlanRequest
.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Subscription
.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/apps.order
למידע נוסף, ניתן לעיין במדריך ההרשאות.
ChangePlanRequest
תבנית JSON עבור בקשת ה-rpc של subscription.changePlan.
ייצוג JSON |
---|
{
"kind": string,
"planName": string,
"seats": {
object ( |
שדות | |
---|---|
kind |
מזהה את המשאב כבקשה לשינוי תוכנית המינוי. ערך: |
planName |
המאפיין
|
seats |
זהו נכס חובה. מאפיין המושבים מייצג את מספר רישיונות העמדות של המשתמשים. |
purchaseOrderId |
זהו מאפיין אופציונלי. הפרטים של הזמנת הרכש (PO) מיועדים למפיצים לשימוש במעקב של החברה שלהם. אם הוזן ערך של |
dealCode |
קוד מאת Google (100 תווים לכל היותר) לתמחור מוזל של תוכניות מנויים. יש לכלול את קוד המבצע בבקשה |