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 נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
customerId

string

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

subscriptionId

string

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

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