Jeśli scalisz organizacje Google Workspace, może być konieczne przeniesienie aplikacji Chat, 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 aplikacje Google Chat wymagają migracji.
Gdy stwierdzisz, że musisz przeprowadzić migrację aplikacji do obsługi czatu, wykonaj te 3 kroki:
- Skonfiguruj środowisko aplikacji do obsługi czatu, 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ę do czatu do pokoi lub rozmów w Google Chat i wyłącz oryginalną aplikację do czatu.
Tworzenie projektu 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 sprawi, ż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
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ć 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 sposobu utworzenia aplikacji 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. 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:
Konsola Google Cloud
- W konsoli Google Cloud otwórz Menu > Wyświetl wszystkie usługi > Inne usługi Google > 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 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 używasz autoryzacji OAuth 2.0, użyj tych samych zakresów dostępu.
- W konsoli Google Cloud otwórz Menu > Google Auth platform > Branding.
- Jeśli masz już skonfigurowany Google Auth platform, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Google Auth platform Jeszcze nie skonfigurowano, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
- W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, pod którym użytkownicy mogą się z Tobą kontaktować, 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ędziesz otrzymywać powiadomienia o wszelkich 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 jeśli je akceptujesz, 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 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 ograniczonych 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 Google Auth platform.
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ą funkcji Cloud Run, 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 utworzonych 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 do obsługi czatu 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 aplikacją do obsługi czatu w Google Chat.
- 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ą do 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ć pozostałą część konfiguracji, zapoznaj się z tabelą w sekcji Konfigurowanie aplikacji do obsługi czatu w nowym projekcie w Cloud.
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 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ę Google Chat.
Usuwanie starej aplikacji 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 Chat
Aby uniemożliwić użytkownikom korzystanie ze starej aplikacji Google Chat i zachęcić ich do używania nowej aplikacji, wyłącz starą aplikację Google Chat i cofnij jej publikację w Google Workspace Marketplace.