Jeśli scalasz organizacje Google Workspace, może być konieczne przeniesienie aby nadal działała.
Przed przeniesieniem aplikacji Google Chat sprawdź administrator organizacji, aby sprawdzić, czy ustawienia administracyjne są ma na to wpływ. Zmiana ustawienia administracyjnego może spowodować przywrócenie pełnego poziomu do aplikacji Google Chat i przeprowadzić migrację. niepotrzebne. Na przykład administrator Google Workspace może mieć dodać aplikację Google Chat do listy dozwolonych. zezwolić użytkownikom na instalowanie komunikatorów. Więcej informacji: Określanie, czy po scaleniu organizacji w Google Workspace trzeba przenieść aplikacje Google Chat
Po określeniu, że musisz przeprowadzić migrację Aplikacja Google Chat musi wykonać ten 3-etapowy proces:
- Skonfiguruj środowisko aplikacji Google Chat przez Utworzenie projektu Google Cloud w scalonej organizacji, włączenie interfejsów API skonfigurować ekran zgody OAuth 2.0.
- Wdróż ponownie aplikację Google Chat z nowej Projekt w chmurze.
- Dodawanie odtworzonej aplikacji Google Chat do Google Chat pokoje lub rozmowy i wyłącz oryginał aplikacja Google Chat.
Tworzenie projektu Cloud w scalonej organizacji i włączanie interfejsów API
Tworzę nowy projekt Cloud i włączam interfejsy API dla Aplikacja do obsługi czatu w scalonej organizacji Google Workspace zapewnia, że użytkownicy i grupy, którym zezwolisz na dostęp do Aplikacja do obsługi czatu może to robić bez błędów.
Utwórz projekt Google Cloud
Google Cloud Console
- W konsoli Google Cloud otwórz menu . > Administracja Administracja > Utwórz projekt.
-
W polu Project Name (Nazwa projektu) wpisz opisową nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Identyfikatora projektu nie można zmienić po jego utworzeniu, wybierz więc identyfikator, który odpowiada potrzebom od początku w projektach AI.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla w projektach AI. Następnie kliknij Wybierz.
- Kliknij Utwórz. Konsola Google Cloud otworzy stronę Panel, a projekt zostanie utworzony. w ciągu kilku minut.
interfejs wiersza poleceń gcloud
W jednym z tych środowisk programistycznych uzyskaj dostęp do Google Cloud Interfejs wiersza poleceń (`gcloud`):
-
Cloud Shell: korzystanie z terminala online za pomocą interfejsu wiersza poleceń gcloud.
już skonfigurowane, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Local Shell (Powłoka lokalna): aby użyć lokalnego środowiska programistycznego,
instalacja oraz
zainicjuj
w gcloud CLI.
Aby utworzyć projekt Google Cloud, użyj polecenia `gcloud projects create`:
Zastąp PROJECT_ID, ustawiając identyfikator projektu, który chcesz utworzyć.gcloud projects create PROJECT_ID
Włącz interfejsy API
Wszystkie aplikacje Google Chat muszą mieć interfejs Google Chat API . W zależności od tego, jak została utworzona aplikacja Google Chat, może być konieczne włączenie innych interfejsów API. Jeśli na przykład utworzenie aplikacji Google Chat przy użyciu Google Cloud Functions, włączyć interfejsy Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API Artifact Registry API i Cloud Run API. Sprawdzoną metodą jest zapewnienie, aplikacji, które zostały przeniesione, włącz te same interfejsy API w nowym projekcie Cloud, są włączone w starym projekcie Cloud.
Aby włączyć interfejs API, wykonaj te czynności:
Google Cloud Console
- W konsoli Google Cloud otwórz menu . > Więcej produktów > Google Workspace > Biblioteka usług.
- Kliknij interfejs API, który chcesz włączyć.
- Kliknij Włącz.
- Aby włączyć więcej interfejsów API, powtórz te czynności.
Google Cloud CLI
- Zainstaluj lub otwórz interfejs wiersza poleceń Google Cloud (CLI).
-
Uruchom polecenie
services enable, aby określić, którą usługę API chcesz włączyć.gcloud services enable API_SERVICE_ID
Konfigurowanie interfejsu Chat API
W swoim nowym projekcie Cloud musisz użyć interfejsu Chat API, aby: podaj nazwę, opis i ikonę aplikacji Google Chat. Do skonfigurować te szczegóły, zobacz Konfigurowanie interfejsu Chat API
Konfigurowanie ekranu zgody OAuth
Może być konieczne skonfigurowanie ekranu zgody OAuth Projekt w chmurze. Jeśli do autoryzacji używasz protokołu OAuth 2.0, użyj te same zakresy autoryzacji dostępu.
- W konsoli Google Cloud otwórz menu . > Interfejsy API i Usługi > Ekran zgody OAuth.
- Wybierz typ użytkownika aplikacji, a następnie kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
Jeśli tworzysz aplikację do użytku poza Google Workspace kliknij Dodaj lub usuń zakresy. Stosując te sprawdzone metody, wybieranie zakresów:
- Wybierz zakresy zapewniające minimalny poziom dostępu wymagany przez aplikację. Lista: dostępnych zakresów, patrz Zakresy protokołu OAuth 2.0 dla interfejsów API Google
- Przejrzyj zakresy wymienione w każdej z 3 sekcji: niewrażliwe. zakresy, zakresy wrażliwe i zakresy z ograniczeniami. Dla wszystkich zakresów wymienionych w „Twoje zakresy wrażliwe” lub „Twoje zakresy z ograniczeniami” spróbuj określić, alternatywnych zakresów niewrażliwych, aby uniknąć zbędnych dodatkowych weryfikacji.
- Niektóre zakresy wymagają dodatkowego sprawdzenia przez Google. Tylko w przypadku aplikacji używanych wewnętrznie przez Twoją organizację Google Workspace, zakresy nie są wymienione w ekranu zgody i korzystanie z zakresów ograniczonych lub wrażliwych nie wymaga do dalszego sprawdzenia przez Google. Więcej informacji: Kategorie zakresów.
- Po wybraniu wymaganych zakresów kliknij Zapisz i kontynuuj.
- Jeśli jako typ użytkownika wybierzesz Zewnętrzny, dodaj użytkowników testowych:
- W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
- Wpisz swój adres e-mail i innych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz i kontynuuj.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli aplikacja z rejestracji wszystko jest w porządku, kliknij Back to Dashboard (Powrót do panelu).
Wdróż ponownie aplikację Google Chat w nowym projekcie Cloud
W zależności od tego, czy aplikacja Google Chat została zbudowana Apps Script, AppSheet lub innego typu połączenia, np. Python lub Java, ponowne wdrożenie aplikacji Google Chat różni się mało. W obu przypadkach nie musisz ponownie tworzyć całego kodu, ale musisz wprowadzić pewne zmiany.
Migracja logiki aplikacji Google Chat
W zależności od architekturę aplikacji Google Chat, może być konieczne przeniesienie innych usług do nowego projektu Cloud:
- W przypadku aplikacji HTTP musisz też przenieść pozostałą część jej logiki, została stworzona za pomocą Cloud Functions, Cloud Run lub App Engine.
- W przypadku rozmów w Google Chat, które używają języka naturalnego, Trzeba też przenieść agenty Dialogflow.
- W przypadku aplikacji do obsługi czatu, które działają za zaporą sieciową, przenieść tematy Pub/Sub.
Skonfiguruj funkcje interaktywne w nowym projekcie Cloud
Aby ponownie wdrożyć aplikację Google Chat utworzoną w danym języku np. Pythona lub Java, skonfiguruj aplikację Google Chat w nowym projekcie Cloud.
Aby skonfigurować funkcje interaktywne, zobacz Otrzymywanie interakcji użytkowników i reagowanie na nie
Ponowne wdrażanie aplikacji Apps Script Google Chat
Aby ponownie wdrożyć aplikację Google Chat stworzoną za pomocą Apps Script, zmień numer projektu Cloud Projekt Apps Script jest powiązany z numerem projektu, który należy do Twojego nowego projektu Cloud. Następnie skopiuj Identyfikator wdrożenia Apps Script i wklej go w polu Strona konfiguracji aplikacji do obsługi czatu w konsoli Google Cloud.
Kopiowanie numeru projektu Cloud
- W konsoli Google Cloud otwórz menu . > Administracja Administracja > Ustawienia.
- Skopiuj wartość z pola Numer projektu.
Ustawianie numeru projektu Google Cloud w projekcie Apps Script
Otwórz Apps Script.
W projekcie Apps Script w aplikacji Google Chat kliknij Ustawienia projektu .
W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
W polu Numer projektu GCP wklej numer projektu Google Cloud.
Kliknij Set project (Ustaw projekt).
Skopiuj identyfikator wdrożenia projektu Apps Script
- W prawym górnym rogu Apps Script kliknij Wdróż > Zarządzanie wdrożeniami.
- W sekcji Identyfikator wdrożenia kliknij Kopiuj.
- Kliknij Gotowe.
Ponowne konfigurowanie i wdrażanie aplikacji Google Chat
W konsoli Google Cloud wyszukaj „Google Chat API”. i kliknij Google Chat API, a następnie kliknij Zarządzaj.
Kliknij kartę Configuration (Konfiguracja) i wpisz następujące wymagane pola. informacje:
- Nazwa aplikacji: nazwa, z której korzystają użytkownicy podczas interakcji z Twoją aplikacją. aplikacja Google Chat.
- URL awatara: adres URL HTTPS wskazujący kwadratowy obraz graficzny. (na przykład PNG lub JPEG), co najmniej 128 x 128, będzie awatara Twojej aplikacji Google Chat.
- Opis: umożliwia widoczne przeznaczenie aplikacji do obsługi czatu, pod nazwą aplikacji Google Chat.
Aby włączyć funkcje interaktywne, kliknij Włącz funkcje interaktywne przełącznik, który pozwala użytkownikom na Aplikacja do obsługi czatu:
W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
W polu Deployment ID (Identyfikator wdrożenia) wklej wcześniej przesłany identyfikator wdrożenia. skopiowano.
Aby dokończyć konfigurowanie, wyświetl tabelę w Konfigurowanie aplikacji Google Chat w nowym projekcie Cloud
Kliknij Zapisz.
Ponowne wdrażanie aplikacji AppSheet Chat
Aby ponownie wdrożyć aplikację Google Chat stworzoną za pomocą AppSheet w Twoim nowym projekcie Cloud, skopiuj aplikację do nowego projektu Cloud.
Aktualizowanie konta usługi
Jeśli Twoja aplikacja Google Chat uwierzytelnia się jako aplikacja i używa aby wywoływać interfejsy API Google, zaktualizuj pole Szczegóły konta usługi aplikacji Google Chat. Więcej Więcej informacji zawiera Uwierzytelnij się jako aplikacja Google Chat.
Udostępnianie aplikacji Google Chat
Zanim Twoja aplikacja Google Chat stanie się dostępna dla użytkowników nowej organizacji, być może administrator będzie musiał ręcznie zezwolić na dostęp aplikacja Google Chat. Aby dowiedzieć się więcej, patrz Jak administratorzy Google Workspace instalują aplikacje Google Chat
Przejdź na nową aplikację Google Chat
Po przeniesieniu aplikacji Google Chat do nowej czas na ich reklamowanie. Dodaj do pokoi czatu lub czatów, a następnie usuń starą aplikację Google Chat. dzięki czemu użytkownicy mogą wysyłać wiadomości tylko do przeniesionych aplikacja Google Chat.
Dodawanie nowej aplikacji Google Chat do pokoi czatu
Otwórz Google Chat.
Kliknij czat lub pokój.
Kliknij menu obok nazwy pokoju lub osoby, a następnie wybierz Aplikacje i .
Kliknij Dodaj aplikacje.
Wpisz nazwę aplikacji, wybierz ją na liście i kliknij Dodaj.
Powtórz te czynności w przypadku każdego pokoju lub czatu, który chcesz dodać. aplikację Google Chat.
Usuwanie starej aplikacji Google Chat z pokoi czatu
Otwórz Google Chat.
Kliknij czat lub pokój.
Kliknij menu obok nazwy pokoju lub osoby, a następnie wybierz Aplikacje i .
Obok starej, nieprzeniesionej aplikacji Google Chat kliknij Więcej opcji , a następnie kliknij Usuń z pokoju.
Powtórz te czynności w przypadku każdego pokoju lub czatu, który chcesz usunąć. ze starej aplikacji Google Chat.
Wyłączanie starej aplikacji Google Chat
Aby uniemożliwić użytkownikom korzystanie ze starej aplikacji Google Chat i zachęcanie ich do korzystania z nowej aplikacji Google Chat, wyłączyć starą wersję aplikacji Google Chat i cofnąć jej publikację w Google Workspace Marketplace.