Rozwiązywanie problemów z aplikacją Google Chat i rozwiązywanie problemów

W tej sekcji opisujemy typowe problemy, które mogą wystąpić podczas tworzenia i testowania aplikacji do obsługi czatu.

Karta z wiadomością, okno lub podgląd linku nie renderują się lub nie działają 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 do Google Chat i otrzymasz odpowiedź „Aplikacja nie odpowiada”, sprawdź konfigurację aplikacji do Google Chat:

1. W konsoli interfejsów API Google kliknij Menu menu > Interfejsy API i usługi > Włączone interfejsy API i usługi > Google Chat API > Konfiguracja.

   Otwórz konfigurację interfejsu Chat API

2. W sekcji Funkcje interaktywne sprawdź, czy ustawienia są odpowiednie dla funkcji Twojej aplikacji. Jeśli aplikacja do Google Chat wchodzi w interakcje z użytkownikami, włącz opcję Włącz funkcje interaktywne:

   1. Domyślnie aplikacje mogą odpowiadać na czaty od użytkowników.
   2. Jeśli aplikacja odpowiada na wiadomości w pokojach i czatach grupowych, wybierz Dołączanie do pokoi i rozmów grupowych.
   3. W sekcji Ustawienia połączenia upewnij się, że architektura i wyzwalacze (np. adres URL punktu końcowego HTTP, identyfikator wdrożenia i nazwa funkcji projektu Apps Script, nazwa tematu Cloud Pub/Sub lub agent Dialogflow) są prawidłowo skonfigurowane i że aplikacja jest wdrożona.
   4. 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ż ustawienia Google Workspace Marketplace mają wyższy priorytet.

3. Jeśli aplikacja jest opublikowana za pomocą pakietu SDK Google Workspace Marketplace, sprawdź ustawienia Google Workspace Marketplace.

4. Kliknij Zapisz.

5. 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, którego używasz do konfigurowania interfejsu Chat API, nie należy do organizacji korzystającej z Google Workspace. Aby utworzyć aplikację Google Chat lub korzystać z interfejsu Chat API, musisz używać konta Google Workspace.

Pamiętaj, że użytkownicy Google Chat mogą korzystać z aplikacji do Google 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 takiej sytuacji i w innych przypadkach, 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 konfliktowym ustawieniem historii czatu.

Więcej informacji znajdziesz w artykule Kiedy użytkownicy mogą zostać wykluczeni z pokoi w Centrum pomocy Administratora 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 Google Chat do pokoju użytkownicy zobaczą komunikat o błędzie This 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 Google Chat.
• Organizacja nie dodała tej konkretnej aplikacji do Google Chat do listy dozwolonych.

Jeśli użytkownik zobaczy ten komunikat o błędzie podczas próby interakcji z aplikacją do obsługi czatu, może to być spowodowane przyznaniem przez organizację dostępu do podrzędnej jednostki organizacyjnej bez włączania go w nadrzędnej jednostce organizacyjnej.

Informacje o tym, jak rozwiązać ten problem, znajdziesz w artykule Zezwalanie użytkownikom na instalowanie aplikacji w Google Chat.

Aby wykonać to działanie, administrator musi przyznać aplikacji wymagany zakres autoryzacji OAuth.

Podczas uwierzytelniania jako aplikacja do obsługi czatu możesz otrzymać 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ę do czatu 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 obsługi 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

Na początek sprawdź logi Cloud Functions pod kątem błędów.

1. W Konsoli interfejsów API Google otwórz stronę Cloud Functions:

   Otwórz Cloud Functions

2. Aby otworzyć logi, znajdź funkcję Cloud Function aplikacji do Google Chat, a następnie kliknij Pokaż działania more_vert > 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. Więcej informacji znajdziesz w artykule Wyświetlanie i zapisywanie logó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 napotkane podczas działania.

1. W Konsoli interfejsów API Google otwórz stronę Cloud Functions:

   Otwórz Cloud Functions

2. Kliknij funkcję Cloud Function aplikacji do obsługi czatu.

3. Na stronie z informacjami o funkcji błędy są wymienione w sekcji Błędy.

4. Aby dalej rozwiązywać problem, kliknij błąd.

Poprawianie najczęstszych błędów funkcji w Cloud Functions

Podczas tworzenia aplikacji do obsługi 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 Functions 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 w Cloud Functions, a nie adresu URL aktywatora istniejącej funkcji w Cloud Functions.

Co najmniej jedna nazwa użytkownika wymieniona 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 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ę Cloud Function. Ten komunikat oznacza, że użytkownik o nazwie „allUsers” nie ma uprawnień do wywoływania funkcji Cloud Function. Przyznanie użytkownikowi „allUsers” roli „Wywołujący funkcje Cloud Functions” 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 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 sekcji 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 w Cloud Functions, przeczytaj artykuł Zezwalanie na publiczny (nieuwierzytelniony) dostęp.