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

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