פתרון בעיות ב-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.