Migracja aplikacji Google Chat

Jeśli połączysz organizacje Google Workspace, być może konieczne będzie przeprowadzenie migracji aplikacji Google Chat, aby nadal działała.

Zanim przeprowadzisz migrację aplikacji Google Chat, 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 Google Chat i sprawić, że migracja nie będzie konieczna. Administrator Google Workspace może na przykład 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 przeprowadzić migrację aplikacji Google Chat.

Gdy stwierdzisz, że musisz przeprowadzić migrację aplikacji Google Chat, wykonaj te 3 czynności:

1. Skonfiguruj środowisko dla aplikacji Google Chat, tworząc projekt w chmurze Google Cloud w połączonej organizacji, włączając interfejsy API i ewentualnie konfigurując ekran zgody OAuth 2.0.
2. Ponownie wdróż aplikację Google Chat z nowego projektu w chmurze.
3. Dodaj ponownie utworzoną aplikację Google Chat do pokoi lub rozmów w Google Chat i wyłącz oryginalną aplikację Google Chat.

Tworzenie projektu w chmurze w połączonej organizacji i włączanie interfejsów API

Utworzenie nowego projektu w chmurze i włączenie interfejsów API dla aplikacji Google Chat w połą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 błędów.

Tworzenie projektu w chmurze

Konsola Google Cloud

1. W konsoli Google Cloud otwórz Menu > Administracja i IAM > Utwórz projekt.

   Otwórz Utwórz projekt

2. W polu Nazwa projektu wpisz opisową nazwę projektu.

   Opcjonalnie: aby edytować identyfikator projektu, kliknij Edytuj. Po utworzeniu projektu nie można zmienić identyfikatora projektu dlatego wybierz identyfikator projektu, który będzie Ci odpowiadał przez cały okres jego istnienia

3. W polu Lokalizacja kliknij Przeglądaj, aby wyświetlić potencjalne lokalizacje projektu. Następnie kliknij Wybierz.
   Uwaga: nie możesz znaleźć swojej organizacji Google Workspace?
   Oznacza to, że nie jesteś zalogowany(-a) na konto Google Workspace. Niektóre funkcje opisane w dokumentacji dla deweloperów Google Workspace są dostępne tylko w projektach powiązanych z organizacją.
4. Kliknij Utwórz. Konsola Google Cloud otworzy stronę Panel, a Twój projekt zostanie utworzony w ciągu kilku minut.

gcloud CLI

W jednym z tych środowisk programistycznych otwórz interfejs wiersza poleceń Google Cloud (gcloud):

• Cloud Shell: aby używać terminala online z już skonfigurowanym interfejsem wiersza poleceń gcloud, aktywuj Cloud Shell.
  Aktywuj Cloud Shell
• Lokalna powłoka: aby używać lokalnego środowiska programistycznego, zainstaluj i zainicjuj gcloud CLI.
  Aby utworzyć projekt w chmurze, użyj polecenia gcloud projects create:

  gcloud projects create PROJECT_ID

  Zastąp PROJECT_ID, ustawiając identyfikator projektu, który chcesz utworzyć.

Włączanie interfejsów API

Wszystkie aplikacje Google Chat muszą mieć włączony interfejs Google Chat API. W zależności od sposobu utworzenia aplikacji Google Chat może być konieczne włączenie innych interfejsów API. Jeśli na przykład aplikacja Google Chat została utworzona za pomocą 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

1. W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Biblioteka > Google Workspace.

   Otwórz bibliotekę interfejsów API

2. Kliknij interfejs API, który chcesz włączyć.
3. Kliknij Włącz.
4. Aby włączyć więcej interfejsów API, powtórz te czynności.

Google Cloud CLI

1. Zainstaluj lub otwórz interfejs wiersza poleceń Google Cloud.

2. Uruchom polecenie services enable, określając usługę interfejsu API, którą chcesz włączyć.

   gcloud services enable API_SERVICE_ID

Konfigurowanie interfejsu Chat API

W nowym projekcie w chmurze musisz użyć interfejsu Chat API, aby określić nazwę, opis i ikonę aplikacji Google Chat. Aby skonfigurować te szczegóły, przeczytaj artykuł Konfigurowanie interfejsu Chat API.

Konfigurowanie ekranu zgody OAuth

Może być konieczne skonfigurowanie ekranu zgody OAuth w projekcie w chmurze. Jeśli wcześniej używałeś(-aś) OAuth 2.0 do autoryzacji, użyj tych samych zakresów autoryzacji.

1. W konsoli interfejsów API Google otwórz Menu > Platforma uwierzytelniania Google > Branding.

   Otwórz Branding

2. Jeśli platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:
1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, na który użytkownicy mogą się kontaktować, jeśli mają pytania dotyczące zgody.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz typ użytkownika aplikacji.
5. Kliknij Dalej.
6. W sekcji Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o wszelkich zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Zakończ zapoznaj się z Zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google i jeśli się z nimi zgadzasz, zaznacz pole Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
9. Kliknij Dalej.
10. Kliknij Utwórz.
11. Jeśli jako typ użytkownika wybierzesz Zewnętrzny, dodaj użytkowników testowych:
    1. Kliknij Odbiorcy.
    2. W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
    3. Wpisz swój adres e-mail i adresy e-mail innych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz.

3. 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 nieobjęte ograniczeniami zakresy objęte ograniczeniami i zakresy z ograniczeniami. W przypadku zakresów wymienionych w sekcjach "Twoje zakresy objęte ograniczeniami" lub "Twoje zakresy z ograniczeniami" spróbuj znaleźć alternatywne zakresy nieobjęte ograniczeniami, 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ą wyświetlane na ekranie zgody, a korzystanie z zakresów objętych ograniczeniami lub zakresów z ograniczeniami nie wymaga dalszej weryfikacji przez Google. Więcej informacji znajdziesz w artykule Kategorie zakresów.
4. Po wybraniu zakresów wymaganych przez aplikację kliknij Zapisz.

Więcej informacji o konfigurowaniu zgody OAuth znajdziesz w artykule Pierwsze kroki z platformą uwierzytelniania Google.

Ponowne wdrażanie aplikacji Google Chat w nowym projekcie w chmurze

W zależności od tego, czy aplikacja Google Chat została utworzona za pomocą Apps Script, AppSheet czy innego typu połączenia, np. Python lub Java, ponowne wdrażanie aplikacji Google Chat może się nieco różnić. 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 architektury aplikacji Google Chat, może być konieczne przeniesienie innych usług do nowego projektu w chmurze:

• W przypadku aplikacji HTTP musisz też przenieść resztę logiki aplikacji utworzonej za pomocą funkcji Cloud Run, Cloud Run lub App Engine.
• W przypadku aplikacji Google Chat, które korzystają z języka naturalnego, musisz też przenieść agentów Dialogflow.
• W przypadku aplikacji Google Chat, które są tworzone za zaporą, musisz też przenieść tematy Pub/Sub.

Konfigurowanie funkcji interaktywnych w nowym projekcie w chmurze

Aby wdrożyć ponownie aplikację Google Chat utworzoną w języku takim jak Python lub Java, skonfiguruj aplikację Google Chat w nowym projekcie w chmurze.

Aby skonfigurować funkcje interaktywne, przeczytaj artykuł Odbieranie interakcji użytkowników i odpowiadanie na nie.

Ponowne wdrażanie aplikacji Google Chat Apps Script

Aby ponownie wdrożyć aplikację Google Chat utworzoną za pomocą Apps Script, zmień numer projektu w chmurze, z którym jest powiązany projekt Apps Script, na numer projektu należący do nowego projektu w chmurze. Następnie skopiuj identyfikator wdrożenia Apps Script i wklej go na stronie konfiguracji aplikacji Google Chat w konsoli interfejsów API Google.

Kopiowanie numeru projektu w chmurze

1. W konsoli interfejsów API Google otwórz Menu > Administracja > Ustawienia.

   Otwórz Ustawienia w obszarze Administracja

2. W polu Numer projektu skopiuj wartość.

Ustawianie numeru projektu Google Cloud w projekcie Apps Script

1. Otwórz Apps Script.

   Otwórz Apps Script

2. W projekcie Apps Script aplikacji Google Chat kliknij Ustawienia projektu .

3. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.

4. W polu Numer projektu GCP wklej numer projektu w chmurze Google.

5. Kliknij Ustaw projekt.

Kopiowanie identyfikatora wdrożenia projektu Apps Script

1. W prawym górnym rogu Apps Script kliknij Wdróż > Zarządzaj wdrożeniami.
2. W sekcji Identyfikator wdrożenia kliknij Kopiuj.
3. Kliknij Gotowe.

Ponowne konfigurowanie i wdrażanie aplikacji Google Chat

1. W konsoli interfejsów API Google wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie kliknij Zarządzaj.

   Otwórz Chat API

2. Kliknij kartę Konfiguracja i wpisz te wymagane informacje:

   • Nazwa aplikacji: nazwa, której użytkownicy używają podczas interakcji z aplikacją Google Chat.
   • Adres URL awatara: adres URL HTTPS wskazujący kwadratowy obraz graficzny (np. PNG lub JPEG) o wymiarach co najmniej 128 × 128 pikseli, który będzie wyświetlany jako awatar aplikacji Google Chat.
   • Opis: opis przeznaczenia aplikacji Google Chat, który pojawia się pod nazwą aplikacji Google Chat.

3. Aby włączyć funkcje interaktywne, kliknij przełącznik Włącz funkcje interaktywne , który umożliwia użytkownikom interakcję z aplikacją Google Chat:

4. W sekcji Ustawienia połączenia kliknij Projekt Apps Script.

5. W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia.

6. Aby dokończyć pozostałą część konfiguracji, zapoznaj się z tabelą w sekcji Konfigurowanie aplikacji do Google Chat w nowym projekcie w chmurze

7. Kliknij Zapisz.

Ponowne wdrażanie aplikacji AppSheet w Google Chat

Aby ponownie wdrożyć aplikację Google Chat utworzoną za pomocą AppSheet w nowym projekcie w chmurze, skopiuj aplikację do nowego projektu w chmurze.

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 aplikacji Google Chat. Więcej informacji znajdziesz w dokumentacji Google Workspace Marketplace w artykule Konfigurowanie dostępu dla organizacji Google Workspace.

Przełączanie na nową aplikację Google Chat

Gdy aplikacja Google Chat zostanie przeniesiona do nowej organizacji, możesz ją udostępnić. Dodaj ją do pokoi lub czatów w Google Chat, a następnie usuń z nich starą aplikację Google Chat, aby użytkownicy mogli wysyłać wiadomości tylko do przeniesionej aplikacji Google Chat.

Sprawdzona metoda: aby ułatwić użytkownikom korzystanie z przeniesionej aplikacji Google Chat, poinformuj ich o migracji i zachęć do zainstalowania przeniesionej aplikacji Google Chat w pokojach i rozmowach w Google Chat.

Dodawanie nowej aplikacji Google Chat do pokoi w Google Chat

1. Otwórz Google Chat.

   Otwórz Google Chat

2. Kliknij czat lub pokój.

3. Kliknij menu obok nazwy pokoju lub osoby, a następnie wybierz Aplikacje i integracje.

4. Kliknij Dodaj aplikacje.

5. Wpisz nazwę aplikacji, wybierz ją z listy, a następnie kliknij Dodaj.

6. 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 w Google Chat

1. Otwórz Google Chat.

   Otwórz Google Chat

2. Kliknij czat lub pokój.

3. Kliknij menu obok nazwy pokoju lub osoby, a następnie wybierz Aplikacje i integracje.

4. Obok starej, nieprzeniesionej aplikacji Google Chat kliknij Więcej opcji , a następnie kliknij Usuń z pokoju.

5. Powtórz te czynności w przypadku 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 aplikacji Google Chat i zachęcić ich do korzystania z nowej aplikacji Google Chat, wyłącz starą aplikację Google Chat i wycofaj jej publikację w Google Workspace Marketplace.