דף זה תורגם על ידי Cloud Translation API.

פתרון בעיות ב-Seller API

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

`400:badRequest`

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

`400:invalid`

השגיאה הזו יכולה לקרות מכמה סיבות.

אם משתמשים בשיטה customers.insert, אחד מהלקוחות הבאים הפרמטרים של האובייקט לא חוקיים:

שם המדינה postalAddress.postalCode לא חוקי
postalAddress.countryCode לא עומד בדרישות להפצה של Google Workspace.
alternateEmail לא יכול להיות באותו דומיין כמו customerDomain

כדי לפתור את הבעיה, צריך לוודא שהפרמטרים הנדרשים קיימים ותקפים הלקוח.

אם אתם משתמשים בשיטה subscriptions.changeSeats, אחת מהאפשרויות הבאות ייתכן שבעיות גרמו לשגיאה הזו:

במינוי שנתי אי אפשר להקטין את מספר העמדות. נקודות שכדאי להעלות שינוי הגדרות החידוש. למינוי יוגדר באופן אוטומטי (בזמן החידוש) מושבים שווים מספר המשתמשים הפעילים בחשבון.
סכום העמדות שביקשת קטן ממספר המשתמשים הנוכחי חשבון. שליחת הודעה ללקוח שצריך להסיר משתמש כדי שיוכל להקטין את מספר המושבים שלהם.
הגדלת את פרמטר המושב השגוי. בתוכנית FLEX צריך להגדיל הפרמטר maximumNumberOfSeats, ובתוכנית ANNUAL, מגדילים את פרמטר numberOfSeats.
ניסיתם לשנות את הפרמטר licensedNumberOfSeats, שהוא לקריאה בלבד.
במהלך תקופת הניסיון, מגבלת העמדות של הלקוחות היא 10. התחלת שירות בתשלום ממינוי לתקופת ניסיון בחינם כדי: לסיים את תקופת הניסיון באופן מיידי, להתחיל את החיוב ולהסיר את 10 המושבים .

`403:forbidden`

השגיאה הזו מתקבלת אם הלקוח לא מוגדר כבעלים או שהלקוח השבית גישת המפיץ למסוף Admin שלו.

`403:usageLimits.dailyLimitExceeded`

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

אם ניסית לאחזר מינויים רבים, כדאי להשתמש השיטה subscriptions.list בלי לציין את customerId או subscriptionId פרמטרים. אפשר להחזיר עד 100 מינויים בכל פעם שיחה. כדי להמשיך לאחזר את כל המינויים, צריך להשתמש בפרמטר pageToken בחשבון מפיץ.

`403:usageLimits.accessNotConfigured`

שגיאה זו מתרחשת כשה-API לא מופעל בפרויקט ב-Google Cloud. כדי לפתור את הבעיה צריך להיכנס למסוף Google Cloud ולהפעיל את ה-API. לקבלת מידע נוסף מידע נוסף, ראה הפעלת ממשקי API של Google Workspace.

`404:notFound`

כשמשתמשים בשיטה customers.get, משמעות השגיאה הזו היא שהלקוח או לא קיים באף חשבון Google Workspace הדומיין זמין.

`412:conditionNotMet`

השגיאה הזו נגרמת מכמה בעיות שונות.

אם השגיאה הזו מופיעה כשאתם משתמשים בsubscriptions.changeRenewalSettings ה-method הזה, ודאו שאתם מפעילים את השיטה הזו רק תוכניות תמחור התחייבות:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

אם השגיאה הזו מופיעה כשאתם משתמשים בשיטה subscriptions.delete, היא כלומר אין ב-Google Workspace משתמש עם הרשאת אדמין חשבון. כדי לפתור את הבעיה, צריך להוסיף משתמש זמני עם הרשאת אדמין ולנסות שוב.

אם השגיאה הזו מופיעה כשאתם משתמשים בשיטה subscriptions.insert, היא פירושו שאינך יכול להפיץ את המק"ט שנבחר או לשוק בצמיחה לכל לקוח. כדי לפתור את הבעיה, צריך לאשר את התנאים וההגבלות החלים.

`429:usageLimits.quotaExceeded`

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