Method: subscriptions.insert

יצירה או העברה של מינוי.

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

אם לא הזמנת את החשבון של הלקוח באמצעות שיטת ההוספה של הלקוח, יש להשתמש ב-customerAuthToken של הלקוח במהלך יצירת המינוי שלו.

אם מעבירים מינוי ל-G Suite עם מינוי משויך ל-Google Drive או ל-Google Vault, צריך לבצע את פעולת האצווה כדי להעביר את כל המינויים האלה. למידע נוסף, כדאי לעיין במאמר העברת מינויים.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
customerId

string

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

פרמטרים של שאילתה

פרמטרים
customerAuthToken

string

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

גוף הבקשה

גוף הבקשה מכיל מופע של Subscription.

גוף התגובה

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

היקפי הרשאות

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

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

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