W tej sekcji opisujemy typowe problemy, które mogą wystąpić podczas tworzenia i testowania aplikacji do obsługi czatu.
Komunikat karty, okno dialogowe lub podgląd linku nie renderuje się lub nie działa zgodnie z oczekiwaniami.
Informacje o rozwiązywaniu 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 zobaczysz komunikat „Aplikacja nie odpowiada”, Sprawdź konfigurację aplikacji Google Chat:
W konsoli Google Cloud kliknij Menu. > Więcej produktów > Google Workspace > Biblioteka usług > Interfejs Google Chat API > Zarządzaj > Konfiguracja.
Pamiętaj, aby w sekcji Stan aplikacji wybrać Aktywna – dostępna dla użytkowników.
W sekcji Funkcje interaktywne sprawdź, czy ustawienia są odpowiednie do funkcji aplikacji. Jeśli Twoja aplikacja do obsługi czatu wchodzi w interakcje z użytkownikami, włącz opcję Włącz funkcje interaktywne:
- Jeśli aplikacja odpowiada na wiadomości, wybierz Odbieraj wiadomości 1:1.
- W sekcji Ustawienia połączenia sprawdź, czy opcje URL aplikacji, identyfikator wdrożenia projektu Apps Script, Nazwa tematu Cloud Pub/Sub lub agent Dialogflow są prawidłowo skonfigurowane i że narzędzie zostało 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 wdrożona przy użyciu pakietu SDK Google Workspace Marketplace, ustawienia widoczności nie są wymagane, ponieważ ustawienia Google Workspace Marketplace mają pierwszeństwo.
Jeśli aplikacja została opublikowana z użyciem 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 Google Chat możesz zobaczyć komunikat
błąd Google Chat API is only available to Google Workspace users
. Ta wiadomość
oznacza, że konto Google użyte do skonfigurowania
Interfejs Chat API nie należy do organizacji Google Workspace. Aby utworzyć
aplikacji do obsługi czatu lub interfejsu Chat API, musisz użyć
Google Workspace
.
Pamiętaj, że użytkownicy Google Chat mogą korzystać z aplikacji Google Chat bez Konto Google Workspace. Aby dowiedzieć się więcej o tym, jak użytkownicy odkrywają i instalują aplikacje Aplikacje do obsługi czatu: artykuł na temat publikowania Aplikacje Google Chat.
Użytkownicy mogą zostać wykluczeni z pokoi
Jeśli administrator Google Workspace nie zezwala użytkownikom na włączanie i wyłączanie historii czatu, to w niektórych przypadkach użytkownicy nie mogą dołączyć do pokoju lub w nim pozostać z powodu konfliktu między ustawieniem na poziomie użytkownika, które wymusza włączenie lub wyłączenie historii czatu, a pokojem odziedziczonym wymuszonym ustawieniem na poziomie organizacji.
Na przykład jeśli użytkownik ma wymuszone włączenie historii czatu a w pokoju ustawienie historii czatu zostanie wymuszone, użytkownik ten może nie mieć możliwości dołączenia do tego pokoju. Oprócz tego użytkownik może zostać usunięty z pokoju, jeśli dołączył przed konfliktem, a następnie opublikuje wiadomość w pokoju po zakończeniu konfliktu.
W tym scenariuszu 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 lub utworzyć wiadomość z uwierzytelnieniem użytkownika może spowodować usunięcie z pokoju uwierzytelnionego użytkownika z ustawieniem historii czatu, który koliduje z danym pokojem.
Więcej informacji znajdziesz w artykule Wykluczanie użytkowników z pokoi w Centrum pomocy dla administratorów Google Workspace.
Rozwiązywanie problemów z usługą Advanced Chat w Google Apps Script
Zobacz stronę Apps Script na temat Zaawansowana usługa czatu.
Użytkownicy nie mogą dodać aplikacji Google Chat do pokoju
Jeśli użytkownicy zobaczą komunikat o błędzie
This organization's administrator must allow users to install this Chat app
podczas próby dodania do pokoju aplikacji Google Chat, pojawia się błąd
może mieć jedną z tych przyczyn:
- Organizacja wyłączyła aplikacje Google Chat.
- Organizacja nie dodała tego konkretnego elementu aplikacji do obsługi czatu na liście dozwolonych organizacji.
Jeśli użytkownik napotka ten komunikat o błędzie podczas próby interakcji z aplikacji Google Chat – przyczyną może być organizacja udzielania dostępu podrzędnej jednostce organizacyjnej bez włączania jej dla nadrzędna jednostka organizacyjna.
Informacje na temat rozwiązania tego problemu znajdziesz tutaj: Zezwalanie użytkownikom na instalowanie komunikatorów
Rozwiązywanie problemów z błędami w Cloud Functions
Jeśli aplikacja Google Chat została zaimplementowana za pomocą Cloud Functions nie działa, poniższe sekcje pomogą Ci go rozwiązać.
Sprawdzanie logów funkcji w Cloud Functions
Na początek sprawdź logi Cloud Functions pod kątem błędów.
W konsoli Google Cloud otwórz stronę Cloud Functions:
Aby otworzyć logi, odszukaj chmurę aplikacji Google Chat Funkcja, a następnie kliknij Pokaż działania > Wyświetl logi.
Eksplorator logów otworzy i uruchomi zapytanie wyświetlające logi funkcji w Cloud Functions, w tym .
Jeśli zarejestrowane informacje domyślne nie wystarczą do debugowania aplikacji, możesz dodać dodatkowe logowanie z kodu funkcji w Cloud Functions. Zapoznaj się z sekcją Wyświetlanie i zapis danych w Google Cloud logi funkcji.
Sprawdzanie błędów funkcji w Cloud Functions
Oprócz logów funkcja w Cloud Functions może też zgłaszać błędy napotkane podczas w domu.
W konsoli Google Cloud otwórz stronę Cloud Functions:
Kliknij funkcję w Cloud Functions aplikacji Google Chat.
Na stronie z informacjami o funkcji błędy są wymienione w sekcji Błędy.
Aby dokładniej rozwiązać problem, kliknij go.
Naprawianie częstych błędów funkcji w Cloud Functions
Podczas tworzenia Aplikacja do obsługi czatu z Cloud Functions.
Funkcja ChatApp w regionie REGION_NAME
w projekcie PROJECT_NAME
już istnieje
Podczas wdrażania funkcji w Cloud Functions może wystąpić błąd Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists
. Ten komunikat oznacza, że inna funkcja w Cloud Functions ma taką samą nazwę jak
wdrażany. zmienić nazwę;
do ponownego wdrożenia funkcji. Sprawdź, czy aplikacja Google Chat używa adresu URL wyzwalacza w przypadku
użyj funkcji w Cloud Functions, a nie adresu URL wyzwalacza istniejącej funkcji w Cloud Functions.
Co najmniej 1 użytkownik wskazany w zasadzie nie należy do uprawnionego klienta
Podczas wdrażania funkcji w Cloud Functions 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 wyświetli się ten błąd, a następnie wyświetli się komunikat
aplikacji do obsługi czatu, pojawia się błąd z informacją, że aplikacja nie odpowiada, ponieważ Google
Google Chat nie może połączyć się z serwerem hostującym funkcję w Cloud Functions. Ten komunikat oznacza, że
użytkownik o nazwie „allUsers” nie ma uprawnień do wywoływania funkcji w Cloud Functions.
Przyznawanie „allUsers” „Wywołujący Cloud Functions” oznacza, że Google Cloud
Funkcja, na której opiera się aplikacja, jest dostępna publicznie i bez
uwierzytelnianie. Aby dowiedzieć się, jak przypisać rolę, zobacz
Przypisz jedną rolę.
Ten błąd może oznaczać, że projekt Google Cloud jest ograniczony do domeny. Dla: Więcej informacji o ograniczeniach dotyczących domen znajdziesz w artykule Ograniczanie tożsamości według domeny
Aby rozwiązać ten problem, sprawdź, czy Twoja funkcja w Cloud Functions zezwala na nieuwierzytelnione . Aby dowiedzieć się, jak zezwolić na nieuwierzytelnione wywołania w przypadku w Cloud Functions, patrz Zezwalanie na publiczny (nieuwierzytelniony) dostęp.