Method: subscriptions.suspend

השעיית מינוי פעיל.

אפשר להשתמש בשיטה הזו כדי להשעות מינוי בתשלום שנמצא כרגע במצב ACTIVE.

  • בחיוב של מינויים ל-FLEXIBLE, החיוב מושהה.
  • למינויים מסוג ANNUAL_MONTHLY_PAY או ANNUAL_YEARLY_PAY:
    • השעיית המינוי לא משנה את תאריך החידוש שהתחייבתם אליו במקור.
    • מינוי שהושעה לא מתחדש.  אם תפעילו את המינוי אחרי תאריך החידוש המקורי, ייוצר מינוי שנתי חדש שיתחיל לפעול מהיום שבו תפעילו אותו.

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

string

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

היקפי הרשאה

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

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

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