W tej sekcji opisujemy typowe problemy, które mogą wystąpić podczas tworzenia i testowania aplikacji do obsługi czatu.
wiadomość na karcie, okno dialogowe lub podgląd linku nie działają lub nie są renderowane zgodnie z oczekiwaniami,
Więcej informacji o rozwiązywaniu problemów z kartami znajdziesz w artykule Rozwiązywanie problemów z kartami i ich poprawianie.
Aplikacja nie odpowiada
Jeśli wysyłasz wiadomość do aplikacji Google Chat, a ona odpowiada „Aplikacja nie odpowiada”, sprawdź konfigurację aplikacji Google Chat:
W konsoli Google Cloud kliknij Menu > Więcej usług > Google Workspace > Biblioteka usług > Interfejs API Google Chat > Zarządzaj > Konfiguracja.
W sekcji Stan aplikacji sprawdź, czy wybrana jest opcja Opublikowano – dostępna dla użytkowników.
W sekcji Funkcje interaktywne sprawdź, czy ustawienia są odpowiednie dla funkcji aplikacji. Jeśli Twoja aplikacja Google Chat wchodzi w interakcje z użytkownikami, włącz Włączanie funkcji interaktywnych:
- Jeśli Twoja aplikacja odpowiada na wiadomości, wybierz Otrzymuj wiadomości 1:1.
- 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 wdrożona za pomocą 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 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 Google Chat możesz zobaczyć błąd Google Chat API is only available to Google Workspace users. To oznacza, że konto Google, którego użyto do skonfigurowania interfejsu API Google Chat, nie należy do organizacji Google Workspace. Aby utworzyć aplikację Google Chat lub korzystać z interfejsu Chat API, musisz mieć konto Google Workspace.
Użytkownicy Google Chat mogą korzystać z aplikacji Google Chat bez konta Google Workspace. Więcej informacji o tym, jak użytkownicy odkrywają i instalują aplikacje Google Chat, znajdziesz w artykule Publikowanie aplikacji Google Chat.
Użytkownicy mogą zostać wykluczeni z pokoi
Jeśli administrator Google Workspace nie zezwala użytkownikom na włączanie lub 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 ustawienie wymuszone na poziomie organizacji.
Jeśli na przykład ustawienie historii czatu jest wymuszone na „włączone”, a ustawienie historii pokoju jest wymuszone na „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 konfliktem, a następnie opublikował wiadomość w pokoju po konflikcie.
W tym i innych przypadkach, gdy występują konflikty między ustawieniami historii, interfejs Chat API może nie być w stanie utworzyć członkostwa lub utworzenie wiadomości z uwierzytelnionym użytkownikiem może spowodować usunięcie z pokoju uwierzytelnionego użytkownika z konfliktującym ustawieniem historii czatu.
Więcej informacji znajdziesz w artykule Użytkownicy mogą zostać wykluczeni z pokoju w Centrum pomocy dla administratorów Google Workspace.
Rozwiązywanie problemów z usługą Zaawansowany czat w Google Apps Script
Przeczytaj na stronie Apps Script informacje o zaawansowanej usłudze czatu.
Użytkownicy nie mogą dodawać 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 aplikacji Google Chat do pokoju, może to być spowodowane jednym z tych czynników:
- Organizacja wyłączyła aplikacje Google Chat.
- Organizacja nie dodała tej konkretnej aplikacji Google Chat do listy dozwolonych.
Jeśli użytkownik zobaczy ten komunikat o błędzie podczas próby interakcji z aplikacją Google Chat, może to być spowodowane tym, że organizacja przyznała dostęp jednostce podrzędnej, nie włączając go w przypadku jednostki nadrzędnej.
Informacje o tym, jak rozwiązać ten problem, znajdziesz w artykule Zezwalanie użytkownikom na instalowanie aplikacji na czacie.
Administrator musi przyznać aplikacji wymagany zakres autoryzacji OAuth dla tego działania.
Podczas uwierzytelniania się jako aplikacja Google Chat możesz zobaczyć ten komunikat o błędzie:
<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 przyznał jeszcze jednorazowej zgody aplikacji Google Chat na korzystanie z zakresów uprawnień, których nazwa zaczyna się od https://www.googleapis.com/auth/chat.app.*.
Aby rozwiązać ten problem:
- Poproś administratora Google Workspace o zatwierdzenie aplikacji Google Chat. Podczas obsługi tego błędu w logice aplikacji Google Chat rozważ wysłanie wiadomości z informacją, że aplikacja Google Chat potrzebuje zgody administratora, aby wykonać żądaną czynność, np.:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Jeśli metoda interfejsu API czatu 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 Google Chat została zaimplementowana za pomocą funkcji Cloud Functions i nie działa, w tych sekcjach znajdziesz pomoc w rozwiązywaniu problemów.
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, znajdź funkcję Cloud Function aplikacji Google Chat, 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 błędy.
Jeśli domyślnie rejestrowane informacje nie wystarczą do debugowania aplikacji, możesz dodać dodatkowe rejestrowanie z kodu funkcji w Cloud Functions. Zapoznaj się z artykułem 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ę w Cloud Functions aplikacji Google Chat.
Na stronie Szczegóły funkcji błędy są wymienione w sekcji Błędy.
Aby uzyskać więcej informacji o błędzie, kliknij go.
Naprawianie najczęstszych błędów Cloud Functions
Podczas tworzenia aplikacji do czatu za pomocą Cloud Functions mogą wystąpić 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 Functions ma taką samą nazwę jak funkcja, którą wdrażasz. Zmień nazwę i ponownie wprowadź funkcję. Sprawdź, czy aplikacja Google Chat używa adresu URL aktywatora Twojej funkcji w Cloud Functions, a nie adresu URL aktywatora wcześniej utworzonej funkcji w Cloud Functions.
Co najmniej 1 użytkownik wymieniony w zasadach nie należy do dozwolonego klienta
Podczas wdrażania funkcji w Cloud Functions może wystąpić 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 ten błąd się pojawi, a potem wyślesz wiadomość do aplikacji Google Chat, pojawi się komunikat o błędzie z informacją, że aplikacja nie odpowiada, ponieważ 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łania funkcji Cloud Functions.
Przypisanie roli „Wywołujący funkcje Cloud Functions” użytkownikowi „allUsers” oznacza, że funkcja Cloud Functions, która obsługuje aplikację, jest dostępna publicznie i można z niej korzystać bez uwierzytelniania. Aby dowiedzieć się, jak przypisać rolę, przeczytaj artykuł Przyznawanie jednej roli.
Ten błąd może oznaczać, że projekt Google Cloud jest ograniczony do domeny. Więcej informacji o ograniczeniach dotyczących domen znajdziesz w artykule o ograniczaniu tożsamości według domeny.
Aby rozwiązać ten problem, sprawdź, czy Twoja funkcja Cloud Functions zezwala na wywołania bez uwierzytelniania. Aby dowiedzieć się, jak zezwolić na wywołania nieuwierzytelnionych w przypadku istniejącej funkcji Cloud Function, zapoznaj się z artykułem Zezwalanie na dostęp publiczny (nieuwierzytelniony).