Google Workspace 조직을 병합하는 경우 Chat 앱이 계속 작동하도록 이전해야 할 수도 있습니다.
Chat 앱을 이전하기 전에 조직의 관리자에게 관리 설정이 앱에 영향을 미치는지 확인하세요. 관리 설정을 변경하면 Chat 앱의 전체 기능이 복원되고 이전을 하지 않아도 될 수 있습니다. 예를 들어 Google Workspace 관리자가 Chat 앱을 허용 목록에 추가하거나 사용자가 Chat 앱을 설치하도록 허용해야 할 수도 있습니다. 자세한 내용은 Google Workspace 조직을 병합한 후 Google Chat 앱을 이전해야 하는지 확인하기를 참고하세요.
Chat 앱을 이전해야 한다고 판단한 후 다음 3단계 프로세스를 완료합니다.
- 병합된 조직에서 Google Cloud 프로젝트를 만들고, API를 사용 설정하고, OAuth 2.0 동의 화면을 구성하여 Chat 앱의 환경을 설정합니다.
- 새 Cloud 프로젝트에서 Chat 앱을 재배포합니다.
- 다시 만든 Chat 앱을 Chat 스페이스 또는 대화에 추가하고 원래 Chat 앱을 사용 중지합니다.
병합된 조직에서 Cloud 프로젝트를 만들고 API 사용 설정
병합된 Google Workspace 조직에서 새 Cloud 프로젝트를 만들고 Chat 앱의 API를 사용 설정하면 Chat 앱에 액세스하도록 허용한 사용자와 그룹이 오류 없이 액세스할 수 있습니다.
Cloud 프로젝트 만들기
Google Cloud 콘솔
- Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 프로젝트 만들기로 이동합니다.
-
프로젝트 이름 필드에 프로젝트의 설명이 포함된 이름을 입력합니다.
(선택사항) 프로젝트 ID를 수정하려면 수정을 클릭합니다. 프로젝트가 만들어진 후에는 프로젝트 ID를 변경할 수 없으므로 프로젝트의 수명 동안 필요에 맞는 ID를 선택하세요.
- 위치 필드에서 찾아보기 를 클릭하여 프로젝트의 잠재적 위치를 표시합니다. 그런 다음 선택 을 클릭합니다.
- 만들기 를 클릭합니다. Google Cloud 콘솔이 대시보드 페이지로 이동하고 프로젝트가 몇 분 이내에 생성됩니다.
gcloud CLI
다음 개발 환경 중 하나에서 Google Cloud
CLI (gcloud)에 액세스합니다.
-
Cloud Shell: gcloud CLI
가 이미 설정된 온라인 터미널을 사용하려면 Cloud Shell을 활성화하세요.
Cloud Shell 활성화 -
로컬 셸: 로컬 개발 환경을 사용하려면 설치하고 초기화하여 gcloud CLI를 사용합니다.
Cloud 프로젝트를 만들려면gcloud projects create명령어를 사용합니다.gcloud projects create PROJECT_ID
API 사용 설정
모든 Chat 앱에는 Google Chat API가 사용 설정되어 있어야 합니다. Chat 앱이 빌드되는 방식에 따라 다른 API를 사용 설정해야 할 수도 있습니다. 예를 들어 Google Cloud Functions를 사용하여 Chat 앱을 빌드한 경우 Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API, Cloud Run API를 사용 설정합니다. 이전된 앱이 작동하도록 하려면 이전 Cloud 프로젝트에서 사용 설정된 것과 동일한 API를 새 Cloud 프로젝트에서 사용 설정하는 것이 좋습니다.
API를 사용 설정하려면 다음 단계를 따르세요.
Google Cloud 콘솔
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 라이브러리 > Google Workspace로 이동합니다.
- 사용 설정하려는 API를 클릭합니다.
- 사용 설정 을 클릭합니다.
- API를 더 사용 설정하려면 이 단계를 반복합니다.
Google Cloud CLI
- Google Cloud Command Line Interface (CLI)를 설치하거나 엽니다.
-
사용 설정할 API 서비스를 지정하여
services enable명령어를 실행합니다.gcloud services enable API_SERVICE_ID
Chat API 구성
새 Cloud 프로젝트에서 Chat API를 사용하여 Chat 앱의 이름, 설명, 아이콘을 지정해야 합니다. 이러한 세부정보를 구성하려면 Chat API 구성을 참고하세요.
OAuth 동의 화면 구성
Cloud 프로젝트의 OAuth 동의 화면을 구성해야 할 수도 있습니다. 이전에 OAuth 2.0을 인증에 사용한 경우 동일한 액세스 인증 범위를 사용합니다.
- Google API 콘솔에서 메뉴 > Google 인증 플랫폼 > 브랜딩으로 이동합니다.
- 이미 Google 인증 플랫폼을 구성한 경우 브랜딩, 대상, 데이터 액세스에서 다음 OAuth 동의 화면 설정을 구성할 수 있습니다. Google 인증 플랫폼이 아직 구성되지 않음이라는 메시지가 표시되면 시작하기를 클릭합니다.
- 앱 정보 의 앱 이름 에 앱 이름 을 입력합니다.
- 사용자 지원 이메일에서 사용자가 동의에 관해 문의할 수 있는 지원 이메일 주소를 선택합니다.
- 다음 을 클릭합니다.
- 잠재고객에서 앱의 사용자 유형을 선택합니다.
- 다음 을 클릭합니다.
- 연락처 정보에 프로젝트 변경사항에 관한 알림을 받을 수 있는 이메일 주소를 입력합니다.
- 다음 을 클릭합니다.
- 완료에서 Google API 서비스 사용자 데이터 정책을 검토하고 동의하는 경우 Google API 서비스: 사용자 데이터 정책에 동의합니다를 선택합니다.
- 계속 을 클릭합니다.
- 만들기 를 클릭합니다.
- 사용자 유형으로 외부 를 선택한 경우 테스트 사용자를 추가합니다.
- 잠재고객 을 클릭합니다.
- **테스트 사용자** 에서 **사용자 추가** 를 클릭합니다.
- 이메일 주소와 기타 승인된 테스트 사용자를 입력한 후 저장 을 클릭합니다.
Google Workspace 조직 외부에서 사용할 앱을 만드는 경우 데이터 액세스 > 범위 추가 또는 삭제를 클릭합니다. 범위를 선택할 때는 다음 권장사항을 따르는 것이 좋습니다.
- 앱에 필요한 최소 수준의 액세스 권한을 제공하는 범위를 선택합니다. 사용 가능한 범위 목록은 Google API용 OAuth 2.0 범위를 참고하세요.
- 민감하지 않은 범위, 민감한 범위, 제한된 범위의 세 가지 섹션에 나열된 범위를 검토합니다. '민감한 범위' 또는 '제한된 범위' 섹션에 나열된 범위의 경우 불필요한 추가 검토를 방지하기 위해 민감하지 않은 대체 범위를 식별해 보세요.
- 일부 범위에는 Google의 추가 검토가 필요합니다. Google Workspace 조직에서만 내부적으로 사용되는 앱의 경우 동의 화면에 범위가 나열되지 않으며 제한된 범위 또는 민감한 범위를 사용하는 데 Google의 추가 검토가 필요하지 않습니다. 자세한 내용은 범위 카테고리를 참고하세요.
- 앱에 필요한 범위를 선택한 후 저장을 클릭합니다.
OAuth 동의 구성에 대한 자세한 내용은 Google 인증 플랫폼 시작하기를 참고하세요.
새 Cloud 프로젝트에 Chat 앱 재배포
Chat 앱이 Apps Script, AppSheet 또는 Python이나 Java와 같은 다른 연결 유형으로 빌드되었는지에 따라 Chat 앱을 재배포하는 방법이 약간 다릅니다. 어떤 경우든 코드를 모두 다시 만들 필요는 없지만 몇 가지 변경사항을 적용해야 합니다.
Chat 앱 로직 이전
Chat 앱의 아키텍처에 따라 다른 서비스를 새 Cloud 프로젝트로 이전해야 할 수도 있습니다.
- HTTP 앱의 경우 Cloud Run Functions, Cloud Run 또는 App Engine을 사용하여 빌드된 나머지 앱 로직도 이전해야 합니다.
- 자연어를 사용하는 대화형 Chat 앱의 경우 Dialogflow 에이전트도 이전해야 합니다.
- 방화벽 뒤에 빌드된 Chat 앱의 경우 Pub/Sub 주제도 이전해야 합니다.
새 Cloud 프로젝트에서 대화형 기능 구성
Python이나 Java와 같은 언어로 빌드된 Chat 앱을 재배포하려면 새 Cloud 프로젝트에서 Chat 앱을 구성합니다.
대화형 기능을 구성하려면 사용자 상호작용 수신 및 응답을 참고하세요.
Apps Script Chat 앱 재배포
Apps Script로 빌드된 Chat 앱을 재배포하려면 Apps Script 프로젝트가 연결된 Cloud 프로젝트 번호를 새 Cloud 프로젝트에 속한 프로젝트 번호로 변경합니다. 그런 다음 Apps Script 배포 ID를 복사하여 Google API 콘솔의 Chat 앱 구성 페이지에 붙여넣습니다.
Cloud 프로젝트 번호 복사
- Google API 콘솔에서 메뉴 > IAM 및 관리자 > 설정으로 이동합니다.
- 프로젝트 번호 필드에서 값을 복사합니다.
Apps Script 프로젝트에서 Google Cloud 프로젝트 번호 설정
Apps Script로 이동합니다.
Chat 앱 Apps Script 프로젝트에서 프로젝트 설정 을 클릭합니다.
Google Cloud Platform (GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
프로젝트 설정 을 클릭합니다.
Apps Script 프로젝트의 배포 ID 복사
- Apps Script의 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
- 배포 ID에서 복사를 클릭합니다.
- 완료 를 클릭합니다.
Chat 앱 재구성 및 재배포
Google API 콘솔에서 "Google Chat API"를 검색하고 Google Chat API를 클릭한 다음 관리를 클릭합니다.
구성 탭을 클릭하고 다음 필수 정보를 입력합니다.
- 앱 이름: 사용자가 Chat 앱과 상호작용할 때 사용하는 이름입니다.
- 아바타 URL: Chat 앱의 아바타로 표시되는 정사각형 그래픽 이미지 (예: PNG 또는 JPEG)를 가리키는 HTTPS URL입니다(최소 128x128).
- 설명: Chat 앱의 이름 아래에 표시되는 Chat 앱의 의도된 목적에 대한 설명입니다.
대화형 기능을 사용 설정하려면 사용자가 Chat 앱과 상호작용할 수 있는 대화형 기능 사용 설정 전환 버튼을 클릭합니다.
연결 설정에서 Apps Script 프로젝트 를 선택합니다.
배포 ID 필드에 이전에 복사한 배포 ID를 붙여넣습니다.
나머지 구성을 완료하려면 새 Cloud 프로젝트에서 Chat 앱 구성의 표를 참고하세요.
저장 을 클릭합니다.
AppSheet Chat 앱 재배포
새 Cloud 프로젝트에서 AppSheet로 빌드된 Chat 앱을 재배포하려면 앱을 새 Cloud 프로젝트에 복사합니다.
서비스 계정 업데이트
Chat 앱이 앱으로 인증되고 서비스 계정을 사용하여 Google API를 호출하는 경우 Chat 앱의 서비스 계정 세부정보를 업데이트합니다. 자세한 내용은 Chat 앱으로 인증을 참고하세요.
Chat 앱 공유
Chat 앱이 새 조직의 사용자에게 제공되기 전에 관리자가 Chat 앱에 대한 액세스를 수동으로 허용해야 할 수도 있습니다. 자세한 내용은 Google Workspace Marketplace 문서에서 Google Workspace 조직의 액세스 구성을 참고하세요.
새 Chat 앱으로 전환
이제 Chat 앱이 새 조직으로 이전되었으므로 이를 알릴 차례입니다. Chat 스페이스 또는 채팅 메시지에 추가한 다음 이전 Chat 앱을 삭제하여 사용자가 이전된 Chat 앱에만 메시지를 보낼 수 있도록 합니다.
Chat 스페이스에 새 Chat 앱 추가
Chat으로 이동합니다.
채팅 메시지 또는 스페이스를 클릭합니다.
스페이스 또는 사용자 이름 옆에 있는 드롭다운을 클릭한 다음 앱 및 통합 을 선택합니다.
앱 추가 를 클릭합니다.
앱 이름을 입력하고 목록에서 앱을 선택한 다음 추가 를 클릭합니다.
Chat 앱을 추가하려는 모든 스페이스 또는 채팅 메시지에 대해 이 단계를 반복합니다.
Chat 스페이스에서 이전 Chat 앱 삭제
Chat으로 이동합니다.
채팅 메시지 또는 스페이스를 클릭합니다.
스페이스 또는 사용자 이름 옆에 있는 드롭다운을 클릭한 다음 앱 및 통합 을 선택합니다.
이전되고 이전되지 않은 Chat 앱 옆에 있는 옵션 더보기 를 클릭한 다음 스페이스에서 삭제를 클릭합니다.
이전 Chat 앱을 삭제하려는 모든 스페이스 또는 채팅 메시지에 대해 이 단계를 반복합니다.
이전 Chat 앱 사용 중지
사용자가 이전 Chat 앱을 사용하지 못하도록 하고 새 Chat 앱을 사용하도록 권장하려면 이전 Chat 앱을 사용 중지하고 Google Workspace Marketplace에서 게시 취소합니다.