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

אם נתקלתם בבעיות במהלך השימוש ב-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 יש בעיה זמנית בשרת. צריך להמתין ולנסות שוב עם השהיה מעריכית לפני ניסיון חוזר בין הניסיונות. אם השגיאה נמשכת, אפשר לדווח על באג.
Connection reset by peer (במהלך הסטרימינג) UNAVAILABLE 503 Service Unavailable 14

אם אתם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה של הסטרימינג :chat, יכול להיות שהשרת נתקל בשגיאה חמורה (כמו זמן קצוב לתפוגה או דחיית הרשאה) במהלך הסטרימינג. מכיוון שכותרות ה-HTTP כבר נשלחות, קוד השגיאה האמיתי ממוקם בטריילרים של HTTP/2, שלקוחות REST רגילים לא יכולים לנתח, וכתוצאה מכך מתרחשת קריסת שקע.

מומלץ להשתמש בספריות הלקוח הרשמיות של Google Cloud gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות האלה בסוף ההודעה ומציגות את הסיבה האמיתית לשגיאה.
Internal error encountered (במהלך הסטרימינג) INTERNAL 500 Internal Server Error 13

אם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה של הסטרימינג :chat, יכול להיות שהשרת נתקל בשגיאה קריטית במהלך הסטרימינג. מכיוון שכותרות ה-HTTP כבר נשלחות, קוד השגיאה האמיתי ממוקם בטריילרים של HTTP/2, שלקוחות REST רגילים לא יכולים לנתח, וכתוצאה מכך מתרחשת קריסת שקע.

מומלץ להשתמש בספריות הלקוח הרשמיות של Google Cloud gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות האלה בסוף ההודעה ומציגות את הסיבה האמיתית לשגיאה.
UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 נדרש אימות, או שהאימות נכשל. חשוב לוודא שאתם משתמשים בפרטי הכניסה, במפתח ה-API או בטוקן הנכונים.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 התכונה המבוקשת לא זמינה או לא נתמכת. לא מומלץ לבצע קריאה ל-API הזה, או לחכות להטמעה.

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

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

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