Na tej stronie dowiesz się, jak utworzyć aplikację czatu HTTP. Istnieją różne sposoby wdrażania tej architektury. W Google Cloud możesz używać Cloud Functions, Cloud Run i App Engine. W tym krótkim wprowadzeniu napiszesz i wdrożysz funkcję w Cloud Functions, której aplikacja Google Chat używa do odpowiadania na wiadomość użytkownika.
W tej architekturze konfigurujesz Google Chat do integracji z Google Cloud lub serwerem lokalnym przy użyciu HTTP, jak na tym schemacie:
Na poprzednim diagramie użytkownik korzystający z aplikacji do obsługi czatu HTTP przekazuje takie informacje:
- Użytkownik wysyła wiadomość w Google Chat do aplikacji Google Chat na czacie lub w pokoju czatu.
- Żądanie HTTP jest wysyłane do serwera WWW, który działa w chmurze lub systemie lokalnym, zawierającym logikę aplikacji Google Chat.
- Opcjonalnie logika aplikacji Google Chat może zostać zintegrowana z usługami Google Workspace (takimi jak Kalendarz i Arkusze), innymi usługami Google (takimi jak Mapy, YouTube czy Vertex AI) oraz innymi usługami internetowymi (takimi jak system zarządzania projektami czy narzędzie do sprzedaży biletów).
- Serwer WWW wysyła odpowiedź HTTP z powrotem do usługi aplikacji Google Chat w Google Chat.
- Odpowiedź jest wyświetlana użytkownikowi.
- Opcjonalnie aplikacja do obsługi czatu może wywoływać interfejs Chat API, aby asynchronicznie publikować wiadomości lub wykonywać inne operacje.
Ta architektura pozwala korzystać z istniejących bibliotek i komponentów, które już istnieją w Twoim systemie, ponieważ te aplikacje do obsługi czatu można projektować w różnych językach programowania.
Cele
- skonfigurować środowisko,
- utworzyć i wdrożyć funkcję w Cloud Functions;
- Opublikuj aplikację w Google Chat.
- przetestować aplikację,
Wymagania wstępne
- Konto Google Workspace z dostępem do Google Chat w organizacji Google Workspace, które zezwala na nieuwierzytelnione wywołania funkcji Google Cloud Functions.
- Projekt Google Cloud.
- Sprawdź, czy masz włączone płatności w projekcie Cloud. Dowiedz się, jak sprawdzić stan rozliczeń projektów.
Konfigurowanie środowiska
Zanim zaczniesz korzystać z interfejsów API Google, musisz włączyć je w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.W konsoli Google Cloud włącz interfejsy Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API i Cloud Run API.
Utwórz i wdróż funkcję w Cloud Functions
Utwórz i wdróż funkcję w Cloud Functions, która generuje kartę czatu z wyświetlaną nazwą nadawcy i obrazem awatara. Gdy aplikacja Google Chat otrzyma wiadomość, uruchamia funkcję i odpowiada za pomocą karty.
Aby utworzyć i wdrożyć funkcję dla swojej aplikacji do obsługi czatu, wykonaj te czynności:
Node.js
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy projekt aplikacji do obsługi czatu jest wybrany.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W sekcji Środowisko wybierz 2 generacji.
- W polu Nazwa funkcji wpisz
QuickStartChatApp
. - W sekcji Region wybierz region.
- W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
- Kliknij Dalej.
W sekcji Środowisko wykonawcze wybierz Node.js 20.
W sekcji Kod źródłowy wybierz Edytor wbudowany.
W sekcji Punkt wejścia usuń domyślny tekst i wpisz
helloChat
.Zastąp zawartość pliku
index.js
tym kodem:Kliknij Wdróż.
Python
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy projekt aplikacji do obsługi czatu jest wybrany.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz
QuickStartChatApp
. - W sekcji Typ aktywatora kliknij HTTP.
- W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
- Kliknij Zapisz.
- Kliknij Dalej.
- W polu Nazwa funkcji wpisz
W sekcji Środowisko wykonawcze wybierz Python 3.10.
W sekcji Kod źródłowy wybierz Edytor wbudowany.
W sekcji Punkt wejścia usuń domyślny tekst i wpisz
hello_chat
.Zastąp zawartość pliku
main.py
tym kodem:Kliknij Wdróż.
Java
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy projekt aplikacji do obsługi czatu jest wybrany.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz
QuickStartChatApp
. - W sekcji Typ aktywatora kliknij HTTP.
- W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
- Kliknij Zapisz.
- Kliknij Dalej.
- W polu Nazwa funkcji wpisz
W sekcji Środowisko wykonawcze wybierz Java 11.
W sekcji Kod źródłowy wybierz Edytor wbudowany.
W sekcji Punkt wejścia usuń domyślny tekst i wpisz
HelloChat
.Zmień nazwę
src/main/java/com/example/Example.java
nasrc/main/java/HelloChat.java
.Zastąp zawartość pliku
HelloChat.java
tym kodem:Zastąp zawartość pliku
pom.xml
tym kodem:Kliknij Wdróż.
Otworzy się strona z informacjami w Cloud Functions, a Twoja funkcja będzie zawierać 2 wskaźniki postępu: jeden dla kompilacji, a drugi dla usługi. Gdy oba wskaźniki postępu znikną i zostaną zastąpione znacznikiem wyboru, funkcja zostanie wdrożona i gotowa do użycia.
Publikowanie aplikacji w Google Chat
Po wdrożeniu funkcji w Cloud Functions wykonaj te czynności, aby przekształcić ją w aplikację Google Chat:
W konsoli Google Cloud kliknij Menu > Cloud Functions.
Sprawdź, czy został wybrany projekt, w którym włączono Cloud Functions.
Na liście funkcji kliknij QuickStartChatApp.
Kliknij kartę Reguły.
W polu HTTPS skopiuj adres URL.
Wyszukaj „Google Chat API” i kliknij Google Chat API, a następnie kliknij Zarządzaj.
Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:
- W polu Nazwa aplikacji wpisz
Quickstart App
. - W polu Avatar URL wpisz
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - W polu Opis wpisz
Quickstart app
. - W sekcji Funkcjonalność wybierz Odbieranie wiadomości 1:1 i Dołączanie do pokoi i rozmów grupowych.
- W sekcji Ustawienia połączenia wybierz URL aplikacji i wklej w polu adres URL aktywatora funkcji w Cloud Functions.
- W sekcji Widoczność wybierz Udostępnij tę aplikację Google Chat określonym osobom i grupom w Twojej domenie i wpisz swój adres e-mail.
- W sekcji Logi wybierz Rejestruj błędy w usłudze Logging.
- W polu Nazwa aplikacji wpisz
Kliknij Zapisz.
Aplikacja Google Chat jest gotowa do odbierania wiadomości i odpowiadania na nie.
Testowanie aplikacji do obsługi czatu
Aby przetestować aplikację Google Chat, otwórz pokój czatu w aplikacji Google Chat i wyślij wiadomość:
Otwórz Google Chat na koncie Google Workspace podanym podczas dodawania siebie jako zaufanego testera.
- Kliknij Nowy czat.
- W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji do obsługi czatu.
W wynikach wybierz swoją aplikację do obsługi czatu. Otworzy się czat.
- Na nowym czacie z aplikacją wpisz
Hello
i naciśnijenter
.
Odpowiedź aplikacji do obsługi czatu zawiera wiadomość na karcie zawierająca imię i nazwisko nadawcy oraz jego awatar, jak widać na tym obrazie:
Aby dodać zaufanych testerów i dowiedzieć się więcej o testowaniu funkcji interaktywnych, przeczytaj artykuł Testowanie funkcji interaktywnych w aplikacjach Google Chat.
Rozwiązywanie problemów
Gdy aplikacja lub karta Google Chat zwróci błąd, w interfejsie Google Chat pojawi się komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami w interfejsie Google Chat nie pojawia się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik, na przykład komunikat na karcie może się nie pojawić.
Mimo że komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci naprawić błędy występujące po włączeniu logowania błędów w aplikacjach Google Chat. Informacje o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat i ich naprawianie.
Czyszczenie danych
Aby uniknąć obciążenia konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu Cloud.
- W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Administracja > Zarządzaj zasobami.
- Na liście projektów wybierz projekt, który chcesz usunąć, a następnie kliknij Usuń .
- W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.
Powiązane artykuły
Aby dodać więcej funkcji do aplikacji Google Chat, zobacz: