Jeśli scalisz organizacje Google Workspace, może być konieczne przeniesienie aplikacji do obsługi czatu, aby nadal działała.
Zanim przeniesiesz aplikację Google Chat, skontaktuj się z administratorem organizacji, aby sprawdzić, czy ustawienia administracyjne mają na nią wpływ. Zmiana ustawienia administracyjnego może przywrócić pełną funkcjonalność aplikacji Google Chat i sprawić, że migracja nie będzie konieczna. Na przykład administrator Google Workspace może musieć dodać 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.
Gdy stwierdzisz, że musisz przeprowadzić migrację aplikacji do czatu, wykonaj te 3 kroki:
- Skonfiguruj środowisko aplikacji do obsługi Google Chat, tworząc projekt Google Cloud w połączonej organizacji, włączając interfejsy API i ewentualnie konfigurując ekran zgody OAuth 2.0.
- Ponownie wdróż aplikację Google Chat z nowego projektu w Cloud.
- Dodaj ponownie utworzoną aplikację Google Chat do pokoi lub rozmów w Google Chat i wyłącz oryginalną aplikację Google Chat.
Tworzenie projektu w Cloud w połączonej organizacji i włączanie interfejsów API
Utworzenie nowego projektu Cloud i włączenie interfejsów API dla aplikacji Google Chat w połączonej organizacji Google Workspace zapewnia, że użytkownicy i grupy, którym zezwolisz na dostęp do aplikacji Google Chat, będą mogli z niej korzystać bez błędów.
Tworzenie projektu w Google Cloud
Google Cloud Console
- 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ć jego identyfikatora, więc wybierz taki, który będzie Ci odpowiadać przez cały okres jego istnienia.
- W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Następnie kliknij Wybierz.
- Kliknij Utwórz. W konsoli Google Cloud otworzy się strona Panel, a projekt zostanie utworzony w ciągu kilku minut.
interfejs wiersza poleceń gcloud
W jednym z tych środowisk programistycznych uzyskaj dostęp do interfejsu Google Cloud CLI (gcloud):
-
Cloud Shell: aby używać terminala online z już skonfigurowanym interfejsem gcloud CLI, aktywuj Cloud Shell.
Aktywuj Cloud Shell -
Lokalna powłoka: aby używać lokalnego środowiska programistycznego, zainstaluj i zainicjuj interfejs wiersza poleceń gcloud.
Aby utworzyć projekt w Google Cloud, użyj poleceniagcloud projects create:gcloud projects create PROJECT_ID
Włącz interfejsy API
Wszystkie aplikacje do obsługi czatu muszą mieć włączony interfejs Google Chat API. W zależności od tego, jak została utworzona aplikacja w Google Chat, może być konieczne włączenie innych interfejsów API. Jeśli na przykład aplikacja Chat 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ć, włącz 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.
-
Uruchom polecenie
services enable, określając usługę API, którą 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 do obsługi czatu. Aby skonfigurować te szczegóły, zapoznaj się z artykułem Konfigurowanie interfejsu Chat API.
Konfigurowanie ekranu zgody OAuth
Może być konieczne skonfigurowanie ekranu zgody OAuth w projekcie w Cloud. Jeśli wcześniej do autoryzacji używasz OAuth 2.0, użyj tych samych zakresów dostępu.
- W konsoli Google Cloud otwórz Menu > > Branding.
- Jeśli masz już skonfigurowany , możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Jeszcze nie skonfigurowano, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
- W sekcji Adres e-mail pomocy dla użytkowników wybierz adres e-mail, na który użytkownicy mogą pisać, jeśli mają pytania dotyczące ich 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ędziemy wysyłać powiadomienia o wszelkich zmianach w Twoim projekcie.
- Kliknij Dalej.
- W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsów API Google i jeśli je akceptujesz, kliknij Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów 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 e-mail innych autoryzowanych testeró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. Podczas wybierania zakresów zalecamy stosowanie tych sprawdzonych metod:
- Wybierz zakresy, które zapewniają minimalny poziom dostępu wymagany przez aplikację. Listę dostępnych zakresów znajdziesz w artykule Zakresy OAuth 2.0 dla interfejsów API Google.
- Sprawdź 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 ograniczone” spróbuj znaleźć 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 korzystanie z zakresów o ograniczonym dostępie lub wrażliwych nie wymaga dalszej weryfikacji przez Google. Więcej informacji znajdziesz w sekcji Kategorie zakresów.
- Po wybraniu zakresów wymaganych przez aplikację kliknij Zapisz.
Więcej informacji o konfigurowaniu zgody OAuth znajdziesz w artykule Pierwsze kroki z .
Ponowne wdrożenie aplikacji do obsługi czatu w nowym projekcie Cloud
Ponowne wdrażanie aplikacji Google Chat różni się w zależności od tego, czy została ona utworzona za pomocą Apps Script, AppSheet czy innego typu połączenia, np. Pythona lub Javy. W obu przypadkach nie musisz odtwarzać całego kodu, ale musisz wprowadzić pewne zmiany.
Migracja logiki aplikacji Google Chat
W zależności od architektury aplikacji do obsługi czatu może być konieczne przeniesienie innych usług do nowego projektu w chmurze:
- 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 aplikacji do obsługi czatu, które korzystają z języka naturalnego, musisz też przenieść agentów Dialogflow.
- W przypadku aplikacji do obsługi czatu, które są zbudowane za zaporą, musisz też przenieść tematy Pub/Sub.
Konfigurowanie funkcji interaktywnych w nowym projekcie w chmurze
Aby ponownie wdrożyć aplikację Google Chat utworzoną w języku takim jak Python lub Java, skonfiguruj ją w nowym projekcie Cloud.
Aby skonfigurować funkcje interaktywne, zapoznaj się z artykułem Odbieranie interakcji użytkownika i odpowiadanie na nie.
Ponowne wdrażanie aplikacji Google Chat w Apps Script
Aby ponownie wdrożyć aplikację Google Chat utworzoną za pomocą Apps Script, zmień numer projektu Cloud, z którym jest powiązany projekt Apps Script, na numer projektu należący do nowego projektu Cloud. Następnie skopiuj identyfikator wdrożenia Apps Script i wklej go na stronie konfiguracji aplikacji w Google Chat w konsoli Google Cloud.
Skopiuj numer 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 w aplikacji Google Chat kliknij Ustawienia projektu .
W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
W sekcji 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 do obsługi czatu
W konsoli Google Cloud wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie kliknij 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.
- Adres URL awatara: adres URL HTTPS wskazujący kwadratowy obraz graficzny (np. PNG lub JPEG) o rozmiarze co najmniej 128 × 128 pikseli, który będzie wyświetlany jako awatar aplikacji do obsługi czatu.
- Opis: opis przeznaczenia aplikacji do obsługi czatu, który pojawia się pod nazwą aplikacji.
Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne, który umożliwia użytkownikom interakcję z aplikacją Google Chat:
W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia.
Aby dokończyć konfigurację, zapoznaj się z tabelą w sekcji Konfigurowanie aplikacji do obsługi czatu w nowym projekcie w chmurze.
Kliknij Zapisz.
Ponowne wdrażanie aplikacji Google Chat na platformie AppSheet
Aby ponownie wdrożyć aplikację do obsługi czatu utworzoną za pomocą AppSheet w nowym projekcie Cloud, skopiuj aplikację do nowego projektu Cloud.
Aktualizowanie 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 do obsługi czatu.
Udostępnianie aplikacji Google Chat
Zanim aplikacja do obsługi czatu stanie się dostępna dla użytkowników w nowej organizacji, administrator może ręcznie zezwolić na dostęp do niej. Więcej informacji znajdziesz w artykule Konfigurowanie dostępu dla organizacji Google Workspace w dokumentacji Google Workspace Marketplace.
Przełączanie się na nową aplikację Chat
Po przeniesieniu aplikacji Google Chat do nowej organizacji możesz ją upublicznić. Dodaj ją do pokoi w Chat lub wiadomości bezpośrednich, a następnie usuń z nich starą aplikację Chat, aby użytkownicy mogli wysyłać wiadomości tylko w przeniesionej aplikacji Chat.
Dodawanie nowej aplikacji Google Chat do pokoi w Google Chat
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, a następnie kliknij Dodaj.
Powtórz te czynności w przypadku każdego pokoju lub czatu, do którego chcesz dodać aplikację 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 Chat kliknij Więcej opcji , a następnie Usuń z pokoju.
Powtórz te czynności w przypadku każdego pokoju lub czatu, z którego chcesz usunąć starszą wersję aplikacji Google Chat.
Wyłączanie starej aplikacji Google Chat
Aby uniemożliwić użytkownikom korzystanie ze starej aplikacji Google Chat i zachęcić ich do używania nowej, wyłącz starą aplikację Google Chat i wycofaj ją z Google Workspace Marketplace.