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.
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 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.
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 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 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ą potrzebne, ponieważ ustawienia Google Workspace Marketplace mają pierwszeństwo.
Jeśli aplikacja została opublikowana z pakietem 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
. To oznacza, że konto Google, którego użyto do skonfigurowania interfejsu API Google Chat, 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 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.
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 ten 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 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ą 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 do obsługi czatu, może to być spowodowane przez organizację 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
Administrator musi przyznać aplikacji wymagany zakres autoryzacji OAuth dla tego działania
Kiedy uwierzytelniania w aplikacji Google Chat, może pojawić się następujący 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
otrzymała jednorazową zgodę na używanie aplikacji Google Chat
zakresy autoryzacji, które zaczynają się od nazwy
https://www.googleapis.com/auth/chat.app.*
Aby rozwiązać ten problem:
- Poproś administratora Google Workspace o:
przyznać zatwierdzenie aplikacji Google Chat.
W przypadku użycia tego błędu w logice aplikacji Google Chat
rozważ wysłanie wiadomości z informacją, że
aplikacja do obsługi czatu wymaga zgody administratora
żądane działanie, na przykład:
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 w Cloud Functions
Jeśli aplikacja Google Chat została zaimplementowana za pomocą funkcji Cloud Functions i nie działa, w kolejnych sekcjach znajdziesz informacje, które pomogą Ci rozwiązać ten problem.
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 .
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 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 najczęstszych 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. Zmień nazwę i ponownie wprowadź funkcję. Sprawdź, czy aplikacja Google Chat używa adresu URL wyzwalacza w przypadku
użyj funkcji w Cloud Functions, a nie adresu URL aktywatora 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 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 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).