문제 해결 개요

이 페이지에서는 Chat 앱, 카드, 대화상자 오류를 확인하고 디버그하고 수정하는 방법을 설명합니다.

오류 표시 방식

Google Chat 앱이 오류를 반환하면 다음과 같이 표시됩니다.

  • '앱이 응답하지 않습니다.'와 같은 메시지 '문제가 발생했습니다.' 또는 '요청을 처리할 수 없습니다'가 표시됩니다.
  • 앱이 의도한 대로 작동하지 않습니다.
  • 메시지가 표시되지 않고 앱이 응답하지 않습니다.

카드에서 오류가 반환되면 다음과 같이 표시됩니다.

  • 카드 일부(예: 위젯 또는 구성요소)가 표시되지 않거나 예상치 못한 방식으로 렌더링됩니다.
  • 전체 카드가 표시되지 않습니다.
  • 대화상자가 닫히거나, 열리지 않거나, 로드되지 않습니다.

채팅 UI에 오류 메시지가 표시되지 않을 수 있지만, 채팅 앱의 오류 로깅이 사용 설정되어 있으면 오류를 수정하는 데 도움이 되는 설명이 포함된 오류 메시지와 로그 데이터를 확인할 수 있습니다.

Google Chat 오류 디버그 및 문제 해결

  1. 오류가 발생할 때 Google Chat 앱이 오류를 로깅하도록 오류 로깅을 사용 설정합니다.
  2. Google Chat 오류 로그 쿼리를 사용하여 오류 로그를 읽고, 오류가 발생하는 빈도를 확인하고, 오류를 수정하는 데 도움이 되는 설명이 포함된 오류 메시지와 로그 데이터를 읽습니다.
  3. 일반적인 오류를 해결하는 방법을 알아보세요.
    • '앱이 응답하지 않음', 'Google Chat API는 Google Workspace 사용자에게만 제공됩니다', '사용자를 스페이스에서 제외할 수 있음'과 같은 Google Chat 앱 오류를 수정합니다.
    • 카드 메시지, 대화상자, 링크 미리보기가 예상대로 렌더링되거나 작동하지 않는 등의 카드 및 대화상자 오류를 수정합니다.
  4. Chat 앱을 디버그하여 단계별로 실행합니다.