문제 해결 개요
이 페이지에서는 Chat 앱, 카드, 대화상자 오류를 보고, 디버그하고, 수정하는 데 도움이 됩니다.
오류 표시 방식
Google Chat 앱에서 오류를 반환하면 다음과 같이 표시됩니다.
- '앱이 응답하지 않음'과 같은 메시지 '문제가 발생했습니다' 또는 '요청을 처리할 수 없습니다'가 표시됩니다.
- 앱이 정상적으로 작동하지 않습니다.
- 메시지가 표시되지 않고 앱이 응답하지 않습니다.
카드가 오류를 반환하면 다음과 같이 표시됩니다.
- 위젯이나 구성요소와 같은 카드의 일부가 예상치 못하게 표시되거나 렌더링되지 않습니다.
- 카드 전체가 표시되지 않습니다.
- 대화상자가 닫히거나 열리지 않거나 로드되지 않습니다.
Chat UI에는 오류 메시지가 표시되지 않을 수 있지만, Chat 앱의 오류 로깅이 사용 설정된 경우 오류를 해결하는 데 도움이 되는 설명 오류 메시지와 로그 데이터를 사용할 수 있습니다.
Google Chat 오류 디버그 및 문제 해결
- Google Chat 앱에서 오류가 발생할 때마다 오류를 로깅하도록 오류 로깅을 사용 설정합니다.
- Google Chat의 오류 로그 쿼리를 사용하여 오류 로그를 읽고, 오류가 발생하는 빈도를 확인하고, 오류를 해결하는 데 도움이 되는 설명적인 오류 메시지와 로그 데이터를 읽습니다.
- 일반적인 오류를 해결하는 방법을 알아보세요.
- '앱이 응답하지 않음', 'Google Chat API는 Google Workspace 사용자만 사용할 수 있음', '사용자가 스페이스에서 제외될 수 있음'과 같은 Google Chat 앱 오류를 수정합니다.
- 카드 메시지, 대화상자 또는 링크 미리보기가 렌더링되지 않거나 예상대로 작동하지 않는 등의 카드 및 대화상자 오류를 수정합니다.
- Chat 앱을 디버그하여 단계별로 실행합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-02-16(UTC)
[null,null,["최종 업데이트: 2025-02-16(UTC)"],[[["This page provides guidance on viewing, debugging, and resolving errors in Google Chat apps, cards, and dialogs."],["Google Chat errors can manifest as error messages, unexpected app behavior, or lack of response, while card errors might result in partial or complete rendering failures."],["Developers can leverage error logging, log querying, and troubleshooting resources to identify and fix errors in their Chat apps, cards, and dialogs."],["Specific guides are available to address common Chat app errors, card and dialog issues, and enable step-by-step debugging for comprehensive troubleshooting."]]],["This content details how to manage errors in Google Chat apps, cards, and dialogs. Errors manifest as unresponsive apps, missing or malfunctioning card elements, or closed/failed dialogs. To address this, enable error logging. Query error logs to identify the frequency and nature of errors. Resources are available to fix common app, card, and dialog issues, and a debug feature allows for step-by-step execution analysis.\n"]]