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

אם אתם מנסים לאחזר הרבה מינויים, כדאי להשתמש בשיטה 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

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

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