Google Chat 앱 이전하기

Google Workspace 조직을 병합하는 경우 계속 작동하도록 Chat 앱을 이전해야 할 수 있습니다.

채팅 앱을 마이그레이션하기 전에 조직의 관리자에게 관리 설정이 영향을 미치는지 확인하세요. 관리 설정을 변경하면 채팅 앱의 전체 기능이 복원되고 이전이 불필요해질 수 있습니다. 예를 들어 Google Workspace 관리자가 채팅 앱을 허용 목록에 추가하거나 사용자가 Chat 앱을 설치하도록 허용해야 할 수 있습니다. 자세한 내용은 Google Workspace 조직 병합 후 Google Chat 앱을 이전해야 하는지 확인하기를 참고하세요.

채팅 앱을 이전해야 한다고 판단되면 다음 3단계 프로세스를 완료하세요.

  1. 병합된 조직에서 Google Cloud 프로젝트를 만들고, API를 사용 설정하고, OAuth 2.0 동의 화면을 구성하여 채팅 앱의 환경을 설정합니다.
  2. 새 Cloud 프로젝트에서 채팅 앱을 다시 배포합니다.
  3. 다시 만든 채팅 앱을 Chat 스페이스 또는 대화에 추가하고 원래 채팅 앱을 사용 중지합니다.

병합된 조직에서 Cloud 프로젝트 만들기 및 API 사용 설정

새 Cloud 프로젝트를 만들고 병합된 Google Workspace 조직에서 Chat 앱에 대해 API를 사용 설정하면 Chat 앱에 대한 액세스를 허용한 사용자와 그룹이 오류 없이 이를 수행할 수 있습니다.

클라우드 프로젝트 만들기

Google Cloud 콘솔

  1. Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 프로젝트 만들기로 이동합니다.

    프로젝트 만들기로 이동

  2. 프로젝트 이름 필드에 프로젝트를 설명하는 이름을 입력합니다.

    선택사항: 프로젝트 ID를 수정하려면 수정을 클릭합니다. 프로젝트를 만든 후에는 프로젝트 ID를 변경할 수 없으므로 프로젝트의 전체 기간 동안 필요에 맞는 ID를 선택하세요.

  3. 위치 필드에서 찾아보기를 클릭하여 프로젝트의 잠재적 위치를 표시합니다. 그런 다음 선택을 클릭합니다.
  4. 만들기를 클릭합니다. Google Cloud 콘솔이 대시보드 페이지로 이동하고 몇 분 내에 프로젝트가 생성됩니다.

gcloud CLI

다음 개발 환경 중 하나에서 Google Cloud CLI (`gcloud`)에 액세스합니다.

  • Cloud Shell: gcloud CLI가 이미 설정된 온라인 터미널을 사용하려면 Cloud Shell을 활성화합니다.
    Cloud Shell 활성화
  • 로컬 셸: 로컬 개발 환경을 사용하려면 gcloud CLI를 설치하고 initialize합니다.
    Cloud 프로젝트를 만들려면 `gcloud projects create`명령어를 사용합니다. 
    gcloud projects create PROJECT_ID
    PROJECT_ID를 만들려는 프로젝트의 ID를 설정하여 바꿉니다.

API 사용 설정

모든 채팅 앱은 Google Chat API를 사용 설정해야 합니다. 채팅 앱이 빌드된 방식에 따라 다른 API를 사용 설정해야 할 수도 있습니다. 예를 들어 Google Cloud Functions를 사용하여 채팅 앱을 빌드한 경우 Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API, Cloud Run API를 사용 설정합니다. 이전된 앱이 제대로 작동하도록 하려면 이전 Cloud 프로젝트에서 사용 설정된 것과 동일한 API를 새 Cloud 프로젝트에서 사용 설정하는 것이 좋습니다.

API를 사용 설정하려면 다음 단계를 따르세요.

Google Cloud 콘솔

  1. Google Cloud 콘솔에서 메뉴 > 제품 더보기 > Google Workspace > 제품 라이브러리로 이동합니다.

    제품 라이브러리로 이동

  2. 사용 설정하려는 API를 클릭합니다.
  3. 사용 설정을 클릭합니다.
  4. 더 많은 API를 사용 설정하려면 이 단계를 반복합니다.

Google Cloud CLI

  1. Google Cloud 명령줄 인터페이스 (CLI)를 설치하거나 엽니다.

  2. services enable 명령어를 실행하여 사용 설정할 API 서비스를 지정합니다.

    gcloud services enable API_SERVICE_ID

Cloud 프로젝트의 OAuth 동의 화면을 구성해야 할 수 있습니다. 이전에 승인에 OAuth 2.0을 사용한 경우 동일한 액세스 승인 범위를 사용합니다.

  1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.

    OAuth 동의 화면으로 이동

  2. 앱의 사용자 유형을 선택한 다음 만들기를 클릭합니다.
  3. 앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.

  4. Google Workspace 조직 외부에서 사용할 앱을 만드는 경우 범위 추가 또는 삭제를 클릭합니다. 범위를 선택할 때 다음 권장사항을 따르는 것이 좋습니다.

    • 앱에 필요한 최소 액세스 수준을 제공하는 범위를 선택합니다. 사용 가능한 범위 목록은 Google API용 OAuth 2.0 범위를 참조하세요.
    • 민감하지 않은 범위, 민감한 범위, 제한된 범위의 세 가지 섹션에 나열된 범위를 각각 검토합니다. '민감한 범위' 또는 '제한된 범위' 섹션에 나열된 범위의 경우 민감하지 않은 다른 범위를 식별하여 불필요한 추가 검토를 피하세요.
    • 일부 범위는 Google의 추가 검토가 필요합니다. Google Workspace 조직에서 내부적으로만 사용하는 앱의 경우 범위가 동의 화면에 표시되지 않으며 제한된 범위 또는 민감한 범위를 사용할 경우 Google의 추가 검토가 필요하지 않습니다. 자세한 내용은 범위 카테고리를 참고하세요.
  5. 앱에 필요한 범위를 선택한 후 저장 후 계속을 클릭합니다.
  6. 사용자 유형으로 외부를 선택한 경우 테스트 사용자를 추가합니다.
    1. 테스트 사용자에서 사용자 추가를 클릭합니다.
    2. 이메일 주소 및 승인된 다른 테스트 사용자를 입력한 다음 저장하고 계속하기를 클릭합니다.
  7. 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 확인되면 대시보드로 돌아가기를 클릭합니다.

새 Cloud 프로젝트에 채팅 앱을 재배포합니다.

채팅 앱이 Apps Script, AppSheet 또는 다른 연결 유형(예: Python 또는 자바)으로 빌드되었는지에 따라 채팅 앱을 재배포하는 것이 약간 다릅니다. 두 경우 모두 코드를 모두 다시 만들 필요는 없지만, 몇 가지는 변경해야 합니다.

채팅 앱 로직 이전

채팅 앱의 아키텍처에 따라 다른 서비스를 새 Cloud 프로젝트로 마이그레이션해야 할 수 있습니다.

  • HTTP 앱의 경우 Cloud Functions, Cloud Run 또는 App Engine을 사용하여 빌드된 나머지 앱 로직도 마이그레이션해야 합니다.
  • 자연어를 사용하는 대화형 채팅 앱의 경우 Dialogflow 에이전트도 마이그레이션해야 합니다.
  • 방화벽으로 빌드된 채팅 앱의 경우 Pub/Sub 주제도 마이그레이션해야 합니다.

새 Cloud 프로젝트에서 채팅 앱 구성

Python 또는 Java와 같은 언어로 빌드된 채팅 앱을 재배포하려면 새 Cloud 프로젝트에서 채팅 앱을 구성합니다.

  1. Google Cloud 콘솔에서 'Google Chat API'를 검색하고 Google Chat API를 클릭한 다음 관리를 클릭합니다.

    Chat API로 이동

  2. 구성 탭을 클릭하고 다음 필수 정보를 입력합니다.

    • 앱 이름: 사용자가 채팅 앱과 상호작용할 때 사용하는 이름입니다.
    • 아바타 URL: 채팅 앱의 아바타로 표시되는 128x128 이상의 정사각형 그래픽 이미지(예: PNG 또는 JPEG)를 가리키는 HTTPS URL입니다.
    • 설명: 채팅 앱의 이름 아래에 표시되는 채팅 앱의 의도된 목적에 관한 설명입니다.

  3. 양방향 기능을 사용 설정하려면 사용자가 채팅 앱과 상호작용할 수 있도록 양방향 기능 사용 설정 전환 버튼을 클릭하고 다음 표를 사용하여 구성을 완료합니다.

    필드 설명
    기능 채팅 앱이 사용자와 상호작용하는 방법을 결정하는 필드 모음:
    • 1:1 메시지 수신: 사용자가 Google Chat에서 직접 채팅 앱을 찾아 메시지를 보낼 수 있습니다.
    • 스페이스 및 그룹 대화 참여: 사용자는 스페이스 및 그룹 대화에 Chat 앱을 추가할 수 있습니다.
    연결 설정 채팅 앱의 엔드포인트로, 다음 중 하나입니다.
    • 앱 URL: 채팅 앱 구현을 호스팅하는 HTTPS 엔드포인트입니다.
    • Apps Script 프로젝트: 채팅 앱을 구현하는 Apps Script 프로젝트의 배포 ID입니다.
    • Cloud Pub/Sub 주제 이름: 채팅 앱이 엔드포인트로 구독하는 Pub/Sub 주제입니다.
    • Dialogflow: Dialogflow 통합으로 채팅 앱을 등록합니다. 자세한 내용은 자연어를 이해하는 Dialogflow Google Chat 앱 빌드를 참조하세요.
    슬래시 명령어 Google Chat 내에서 사용자에게 표시될 수 있는 명령어입니다. 사용자가 Google Chat 내에서 채팅 앱의 핵심 작업을 확인하고 상호작용하려는 특정 작업을 선택할 수 있도록 허용합니다. 자세한 내용은 채팅 앱으로 슬래시 명령어에 응답을 참고하세요.
    링크 미리보기 사용자가 링크를 보낼 때 채팅 앱이 인식하고 추가 콘텐츠를 제공하는 URL 패턴입니다. 자세한 내용은 미리보기 링크를 참고하세요.
    공개 상태 채팅 앱을 보고 설치할 수 있는 최대 5명의 개인 또는 하나 이상의 Google 그룹스입니다. 이 필드를 사용하여 채팅 앱을 테스트하거나 채팅 앱을 팀과 공유하세요. 자세한 내용은 채팅 앱의 공개 상태 및 게시 설정을 참고하세요.

  4. Chat 앱에서 오류를 반환할 때마다 Cloud Logging에 오류를 로깅하려면 Logging에 오류 로깅 체크박스를 선택합니다. 자세한 내용은 채팅 앱의 오류 로그 쿼리를 참고하세요.

  5. 저장을 클릭합니다. 채팅 앱 구성을 저장하면 Google Workspace 조직의 지정된 사용자가 채팅 앱을 사용할 수 있습니다.

Apps Script 채팅 앱 재배포

Apps Script로 빌드된 채팅 앱을 재배포하려면 Apps Script 프로젝트에 연결된 Cloud 프로젝트 번호를 새 Cloud 프로젝트에 속한 프로젝트 번호로 변경합니다. 그런 다음 Apps Script 배포 ID를 복사하여 Google Cloud 콘솔의 Chat 앱 구성 페이지에 붙여넣습니다.

Cloud 프로젝트 번호 복사

  1. Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 설정으로 이동합니다.

    IAM 및 관리자 설정으로 이동

  2. 프로젝트 번호 필드에서 값을 복사합니다.

Apps Script 프로젝트에서 Google Cloud 프로젝트 번호 설정

  1. Apps Script로 이동합니다.

    Apps Script로 이동

  2. 채팅 앱 Apps Script 프로젝트에서 프로젝트 설정 을 클릭합니다.

  3. Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.

  4. GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.

  5. 프로젝트 설정을 클릭합니다.

Apps Script 프로젝트의 배포 ID 복사

  1. Apps Script의 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
  2. 배포 ID에서 복사를 클릭합니다.
  3. 완료를 클릭합니다.

채팅 앱 재구성 및 재배포

  1. Google Cloud 콘솔에서 'Google Chat API'를 검색하고 Google Chat API를 클릭한 다음 관리를 클릭합니다.

    Chat API로 이동

  2. 구성 탭을 클릭하고 다음 필수 정보를 입력합니다.

    • 앱 이름: 사용자가 채팅 앱과 상호작용할 때 사용하는 이름입니다.
    • 아바타 URL: 채팅 앱의 아바타로 표시되는 128x128 이상의 정사각형 그래픽 이미지(예: PNG 또는 JPEG)를 가리키는 HTTPS URL입니다.
    • 설명: 채팅 앱의 이름 아래에 표시되는 채팅 앱의 의도된 목적에 관한 설명입니다.

  3. 대화형 기능을 사용 설정하려면 사용자가 채팅 앱과 상호작용할 수 있도록 대화형 기능 사용 설정 전환 버튼을 클릭합니다.

  4. 연결 설정에서 Apps Script 프로젝트를 선택합니다.

  5. 배포 ID 필드에 이전에 복사한 배포 ID를 붙여넣습니다.

  6. 나머지 구성을 완료하려면 새 Cloud 프로젝트에서 채팅 앱 구성의 표를 참고하세요.

  7. 저장을 클릭합니다.

AppSheet 채팅 앱 재배포

AppSheet로 빌드된 채팅 앱을 새 Cloud 프로젝트에 다시 배포하려면 앱을 새 Cloud 프로젝트에 복사합니다.

서비스 계정 업데이트

채팅 앱이 앱으로 인증되고 서비스 계정을 사용하여 Google API를 호출하는 경우 채팅 앱의 서비스 계정 세부정보를 업데이트합니다. 자세한 내용은 채팅 앱으로 인증을 참고하세요.

채팅 앱 공유하기

새 조직의 사용자에게 채팅 앱이 제공되려면 관리자가 수동으로 Chat 앱에 대한 액세스를 허용해야 할 수도 있습니다. 자세한 내용은 Google Workspace 관리자가 Chat 앱을 설치하는 방법을 참조하세요.

새로운 Chat 앱으로 전환하기

이제 채팅 앱이 새 조직으로 이전되었으므로 이를 공개해야 합니다. Chat 스페이스 또는 채팅 메시지에 이를 추가하고 이전 Chat 앱을 삭제하여 사용자가 이전된 Chat 앱에만 메시지를 보내도록 합니다.

Chat 스페이스에 새로운 채팅 앱 추가하기

  1. Chat으로 이동합니다.

    Chat으로 이동

  2. 채팅 메시지 또는 스페이스를 클릭합니다.

  3. 스페이스 또는 사용자 이름 옆에 있는 드롭다운을 클릭한 후 앱 및 통합을 선택합니다.

  4. 앱 추가를 클릭합니다.

  5. 앱 이름을 입력하고 목록에서 앱을 선택한 후 추가를 클릭합니다.

  6. 채팅 앱을 추가하려는 모든 스페이스 또는 채팅 메시지에 이 단계를 반복합니다.

Chat 스페이스에서 이전 채팅 앱 삭제하기

  1. Chat으로 이동합니다.

    Chat으로 이동

  2. 채팅 메시지 또는 스페이스를 클릭합니다.

  3. 스페이스 또는 사용자 이름 옆에 있는 드롭다운을 클릭한 후 앱 및 통합을 선택합니다.

  4. 이전되지 않은 기존의 채팅 앱 옆에 있는 옵션 더보기 를 클릭한 다음 스페이스에서 삭제를 클릭합니다.

  5. 이전 채팅 앱을 삭제하려는 모든 스페이스 또는 채팅 메시지에 이 단계를 반복합니다.

기존 Chat 앱 사용 중지하기

사용자가 기존 채팅 앱을 사용하지 못하게 하고 새로운 채팅 앱을 사용하도록 유도하려면 기존 채팅 앱을 사용 중지하고 Google Workspace Marketplace에서 게시 취소합니다.