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

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

בדף הזה מתוארות כמה בעיות נפוצות שעשויות להופיע בקשר ל-Reseller 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 הזה. כדי לפתור את הבעיה הזו, צריך להטמיע עיכוב זמן אחזור. מידע נוסף זמין במאמר מכסות ומגבלות שימוש.

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

`403:usageLimits.accessNotConfigured`

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

`404:notFound`

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

`412:conditionNotMet`

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

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

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

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

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

`429:usageLimits.quotaExceeded`

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