W tej sekcji opisujemy typowe problemy, które mogą wystąpić podczas tworzenia i testowania aplikacji Google Chat.
Karta, okno lub podgląd linku nie renderuje się lub nie działa zgodnie z oczekiwaniami
Aby uzyskać pomoc w rozwiązywaniu problemów z kartami, przeczytaj artykuł Rozwiązywanie problemów z kartami i ich naprawianie.
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 interfejsów API Google kliknij Menu > Interfejsy API i usługi > Włączone interfejsy API i usługi > Google Chat API > Konfiguracja.
W sekcji Stan aplikacji upewnij się, że wybrano opcję Aktywna – dostępna dla użytkowników.
W sekcji Funkcje interaktywne upewnij się, że 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 aplikacja odpowiada na wiadomości w pokojach i czatach grupowych, wybierz opcję Dołączaj do pokoi i rozmów grupowych.
- W sekcji Ustawienia połączenia upewnij się, że adres URL punktu końcowego HTTP, identyfikator wdrożenia projektu Apps Script, nazwa tematu Cloud Pub/Sub lub agent Dialogflow są prawidłowo ustawione i wdrożone.
- W sekcji Widoczność upewnij się, że 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ż mają one pierwszeństwo przed ustawieniami Google Workspace Marketplace.
Jeśli aplikacja jest publikowana 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że pojawić się błąd Google Chat API is only available to Google Workspace users. Ten komunikat oznacza, że konto Google użyte do skonfigurowania interfejsu Chat API nie należy do organizacji Google Workspace. Aby utworzyć aplikację Google Chat lub używać interfejsu Chat API, musisz użyć konta Google Workspace.
Pamiętaj, że użytkownicy Google Chat mogą korzystać z aplikacji Google Chat bez konta Google Workspace. Więcej informacji o tym, jak użytkownicy znajdują 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 zabroni użytkownikom włączania i wyłączania historii Google Chat, 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 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. Ponadto użytkownik może zostać usunięty z pokoju, jeśli dołączył do niego przed konfliktem, a następnie opublikował w nim wiadomość po konflikcie.
W tym i innych przypadkach, w których występują konflikty między ustawieniami historii czatu, interfejs Chat API może nie być w stanie utworzyć członkostwa lub utworzenie wiadomości z uwierzytelnieniem użytkownika może spowodować usunięcie z pokoju uwierzytelnionego użytkownika z ustawieniem historii czatu, które powoduje konflikt.
Więcej informacji znajdziesz w Centrum pomocy dla administratorów Google Workspace w artykule Kiedy użytkownicy mogą zostać wykluczeni z pokoi.
Rozwiązywanie problemów z zaawansowaną usługą Google Chat w Google Apps Script
Zapoznaj się ze stroną Apps Script dotyczącą zaawansowanej usługi Google Chat.
Użytkownicy nie mogą dodać aplikacji Google Chat do pokoju
Jeśli podczas próby dodania aplikacji Google Chat do pokoju użytkownicy zobaczą komunikat o błędzie
This organization's administrator must allow users to install this Chat app, przyczyną może być jedna z tych sytuacji:
- 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, przyczyną może być to, ż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 Google Chat.
Administrator musi przyznać aplikacji wymagany zakres autoryzacji OAuth dla tej czynności
Podczas uwierzytelniania jako aplikacja Google Chat, 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 przyznał 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 zgody na używanie aplikacji Google Chat.
Podczas obsługi tego błędu w logice aplikacji Google Chat
rozważ wysłanie komunikatu informującego, że
aplikacja Google Chat potrzebuje zgody 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 Chat API obsługuje zakres autoryzacji
https://www.googleapis.com/auth/chat.bot, który nie wymaga zgody administratora, rozważ użycie go. Aby sprawdzić, które zakresy autoryzacji obsługuje dana metoda, przeczytaj artykuł Uwierzytelnianie i autoryzacja aplikacji Google Chat oraz żądań do interfejsu Google Chat API.
Rozwiązywanie problemów z funkcjami w Cloud Functions
Jeśli aplikacja Google Chat 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
Na początek sprawdź logi Cloud Functions pod kątem błędów.
W Konsoli interfejsów API Google otwórz stronę Cloud Functions:
Aby otworzyć logi, znajdź funkcję w Cloud Functions aplikacji Google Chat, a następnie kliknij Pokaż działania > Wyświetl logi.
Otworzy się eksplorator logów i uruchomi zapytanie wyświetlające logi Cloud Functions, w tym błędy.
Jeśli domyślne informacje rejestrowane w logach nie wystarczą do debugowania aplikacji, możesz dodać dodatkowe logowanie z kodu funkcji w Cloud Functions. Przeczytaj artykuł Wyświetlanie i zapisywanie logów funkcji w Cloud Functions .
Sprawdzanie błędów funkcji w Cloud Functions
Oprócz logów funkcja w Cloud Functions może też zgłaszać błędy, które wystąpiły podczas jej działania.
W Konsoli interfejsów API Google otwórz stronę Cloud Functions:
Kliknij funkcję w Cloud Functions aplikacji Google Chat.
Na stronie ze szczegółami funkcji błędy są wymienione w sekcji Błędy.
Aby rozwiązać problem, kliknij błąd.
Poprawianie najczęstszych błędów funkcji w Cloud Functions
Podczas tworzenia aplikacji Google Chat 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 w Cloud Functions ma taką samą nazwę jak wdrażana funkcja. Zmień nazwę i ponownie wdróż funkcję. Sprawdź, czy aplikacja Google Chat używa adresu URL aktywatora funkcji w Cloud Functions, a nie adresu URL aktywatora istniejącej 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 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 zobaczysz ten błąd, a następnie wyślesz wiadomość do aplikacji
Google Chat, pojawi się błąd informujący, ż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ływania funkcji w Cloud Functions.
Przyznanie użytkownikowi „allUsers” roli „Wywołujący funkcje Cloud Functions” oznacza, że funkcja w Cloud Functions, która obsługuje aplikację, jest publicznie dostępna i można z niej korzystać bez uwierzytelniania. Więcej informacji o przypisywaniu ról znajdziesz w artykule
Przyznawanie pojedynczej roli.
Ten błąd może oznaczać, że projekt Google Cloud jest ograniczony do domeny. Więcej informacji o ograniczeniach domeny znajdziesz w artykule Ograniczanie dostępu tożsamości według domeny.
Aby rozwiązać ten problem, sprawdź, czy funkcja w Cloud Functions zezwala na nieuwierzytelnione wywołania. Więcej informacji o zezwalaniu na nieuwierzytelnione wywołania w przypadku istniejącej funkcji w Cloud Functions znajdziesz w artykule Zezwalanie na dostęp publiczny (nieuwierzytelniony).