Jeśli złączysz organizacje Google Workspace, konieczne może być przeniesienie aplikacji Google Chat, aby nadal działała.
Zanim przeniesiesz aplikację Google Chat, skontaktuj się z administratorem organizacji, aby sprawdzić, czy nie ma ona ustawień administracyjnych. Zmiana ustawienia administracyjnego może przywrócić pełną funkcjonalność aplikacji Google Chat i uniemożliwić migrację. Na przykład administrator Google Workspace może musieć dodać Twoją aplikację Google Chat do listy dozwolonych lub zezwolić użytkownikom na instalowanie aplikacji Google Chat. Więcej informacji znajdziesz w artykule Sprawdzanie, czy po połączeniu organizacji Google Workspace trzeba przenieść aplikacje Google Chat.
Po ustaleniu, że musisz przenieść aplikację Google Chat, wykonaj te 3 czynności:
- Skonfiguruj środowisko aplikacji Google Chat, tworząc projekt Google Cloud w scalonej organizacji, włączając interfejsy API i ewentualnie konfigurując ekran zgody OAuth 2.0.
- Wdrożyć aplikację Google Chat z nowego projektu Cloud.
- Dodaj odtworzoną aplikację Google Chat do pokoi lub rozmów w Google Chat i wyłącz oryginalną aplikację Google Chat.
Utwórz projekt Cloud w scalonej organizacji i włącz interfejsy API
Utworzenie nowego projektu Cloud i włączenie interfejsów API dla aplikacji Google Chat w złączonej organizacji Google Workspace zapewni, że użytkownicy i grupy, którym zezwolisz na dostęp do aplikacji Google Chat, będą mogli z niej korzystać bez problemów.
Tworzenie projektu Cloud
Google Cloud Console
- W konsoli Google Cloud kliknij Menu > Administracja > Utwórz projekt.
-
W polu Nazwa projektu wpisz nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić jego identyfikatora. Wybierz więc identyfikator, który będzie odpowiadał Twoim potrzebom przez cały czas trwania projektu.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje dla projektu. Następnie kliknij Wybierz.
- Kliknij Utwórz. Konsola Google Cloud przejdzie do strony Panelu, a Twój projekt zostanie utworzony w ciągu kilku minut.
interfejs wiersza poleceń gcloud
W jednym z tych środowisk programistycznych uzyskaj dostęp do interfejsu wiersza poleceń Google Cloud (gcloud):
-
Cloud Shell: aby korzystać z terminala online z już skonfigurowanym interfejsem gcloud CLI, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Interfejs lokalny: aby korzystać z lokalnego środowiska programistycznego, zainstaluj i inicjuj interfejs wiersza poleceń gcloud.
Aby utworzyć projekt Cloud, użyj poleceniagcloud projects create:gcloud projects create PROJECT_ID
Włącz interfejsy API
W przypadku wszystkich aplikacji do obsługi czatu wymagane jest włączenie interfejsu Google Chat API. W zależności od tego, jak została zbudowana Twoja aplikacja do czatu, może być konieczne włączenie innych interfejsów API. Jeśli na przykład aplikacja do czatu została utworzona za pomocą Google Cloud Functions, włącz interfejsy Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API i Cloud Run API. Aby mieć pewność, że przeniesiona aplikacja będzie działać, zalecamy włączyć w nowym projekcie w chmurze te same interfejsy API, które są włączone w starym projekcie w chmurze.
Aby włączyć interfejs API, wykonaj te czynności:
Google Cloud Console
- W konsoli Google Cloud otwórz Menu > Więcej usług > 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, określając, którą usługę interfejsu API chcesz włączyć.gcloud services enable API_SERVICE_ID
Konfigurowanie interfejsu Chat API
W nowym projekcie Cloud musisz użyć interfejsu Chat API, aby określić nazwę, opis i ikonę aplikacji Google Chat. Aby skonfigurować te szczegóły, zapoznaj się z artykułem Konfigurowanie interfejsu Chat API.
Konfigurowanie ekranu zgody OAuth
W przypadku projektu w Google Cloud może być konieczne skonfigurowanie ekranu zgody OAuth. Jeśli do autoryzacji używasz OAuth 2.0, użyj tych samych zakresów dostępu.
- W konsoli Google Cloud otwórz Menu > > Identyfikacja marki.
- Jeśli masz już skonfigurowany projekt , możesz skonfigurować te ustawienia ekranu zgody OAuth: Markowanie, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat nie skonfigurowano, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz Nazwa aplikacji.
- W sekcji Adres e-mail zespołu pomocy wybierz adres e-mail zespołu pomocy, na który użytkownicy będą mogli się z Tobą kontaktować w sprawie pytań dotyczących zgody.
- Kliknij Dalej.
- W sekcji Odbiorcy wybierz typ użytkownika aplikacji.
- Kliknij Dalej.
- W sekcji Dane kontaktowe wpisz adres e-mail, na który będą wysyłane powiadomienia o zmianach w projekcie.
- Kliknij Dalej.
- W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google, a potem, jeśli się z nimi zgadzasz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
- Kliknij Dalej.
- Kliknij Utwórz.
- Jeśli jako typ użytkownika wybierzesz Zewnętrzny, dodaj użytkowników testowych:
- Kliknij Odbiorcy.
- W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
- Wpisz swój adres e-mail i adresy innych autoryzowanych użytkowników testów, a potem kliknij Zapisz.
Jeśli tworzysz aplikację do użytku poza organizacją Google Workspace, kliknij Dostęp do danych > Dodaj lub usuń zakresy. Zalecamy stosowanie tych sprawdzonych metod podczas wybierania zakresów:
- Wybierz zakresy, które zapewniają minimalny poziom dostępu wymaganego przez aplikację. Listę dostępnych zakresów znajdziesz w sekcji Zakresy OAuth 2.0 dla interfejsów API Google.
- Przejrzyj zakresy wymienione w każdej z 3 sekcji: zakresy niewrażliwe, zakresy wrażliwe i zakresy z ograniczeniami. W przypadku zakresów wymienionych w sekcji „Twoje zakresy wrażliwe” lub „Twoje zakresy ograniczone” spróbuj zidentyfikować alternatywne zakresy niewrażliwe, aby uniknąć niepotrzebnych dodatkowych weryfikacji.
- Niektóre zakresy wymagają dodatkowej weryfikacji przez Google. W przypadku aplikacji używanych tylko wewnętrznie przez organizację Google Workspace zakresy nie są wymienione na ekranie zgody, a używanie zakresów ograniczonych lub wrażliwych nie wymaga dalszej weryfikacji przez Google. Więcej informacji znajdziesz w artykule Kategorie zakresu.
- Po wybraniu zakresów wymaganych przez aplikację kliknij Zapisz.
Więcej informacji o konfigurowaniu zgody OAuth znajdziesz w artykule Pierwsze kroki z .
Wdróż ponownie aplikację Google Chat w nowym projekcie Cloud
Wdrażanie aplikacji Google Chat różni się nieco w zależności od tego, czy została ona utworzona za pomocą Apps Script, AppSheet czy innego typu połączenia, np. Python lub Java. W obu przypadkach nie musisz ponownie tworzyć całego kodu, ale musisz wprowadzić w nim pewne zmiany.
Migracja logiki aplikacji Google Chat
W zależności od architektury aplikacji Google Chat może być konieczne przeniesienie innych usług do nowego projektu w chmurze:
- W przypadku aplikacji HTTP musisz też przenieść pozostałą część logiki aplikacji utworzonej za pomocą Cloud Functions, Cloud Run lub App Engine.
- W przypadku konwersacyjnych aplikacji do obsługi czatu, które korzystają z języka naturalnego, musisz też przenieść agentów Dialogflow.
- W przypadku aplikacji Google Chat utworzonych za zaporą ogniową musisz też przenieść tematy Pub/Sub.
Konfigurowanie funkcji interaktywnych w nowym projekcie Cloud
Aby ponownie wdrożyć aplikację Google Chat utworzoną w języku takim jak Python czy Java, skonfiguruj ją w nowym projekcie Cloud.
Aby skonfigurować funkcje interaktywne, zapoznaj się z artykułem Odbieranie i odpowiadanie na interakcje użytkowników.
Wdrażanie ponownie aplikacji Google Chat w Apps Script
Aby ponownie wdrożyć aplikację Google Chat utworzoną w Apps Script, zmień numer projektu Cloud, z którym powiązany jest projekt Apps Script, na numer projektu należącego do nowego projektu Cloud. Następnie skopiuj identyfikator wdrożenia Google Apps Script i wklej go na stronie konfiguracji aplikacji Google Chat w konsoli Google Cloud.
Kopiowanie numeru projektu Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Ustawienia.
- W polu Numer projektu skopiuj wartość.
Ustawianie numeru projektu Google Cloud w projekcie Apps Script
Otwórz Apps Script.
W projekcie Apps Script 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 Ustaw projekt.
Skopiuj identyfikator wdrożenia projektu Apps Script
- W prawym górnym rogu Apps Script kliknij Wdróż > Zarządzaj wdrożeniami.
- W sekcji Identyfikator wdrożenia kliknij Kopiuj.
- Kliknij Gotowe.
Ponowna konfiguracja i ponowne wdrożenie aplikacji Google Chat
W konsoli Google Cloud wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie Zarządzaj.
Kliknij kartę Konfiguracja i wpisz te wymagane informacje:
- Nazwa aplikacji: nazwa, której użytkownicy używają podczas interakcji z Twoją aplikacją do czatu.
- URL awatara: adres URL HTTPS wskazujący kwadratowy obraz graficzny (np. PNG lub JPEG) o rozmiarach co najmniej 128 x 128, który będzie służyć jako awatar w aplikacji Google Chat.
- Opis: opis przeznaczenia aplikacji Google Chat, który pojawia się pod jej nazwą.
Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne, który pozwala użytkownikom wchodzić w interakcje z aplikacją Google Chat:
W sekcji Ustawienia połączenia kliknij Projekt Apps Script.
W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia.
Aby dokończyć pozostałą część konfiguracji, zapoznaj się z tabelą w artykule Konfigurowanie aplikacji Chat w nowym projekcie Cloud.
Kliknij Zapisz.
Wdrażanie aplikacji Google Chat na platformie AppSheet
Aby ponownie wdrożyć aplikację Google Chat utworzoną za pomocą AppSheet w nowym projekcie Cloud, skopiuj ją do tego projektu.
Aktualizacja konta usługi
Jeśli aplikacja Google Chat uwierzytelnia się jako aplikacja i używa konta usługi do wywoływania interfejsów API Google, zaktualizuj szczegóły konta usługi aplikacji Google Chat. Więcej informacji znajdziesz w artykule Uwierzytelnianie jako aplikacja Google Chat.
Udostępnianie aplikacji Google Chat
Zanim aplikacja Google Chat stanie się dostępna dla użytkowników w nowej organizacji, administrator może ręcznie zezwolić na dostęp do tej aplikacji. Więcej informacji znajdziesz w artykule Jak administratorzy Google Workspace instalują aplikacje Google Chat.
Przełącz się na nową aplikację Google Chat
Teraz, gdy aplikacja Google Chat została przeniesiona do nowej organizacji, nadszedł czas na jej opublikowanie. Dodaj je do pokoi Google Chat lub wiadomości bezpośrednich, a następnie usuń starą wersję aplikacji Chat, aby użytkownicy wysyłali wiadomości tylko w migrowanej wersji aplikacji 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 integracje.
Kliknij Dodaj aplikacje.
Wpisz nazwę aplikacji, wybierz ją z listy i kliknij Dodaj.
Powtórz te czynności w przypadku każdego pokoju lub czatu, do którego 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 integracje.
Obok starej, nieprzeniesionej aplikacji Google Chat kliknij Więcej opcji , a następnie Usuń z pokoju.
Powtórz te czynności w przypadku każdego pokoju czatu lub czatu bezpośredniego, z którego chcesz usunąć starszą wersję aplikacji Google Chat.
Wyłączanie starej wersji aplikacji Google Chat
Aby uniemożliwić użytkownikom korzystanie ze starej wersji aplikacji Google Chat i zachęcić ich do korzystania z nowej, wyłącz starą wersję aplikacji i odpublikuj ją na platformie Google Workspace Marketplace.