אם נתקלתם בבעיות בשימוש ב-Conversational Analytics API, תוכלו להיעזר בטבלה הבאה כדי למצוא פתרונות אפשריים.
| שגיאה | הסיבה לשגיאה | קוד סטטוס של HTTP | קוד סטטוס gRPC | פתרון |
AlreadyExistsException
|
ALREADY_EXISTS
|
409 Conflict
|
6 | המשאב כבר קיים (לדוגמה, אתם יוצרים רשומה כפולה). צריך להשתמש במזהה אחר או לוודא שהמשאב לא קיים לפני שיוצרים אותו. |
BadRequestException
|
INVALID_ARGUMENT
|
400 Bad Request
|
3 | הקלט לא תקין או שהפורמט שלו שגוי. לפני ששולחים את הבקשה, צריך לאמת את הקלט או את המטען הייעודי (payload). |
BadRequestException (היקף החיפוש) |
INVALID_ARGUMENT |
400 Bad Request |
3 |
היקף החיפוש ב-BigQuery בבקשה לא תקין. כדי לתקן את השגיאה, פועלים לפי ההנחיות שבהודעת השגיאה שקיבלתם:
|
ForbiddenException
|
PERMISSION_DENIED
|
403 Forbidden
|
7 | האימות בוצע, אבל אין לכם הרשאת גישה למשאב. בודקים את תפקיד המשתמש וההרשאות. אם צריך, פנו לאדמין. |
PermissionDenied (מדיניות הארגון) |
PERMISSION_DENIED |
403 Forbidden |
7 | הבקשה מפרה אילוץ של מדיניות הארגון, כמו הגבלת מיקום או דרישה ל-CMEK. כדי לזהות איזו מגבלה הופרה, בודקים את הודעת השגיאה בגוף התגובה. מידע נוסף זמין במאמר פתרון בעיות שקשורות להפרות מדיניות. |
FailedPreconditionException
|
FAILED_PRECONDITION
|
400 Bad Request
|
9 | הבקשה מפרה את מצב המערכת (לדוגמה, ניסיון למחוק תיקייה לא ריקה). בודקים את התנאים המוקדמים ומתקנים את הלוגיקה. |
NotFoundException
|
NOT_FOUND
|
404 Not Found
|
5 | המשאב לא נמצא. מאמתים את מזהי המשאבים או כתובות ה-URL. מוודאים שהמשאב קיים לפני שמנסים לגשת אליו. מידע נוסף על פתרון בעיות זמין במאמר שאלות נפוצות על Conversational Analytics API. |
ServiceUnavailableException
|
UNAVAILABLE
|
503 Service Unavailable
|
14 | יש בעיה זמנית בשרת. צריך להמתין ולנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff) בין הניסיונות. אם השגיאה נמשכת, אפשר לשלוח דוח על באג. |
Connection reset by peer (בזמן הסטרימינג)
|
UNAVAILABLE
|
503 Service Unavailable
|
14 |
אם אתם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה (endpoint) של הסטרימינג ב- מומלץ להשתמש ב Google Cloud ספריות הלקוח הרשמיות של gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות הנגררות האלה ומציגות את הסיבה האמיתית לשגיאה. |
Internal error encountered (בזמן הסטרימינג)
|
INTERNAL
|
500 Internal Server Error
|
13 |
אם אתם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה (endpoint) של הסטרימינג מומלץ להשתמש ב Google Cloud ספריות הלקוח הרשמיות של gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות בסוף התגובה ומציגות את הסיבה האמיתית לשגיאה. |
UnauthenticatedException
|
UNAUTHENTICATED
|
401 Unauthorized
|
16 | נדרש אימות, או שהאימות נכשל. מוודאים שמשתמשים בפרטי הכניסה, במפתח ה-API או בטוקן הנכונים. |
UnimplementedException
|
UNIMPLEMENTED
|
501 Not Implemented
|
12 | התכונה המבוקשת לא זמינה או לא נתמכת. אל תפעילו את ה-API הזה, או המתינו להטמעה. |
מקורות מידע נוספים
בדף שאלות נפוצות על Conversational Analytics API מפורטים טיפים נוספים לפתרון בעיות ותשובות לשאלות נפוצות.
כדי לקבל הנחיות לגבי שאלת שאלות יעילות ב-Conversational Analytics API, אפשר לעיין בדף התיעוד שאלת שאלות יעילות.