פתרון בעיות שקשורות לשגיאות ב-API של ניתוח נתוני השיחות

אם נתקלתם בבעיות במהלך השימוש ב-Conversational Analytics API, תוכלו להיעזר בטבלה הבאה כדי למצוא פתרונות אפשריים.

שגיאה הסיבה לשגיאה קוד סטטוס של HTTP קוד סטטוס של gRPC הפתרון
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 המשאב כבר קיים (לדוגמה, אם אתם יוצרים רשומה כפולה). לפני שיוצרים את המשאב, צריך להשתמש במזהה אחר או לוודא שהמשאב לא קיים כבר.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 הקלט לא תקין או שהפורמט שלו שגוי. לפני ששולחים את הבקשה, צריך לאמת את הקלט או את מטען הייעודי (payload).
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 האימות שלך בוצע, אבל אין לך הרשאה לגשת למשאב. בודקים את התפקיד וההרשאות של המשתמש. אם צריך, אפשר לפנות לאדמין.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 הבקשה מפרה את מצב המערכת (לדוגמה, ניסיון למחוק תיקייה לא ריקה). בודקים את התנאים המוקדמים ומתקנים את הלוגיקה.
NotFoundException NOT_FOUND 404 Not Found 5

המשאב לא נמצא. בודקים את מזהי המשאבים או כתובות ה-URL. מוודאים שהמשאב קיים לפני שמנסים לגשת אליו.

מידע נוסף על פתרון בעיות זמין במאמר שאלות נפוצות על Conversational Analytics API.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 יש בעיה זמנית בשרת. צריך להמתין ולנסות שוב עם השהיה מעריכית לפני ניסיון חוזר בין הניסיונות. אם השגיאה נמשכת, אפשר לדווח על באג.
UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 נדרש אימות, או שהאימות נכשל. חשוב לוודא שאתם משתמשים בפרטי הכניסה, במפתח ה-API או בטוקן הנכונים.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 התכונה המבוקשת לא זמינה או לא נתמכת. לא מומלץ לבצע קריאה ל-API הזה, או לחכות להטמעה.

מקורות מידע נוספים

טיפים נוספים לפתרון בעיות ותשובות לשאלות נפוצות זמינים בדף שאלות נפוצות על Conversational Analytics API.

במאמר איך שואלים שאלות יעילות מוסבר איך לשאול שאלות יעילות ב-Conversational Analytics API.