이 섹션에서는 채팅 앱을 빌드하고 테스트하는 동안 발생할 수 있는 일반적인 문제를 설명합니다.
카드 메시지, 대화상자 또는 링크 미리보기가 예상대로 렌더링되지 않거나 작동하지 않음
카드 오류 문제 해결에 대한 도움말은 카드 문제 해결 및 수정하기를 참고하세요.
앱이 응답하지 않음
채팅 앱에 메시지를 보냈는데 '앱이 응답하지 않습니다'라고 응답하면 채팅 앱의 구성을 확인합니다.
Google Cloud 콘솔에서 메뉴를 클릭합니다. <ph type="x-smartling-placeholder"></ph> > 제품 더보기 > Google Workspace > 제품 라이브러리 > Google Chat API > 관리 > 구성.
앱 상태에서 게시 중 - 사용자에게 제공을 선택했는지 확인합니다.
양방향 기능에서 설정이 앱의 기능에 적합한지 확인합니다. 채팅 앱이 사용자와 상호작용하는 경우 대화형 기능 사용 설정을 사용 설정해야 합니다.
- 앱이 메시지에 응답하면 1:1 메시지 수신을 선택해야 합니다.
- 연결 설정에서 앱 URL, Apps Script 프로젝트 배포 ID, Cloud Pub/Sub 주제 이름 또는 Dialogflow 에이전트가 올바르게 설정되어 있고 배포되었는지 확인합니다.
- 공개 상태에서 적절한 사용자가 이메일 주소 또는 Google Workspace 도메인의 그룹으로 앱에 액세스할 수 있는지 확인합니다. Google Workspace Marketplace SDK를 사용하여 앱을 배포한 경우에는 Google Workspace Marketplace 설정이 우선 적용되므로 공개 상태 설정이 필요하지 않습니다.
앱이 Google Workspace Marketplace SDK로 게시된 경우 Google Workspace Marketplace 설정을 검토하세요.
저장을 클릭합니다.
앱에 다시 메시지를 보내 봅니다.
Google Chat API는 Google Workspace 사용자에게만 제공됩니다.
채팅 앱을 구성할 때
오류 Google Chat API is only available to Google Workspace users 이 메시지
즉,
Chat API는 Google Workspace 조직의 일부가 아닙니다. 새로운
Chat 앱 또는 Chat API를 사용하는 경우 다음을 사용해야 합니다.
Google Workspace
계정을 선택합니다.
Google Chat 사용자는 Google Workspace 계정 사용자가 앱을 검색하고 설치하는 방법에 대해 자세히 알아보기 채팅 앱에 대해서는 게시를 참조하세요. Google Chat 앱.
스페이스에서 사용자를 제외할 수 있음
Google Workspace 관리자가 사용자의 Chat 기록 사용 또는 사용 중지를 허용하지 않으면 채팅 기록을 강제로 사용 설정 또는 사용 중지하는 사용자 수준 설정과 조직 수준의 강제 설정을 상속하는 스페이스 간의 충돌로 인해 사용자가 스페이스에 참여하거나 스페이스에 머무를 수 없는 상황이 발생할 수 있습니다.
예를 들어 사용자의 채팅 기록 설정이 '사용'으로 강제 설정된 경우 Chat 기록 설정이 강제로 '사용 중지'된 스페이스의 경우 해당 사용자는 스페이스에 참여하지 못할 수 있습니다. 또한 해당 사용자가 충돌 전에 참여한 다음 스페이스에 메시지를 게시한 경우 해당 사용자가 스페이스에서 삭제될 수도 있습니다.
이 시나리오 및 기록 설정 간에 충돌이 발생하는 기타 시나리오에서는 Chat API가 멤버십을 만들 수 없거나 사용자 인증을 통해 메시지를 만들면 스페이스에서 충돌하는 채팅 기록 설정이 있는 인증된 사용자가 삭제될 수 있습니다.
자세한 내용은 Google Workspace 관리자 고객센터의 스페이스에서 사용자를 제외할 수 있음을 참고하세요.
Google Apps Script에서 고급 채팅 서비스 문제 해결하기
다음에 관한 Apps Script 페이지를 참고하세요. 고급 채팅 서비스.
사용자가 채팅 앱을 스페이스에 추가할 수 없음
사용자에게 오류 메시지가 표시되는 경우
This organization's administrator must allow users to install this Chat app
채팅 앱을 스페이스에 추가하려고 할 때 이 오류 메시지가 표시됩니다
다음 이유 중 하나가 원인일 수 있습니다.
- 조직에서 Chat 앱을 사용 중지했습니다.
- 조직에서 이 항목을 추가하지 않았습니다. 채팅 앱을 조직의 허용 목록에 추가합니다.
사용자가 채팅 앱, 조직으로 인해 발생한 문제일 수 있습니다. 권한을 부여하지 않고 하위 조직 단위에도 하위 조직 단위로 연결할 수 있습니다
이 문제를 해결하는 방법에 대한 자세한 내용은 다음을 참조하세요. 사용자가 Chat 앱을 설치하도록 허용하기
Cloud 함수 오류 문제 해결
채팅 앱이 Cloud Functions로 구현되고 작동하지 않는 경우 다음 섹션을 통해 문제를 해결할 수 있습니다.
Cloud 함수 로그 확인
첫 번째 단계로 Cloud Functions 로그에서 오류를 확인합니다.
Google Cloud 콘솔에서 Cloud Functions 페이지로 이동합니다.
로그를 열려면 채팅 앱의 클라우드를 찾습니다. 함수를 클릭한 다음 작업 표시 > 로그 보기를 클릭합니다.
로그 탐색기가 열리고 다음과 같은 Cloud 함수 로그를 보여주는 쿼리를 실행합니다. 오류가 발생했습니다.
로깅된 기본 정보가 앱을 디버그하기에 충분하지 않다면 Cloud 함수 코드에서 추가 로깅 사용 Cloud 보기 및 쓰기를 참조하세요. 함수 로그.
Cloud 함수 오류 확인
로그 외에도 Cloud Functions는 있습니다
Google Cloud 콘솔에서 Cloud Functions 페이지로 이동합니다.
채팅 앱의 Cloud 함수를 클릭합니다.
함수 세부정보 페이지의 오류는 오류 아래에 나열됩니다.
오류 해결을 위해 계속 진행하려면 오류를 클릭합니다.
일반적인 Cloud 함수 오류 해결
애플리케이션을 빌드할 때 Cloud Functions를 사용하는 채팅 앱
PROJECT_NAME 프로젝트의 REGION_NAME 리전에 함수 ChatApp이 이미 있습니다.
Cloud 함수를 배포할 때 Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists 오류가 발생할 수 있습니다. 이 메시지는 다른 Cloud 함수가
배포할 수 있습니다 이름을 변경합니다.
함수를 다시 배포합니다 채팅 앱이 다음의 트리거 URL을 사용하는지 확인
기존 Cloud 함수의 트리거 URL이 아닌 Cloud Functions를 사용합니다.
정책에 지정된 한 명 이상의 사용자가 허용된 고객에 속하지 않습니다.
Cloud 함수를 배포할 때 The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." 오류가 표시될 수 있습니다. 이 오류가 발생하면
채팅 앱에 Google Chat을 사용하기 전에 Google
Chat이 Cloud 함수를 호스팅하는 서버에 도달할 수 없습니다. 이 메시지는
이름이 'allUsers'인 사용자 Cloud 함수를 호출할 권한이 없습니다.
'allUsers' 'Cloud Functions 호출자' 즉, Cloud IAM과
앱을 구동하는 기능을 외부에서 사용하지 않고 공개적으로 사용 및 액세스할 수 있음
있습니다. 역할을 지정하는 방법을 알아보려면 다음을 참조하세요.
단일 역할을 부여합니다.
이 오류는 Google Cloud 프로젝트의 도메인이 제한되었음을 의미할 수 있습니다. 대상 도메인 제한 제약 조건에 대한 자세한 내용은 도메인별로 ID 제한
이 문제를 해결하려면 Cloud 함수에서 인증되지 않은 항목을 허용하는지 확인하세요. 있습니다. 기존 Cloud 함수에 관해서는 공개 (인증되지 않은) 액세스 허용