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