Jeśli scalasz organizacje Google Workspace, konieczne może być przeniesienie aplikacji Google Chat, aby nadal działała.
Zanim przeniesiesz swoją aplikację do obsługi czatu, skontaktuj się z administratorem organizacji, aby sprawdzić, czy ustawienia administracyjne nie mają na nią wpływu. Zmiana ustawienia administracyjnego może przywrócić pełną funkcjonalność aplikacji do obsługi czatu i sprawić, że migracja nie będzie konieczna. Na przykład administrator Google Workspace może dodać Twoją aplikację Google Chat do listy dozwolonych lub zezwolić użytkownikom na instalowanie takich aplikacji. Więcej informacji znajdziesz w artykule Określanie, czy po scaleniu organizacji Google Workspace trzeba przeprowadzić migrację aplikacji Google Chat.
Gdy ustalisz, że musisz przeprowadzić migrację aplikacji Google Chat, wykonaj te 3 kroki:
- Aby skonfigurować środowisko dla aplikacji do obsługi czatu, utwórz projekt Google Cloud w scalonej organizacji, włącz interfejsy API i ewentualnie skonfiguruj ekran zgody OAuth 2.0.
- Wdróż ponownie aplikację do obsługi czatu z nowego projektu Cloud.
- Dodaj odtworzoną aplikację Google Chat do pokoi i rozmów Google Chat i wyłącz oryginalną aplikację Google Chat.
Tworzenie projektu Cloud w scalonej organizacji i włączanie interfejsów API
Utworzenie nowego projektu w chmurze i włączenie interfejsów API aplikacji Google Chat w scalonej organizacji Google Workspace sprawi, że użytkownicy i grupy, którym zezwolisz na dostęp do aplikacji Google Chat, będą mogli to robić bez błędów.
Tworzenie projektu Cloud
Konsola Google Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Utwórz projekt.
-
W polu Nazwa projektu wpisz opisową nazwę projektu.
Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić identyfikatora, więc wybierz taki, który spełnia Twoje potrzeby przez cały okres istnienia projektu.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje swojego projektu. Następnie kliknij Wybierz.
- Kliknij Utwórz. W konsoli Google Cloud otworzy się strona panelu, a w ciągu kilku minut zostanie utworzony projekt.
interfejs wiersza poleceń gcloud
Uzyskaj dostęp do interfejsu wiersza poleceń Google Cloud („gcloud”) w jednym z tych środowisk programistycznych:
-
Cloud Shell: aby używać terminala online ze skonfigurowanym już interfejsem wiersza poleceń gcloud, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Local Shell (Powłoka lokalna): aby używać lokalnego środowiska programistycznego, zainstaluj i initialize interfejs wiersza poleceń gcloud.
Aby utworzyć projekt 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łączanie interfejsów API
Wszystkie aplikacje do obsługi czatu muszą mieć włączony interfejs Google Chat API. W zależności od tego, jak zbudowana jest aplikacja do obsługi czatu, może być konieczne włączenie innych interfejsów API. Jeśli na przykład aplikacja do obsługi 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. Sprawdzoną metodą jest włączenie w nowym projekcie Cloud tych samych interfejsów API, które są włączone w starym projekcie Cloud, aby zapewnić działanie przeniesionej aplikacji.
Aby włączyć interfejs API:
Konsola Google Cloud
- W konsoli Google Cloud kliknij 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.
-
Uruchom polecenie
services enable, aby określić, którą usługę API chcesz włączyć.gcloud services enable API_SERVICE_ID
Konfigurowanie ekranu zgody OAuth
Może być konieczne skonfigurowanie ekranu zgody OAuth w projekcie Cloud. Jeśli wcześniej do autoryzacji był używany protokół OAuth 2.0, użyj tych samych zakresów autoryzacji dostępu.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran akceptacji OAuth.
- Wybierz typ użytkownika aplikacji, a potem kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a następnie kliknij Zapisz i kontynuuj.
Jeśli tworzysz aplikację do użytku poza organizacją Google Workspace, kliknij Dodaj lub usuń zakresy. Podczas wybierania zakresów zalecamy stosowanie tych sprawdzonych metod:
- Wybierz zakresy zapewniające minimalny poziom dostępu wymagany przez aplikację. Listę dostępnych zakresów znajdziesz w artykule 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 sekcjach „Twoje zakresy wrażliwe” lub „Twoje zakresy z ograniczeniami” spróbuj znaleźć alternatywne zakresy, które nie są wrażliwe, aby uniknąć zbędnych dodatkowych weryfikacji.
- Niektóre zakresy wymagają dodatkowego sprawdzenia przez Google. W przypadku aplikacji używanych tylko wewnętrznie przez Twoją organizację Google Workspace zakresy nie są wymienione na ekranie zgody, a używanie zakresów z ograniczeniami lub wrażliwych nie wymaga dalszego sprawdzenia przez Google. Więcej informacji znajdziesz w artykule o kategoriach zakresu.
- Po wybraniu zakresów wymaganych przez aplikację 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 pozostałych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz i kontynuuj.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda na prawidłową, kliknij Back to Dashboard (Powrót do panelu).
Wdróż ponownie aplikację Google Chat w nowym projekcie Cloud
Ponowne wdrożenie aplikacji do obsługi czatu różni się w zależności od tego, czy aplikacja do obsługi czatu została utworzona za pomocą Apps Script, AppSheet czy innego typu połączenia, np. Pythona lub Java. W obu przypadkach nie musisz ponownie tworzyć całego kodu, ale musisz wprowadzić pewne zmiany.
Migracja logiki aplikacji do obsługi czatu
W zależności od architektury Twojej aplikacji do obsługi czatu może być konieczne przeniesienie innych usług do nowego projektu Cloud:
- W przypadku aplikacji HTTP musisz też przenieść pozostałą część logiki aplikacji, która została utworzona za pomocą Cloud Functions, Cloud Run lub App Engine.
- W przypadku konwersacyjnych aplikacji do obsługi czatu, które używają języka naturalnego, musisz też przenieść agenty Dialogflow.
- W przypadku aplikacji do obsługi czatu, które znajdują się za zaporą sieciową, musisz też przenieść tematy Pub/Sub.
Skonfiguruj aplikację Google Chat w nowym projekcie Cloud
Aby ponownie wdrożyć aplikację do obsługi czatu utworzoną w języku takim jak Python czy Java, skonfiguruj ją w nowym projekcie Cloud.
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ą Google Chat.
- Adres URL awatara: adres URL HTTPS wskazujący kwadratowy obraz (np. PNG lub JPEG) o wymiarach co najmniej 128 × 128, który wyświetla się jako awatar aplikacji Google Chat.
- Opis: opis przeznaczenia aplikacji do obsługi czatu widoczny pod jej nazwą.
Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne, który umożliwi użytkownikom korzystanie z aplikacji Google Chat. Aby dokończyć konfigurację, użyj tabeli poniżej:
Pole Opis Funkcjonalność Zestaw pól, które określają sposób interakcji aplikacji Google Chat z użytkownikami: - Odbieranie wiadomości 1:1: użytkownicy mogą znaleźć aplikację Google Chat i wysłać do niej wiadomość bezpośrednio w Google Chat.
- Dołączanie do pokoi i rozmów grupowych: użytkownicy mogą dodawać aplikację Google Chat do pokoi i rozmów grupowych.
Ustawienia połączenia Punkt końcowy aplikacji Google Chat, który jest jednym z tych miejsc: - App URL: punkt końcowy HTTPS hostujący implementację aplikacji do obsługi czatu.
- Projekt Apps Script: identyfikator wdrożenia dla projektu Apps Script, który implementuje aplikację Google Chat.
- Nazwa tematu Cloud Pub/Sub: temat Pub/Sub, który aplikacja Google Chat subskrybuje jako punkt końcowy.
- Dialogflow: rejestruje aplikację Google Chat przy użyciu integracji Dialogflow. Więcej informacji znajdziesz w artykule Tworzenie aplikacji Dialogflow Google Chat rozumiejącej język naturalny.
Polecenia rozpoczynające się ukośnikiem Polecenia, które można wyświetlać użytkownikom w Google Chat. Umożliwia użytkownikom wyświetlanie głównych działań związanych z Twoją aplikacją Google Chat w Google Chat i wybranie określonej czynności, z którą chcą wejść w interakcję. Więcej informacji znajdziesz w artykule Reagowanie na polecenia po ukośniku w aplikacji Google Chat (w języku angielskim). Podgląd linków Wzorce adresów URL rozpoznawane przez aplikację Google Chat i udostępniające dodatkowe treści, gdy użytkownicy wysyłają linki. Więcej informacji znajdziesz w sekcji Podgląd linków. Widoczność Maksymalnie 5 osób lub co najmniej 1 grupa dyskusyjna Google, które mogą wyświetlać i instalować Twoją aplikację Google Chat. Użyj tego pola, aby przetestować aplikację lub udostępnić ją swojemu zespołowi. Więcej informacji znajdziesz w artykule Ustawienia widoczności i publikowania w aplikacji Google Chat. Aby rejestrować w Cloud Logging błędy za każdym razem, gdy aplikacja Google Chat zwraca błąd, zaznacz pole wyboru Loguj błędy w usłudze Logging. Więcej informacji znajdziesz w artykule na temat dzienników błędów zapytań dotyczących aplikacji Google Chat.
Kliknij Zapisz. Gdy zapiszesz konfigurację aplikacji do obsługi czatu, będzie ona dostępna dla określonych użytkowników w organizacji Google Workspace.
Ponowne wdrażanie aplikacji do obsługi czatu Apps Script
Aby ponownie wdrożyć aplikację do obsługi czatu utworzoną za pomocą Apps Script, zmień numer projektu Cloud, z którym jest powiązany projekt Apps Script, na numer projektu, który należy do nowego projektu Cloud. Następnie skopiuj identyfikator wdrożenia Apps Script i wklej go na stronie konfiguracji aplikacji Google Chat w konsoli Google Cloud.
Skopiuj numer projektu Cloud
- W konsoli Google Cloud kliknij Menu > 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 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.
Ponowne konfigurowanie i wdrażanie 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ą Google Chat.
- Adres URL awatara: adres URL HTTPS wskazujący kwadratowy obraz (np. PNG lub JPEG) o wymiarach co najmniej 128 × 128, który wyświetla się jako awatar aplikacji Google Chat.
- Opis: opis przeznaczenia aplikacji do obsługi czatu widoczny pod jej nazwą.
Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne, który umożliwia użytkownikom korzystanie z aplikacji Google Chat:
W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
W polu Identyfikator wdrożenia wklej wcześniej skopiowany identyfikator wdrożenia.
Aby dokończyć konfigurację, zapoznaj się z tabelą w sekcji Konfigurowanie aplikacji Google Chat w nowym projekcie Cloud
Kliknij Zapisz.
Ponowne wdrażanie aplikacji AppSheet Chat
Aby ponownie wdrożyć aplikację do obsługi czatu utworzoną za pomocą AppSheet w nowym projekcie Cloud, skopiuj ją do nowego projektu Cloud.
Aktualizowanie konta usługi
Jeśli Twoja aplikacja do obsługi czatu uwierzytelnia się jako aplikacja i używa konta usługi do wywoływania interfejsów API Google, zaktualizuj szczegóły konta usługi tej aplikacji. Więcej informacji znajdziesz w artykule o uwierzytelnianiu się jako aplikacji Google Chat.
Udostępnianie aplikacji Google Chat
Zanim Twoja aplikacja Google Chat stanie się dostępna dla użytkowników w nowej organizacji, może być konieczne ręczne przyznanie dostępu do niej przez administratora. Więcej informacji znajdziesz w artykule Jak administratorzy Google Workspace instalują aplikacje Google Chat.
Przejdź na nową aplikację Google Chat
Po przeniesieniu aplikacji Google Chat do nowej organizacji można ją opublikować. dodać ją do pokoi czatu lub czatów, a potem usunąć z nich starą aplikację, aby użytkownicy mogli wysyłać wiadomości tylko do przeniesionej aplikacji.
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 dla 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 dla każdego pokoju lub czatu, z którego chcesz usunąć starą aplikację Google Chat.
Wyłączanie starej 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ą aplikację Google Chat i cofnij jej publikację w Google Workspace Marketplace.