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

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

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