פתרון בעיות ב-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 צריך לוודא שאתם קוראים לשיטה הזו רק בתוכניות התשלומים הבאות עם התחייבות:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

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

429:usageLimits.quotaExceeded

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

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