W tej sekcji opisujemy typowe problemy, które mogą wystąpić podczas tworzenia i testowania aplikacji do obsługi czatu.
Wiadomość na karcie, okno lub podgląd linku nie renderuje się lub nie działa zgodnie z oczekiwaniami
Pomoc dotyczącą rozwiązywania problemów z kartami znajdziesz w artykule Rozwiązywanie problemów z kartami.
Aplikacja nie odpowiada
Jeśli wyślesz wiadomość do aplikacji Google Chat i otrzymasz odpowiedź „Aplikacja nie odpowiada”, sprawdź konfigurację aplikacji Google Chat:
W konsoli Google Cloud kliknij Menu > Więcej usług > Google Workspace > Biblioteka usług > Google Chat API > Zarządzaj > Konfiguracja.
W sekcji Stan aplikacji upewnij się, że wybrano opcję Opublikowana – dostępna dla użytkowników.
W sekcji Funkcje interaktywne sprawdź, czy ustawienia są odpowiednie dla funkcji aplikacji. Jeśli aplikacja Google Chat wchodzi w interakcje z użytkownikami, włącz opcję Włącz funkcje interaktywne:
- Domyślnie aplikacje mogą odpowiadać na wiadomości bezpośrednie od użytkowników.
- Jeśli Twoja aplikacja odpowiada na wiadomości w pokojach i czatach grupowych, wybierz Dołącz do pokoi i rozmów grupowych.
- W sekcji Ustawienia połączenia sprawdź, czy adres URL punktu końcowego HTTP, identyfikator wdrożenia projektu Apps Script, nazwa tematu Cloud Pub/Sub lub agent Dialogflow są prawidłowo skonfigurowane i wdrożone.
- W sekcji Widoczność sprawdź, czy odpowiedni użytkownicy mają dostęp do aplikacji za pomocą adresu e-mail lub grupy w domenie Google Workspace. Jeśli aplikacja jest wdrażana za pomocą pakietu SDK Google Workspace Marketplace, ustawienia widoczności nie są konieczne, ponieważ ustawienia Google Workspace Marketplace mają wyższy priorytet.
Jeśli aplikacja jest opublikowana za pomocą pakietu SDK Google Workspace Marketplace, sprawdź ustawienia Google Workspace Marketplace.
Kliknij Zapisz.
Spróbuj ponownie wysłać wiadomość do aplikacji.
Interfejs Google Chat API jest dostępny tylko dla użytkowników Google Workspace
Podczas konfigurowania aplikacji Chat możesz otrzymać błąd Google Chat API is only available to Google Workspace users. Ten komunikat oznacza, że konto Google, którego używasz do konfigurowania interfejsu Chat API, nie należy do organizacji Google Workspace. Aby utworzyć aplikację do obsługi czatu lub korzystać z interfejsu Chat API, musisz użyć konta Google Workspace.
Pamiętaj, że użytkownicy Google Chat mogą korzystać z aplikacji Chat bez konta Google Workspace. Więcej informacji o tym, jak użytkownicy odkrywają i instalują aplikacje Google Chat, znajdziesz w artykule Tworzenie interaktywnych aplikacji Google Chat.
Kiedy użytkownicy mogą zostać wykluczeni z pokoi
Jeśli administrator Google Workspace nie zezwala użytkownikom na włączanie i wyłączanie historii czatu, w niektórych przypadkach użytkownicy mogą nie mieć możliwości dołączenia do pokoju lub pozostania w nim z powodu konfliktu między ustawieniem na poziomie użytkownika, które wymusza włączenie lub wyłączenie historii czatu, a pokojem, który dziedziczy wymuszone ustawienie na poziomie organizacji.
Jeśli na przykład użytkownik ma wymuszone ustawienie historii czatu „włączone”, a pokój ma wymuszone ustawienie historii czatu „wyłączone”, użytkownik może nie mieć możliwości dołączenia do pokoju. Dodatkowo użytkownik może zostać usunięty z pokoju, jeśli dołączył do niego przed wystąpieniem konfliktu, a następnie opublikował w nim wiadomość po wystąpieniu konfliktu.
W takim przypadku i w innych sytuacjach, w których występują konflikty między ustawieniami historii, interfejs Chat API może nie być w stanie utworzyć członkostwa. Utworzenie wiadomości z uwierzytelnianiem użytkownika może spowodować usunięcie z pokoju uwierzytelnionego użytkownika z konfliktującym ustawieniem historii czatu.
Więcej informacji znajdziesz w artykule Kiedy użytkownicy mogą zostać wykluczeni z pokoi w Centrum pomocy dla administratorów Google Workspace.
Rozwiązywanie problemów z usługą Advanced Chat w Google Apps Script
Więcej informacji znajdziesz na stronie Apps Script poświęconej zaawansowanej usłudze Chat.
Użytkownicy nie mogą dodawać aplikacji Google Chat do pokoju
Jeśli podczas próby dodania aplikacji do pokoju w Google Chat użytkownicy zobaczą komunikat o błędzieThis organization's administrator must allow users to install this Chat app, może to być spowodowane jedną z tych przyczyn:
- Organizacje wyłączyły aplikacje do czatu.
- Organizacja nie dodała tej konkretnej aplikacji do czatu do listy dozwolonych.
Jeśli użytkownik zobaczy ten komunikat o błędzie podczas próby interakcji z aplikacją do czatu, może to być spowodowane tym, że organizacja przyznała dostęp do podrzędnej jednostki organizacyjnej, ale nie włączyła go w nadrzędnej jednostce organizacyjnej.
Informacje o tym, jak rozwiązać ten problem, znajdziesz w artykule Zezwalanie użytkownikom na instalowanie aplikacji na czacie.
Aby wykonać to działanie, administrator musi przyznać aplikacji wymagany zakres autoryzacji OAuth.
Podczas uwierzytelniania jako aplikacja do obsługi czatu może pojawić się ten błąd:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Ten komunikat o błędzie oznacza, że administrator Google Workspace nie udzielił jeszcze jednorazowej zgody na używanie przez aplikację Google Chat zakresów autoryzacji, które zaczynają się od nazwy https://www.googleapis.com/auth/chat.app.*.
Aby rozwiązać ten problem:
- Poproś administratora Google Workspace o przyznanie uprawnień aplikacji do Google Chat.
Podczas obsługi tego błędu w logice aplikacji do Google Chat rozważ wysłanie wiadomości z informacją, że aplikacja do Google Chat wymaga zatwierdzenia przez administratora, aby wykonać żądane działanie, np.:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Jeśli metoda interfejsu Chat API obsługuje zakres autoryzacji
https://www.googleapis.com/auth/chat.bot, który nie wymaga zatwierdzenia przez administratora, rozważ użycie tej metody. Aby sprawdzić, które zakresy autoryzacji obsługuje dana metoda, zapoznaj się z artykułem Uwierzytelnianie i autoryzowanie aplikacji Google Chat oraz żądań do interfejsu Google Chat API.
Rozwiązywanie problemów z błędami funkcji w Cloud Functions
Jeśli aplikacja do czatu jest zaimplementowana za pomocą Cloud Functions i nie działa, w rozwiązaniu problemu pomogą Ci te sekcje.
Sprawdzanie logów funkcji w Cloud Functions
Najpierw sprawdź logi Cloud Functions pod kątem błędów.
W konsoli Google Cloud otwórz stronę Cloud Functions:
Aby otworzyć logi, znajdź funkcję Cloud Function aplikacji Chat, a następnie kliknij Pokaż działania > Wyświetl logi.
Otworzy się eksplorator logów, który uruchomi zapytanie wyświetlające logi Cloud Functions, w tym błędy.
Jeśli domyślne informacje rejestrowane nie wystarczają do debugowania aplikacji, możesz dodać dodatkowe logowanie z kodu funkcji w Cloud Functions. Zobacz Wyświetlanie i zapisywanie logów Cloud Functions.
Sprawdzanie błędów Cloud Functions
Oprócz logów funkcja w Cloud Functions może też zgłaszać błędy napotkane podczas działania.
W konsoli Google Cloud otwórz stronę Cloud Functions:
Kliknij funkcję Cloud Function aplikacji do obsługi czatu.
Na stronie ze szczegółami funkcji błędy są wymienione w sekcji Błędy.
Aby dowiedzieć się więcej o błędzie, kliknij go.
Rozwiązywanie typowych błędów funkcji w Cloud Functions
Podczas tworzenia aplikacji do czatu za pomocą Cloud Functions czasami występują te błędy.
Funkcja ChatApp w regionie REGION_NAME w projekcie PROJECT_NAME już istnieje
Podczas wdrażania funkcji w Cloud Functions może pojawić się błąd Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Ten komunikat oznacza, że inna funkcja Cloud Function ma taką samą nazwę jak funkcja, którą wdrażasz. Zmień nazwę i ponownie wdróż funkcję. Sprawdź, czy aplikacja do obsługi czatu używa adresu URL aktywatora funkcji Cloud Function, a nie adresu URL aktywatora istniejącej funkcji Cloud Function.
Co najmniej jeden użytkownik wymieniony w zasadach nie należy do dozwolonego klienta
Podczas wdrażania funkcji Cloud Function może pojawić się błąd The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." Jeśli po otrzymaniu tego błędu wyślesz wiadomość do aplikacji do czatu, pojawi się komunikat o błędzie informujący, że aplikacja nie odpowiada, ponieważ Google Chat nie może nawiązać połączenia z serwerem hostującym funkcję Cloud Function. Ten komunikat oznacza, że użytkownik o nazwie „allUsers” nie ma uprawnień do wywoływania funkcji Cloud Functions.
Przyznanie użytkownikowi „allUsers” roli „Wywołujący funkcje Cloud Functions” oznacza, że funkcja Cloud Functions, która obsługuje aplikację, jest publicznie dostępna i nie wymaga uwierzytelniania. Aby dowiedzieć się, jak przypisać rolę, przeczytaj artykuł Przyznawanie pojedynczej roli.
Ten błąd może oznaczać, że projekt Google Cloud jest ograniczony do domeny. Więcej informacji o ograniczeniach dotyczących domeny znajdziesz w artykule Ograniczanie tożsamości według domeny.
Aby rozwiązać ten problem, sprawdź, czy funkcja w Cloud Functions zezwala na wywoływanie bez uwierzytelniania. Aby dowiedzieć się, jak zezwolić na nieuwierzytelnione wywołania istniejącej funkcji Cloud, przeczytaj artykuł Zezwalanie na publiczny (nieuwierzytelniony) dostęp.