Z tego artykułu dowiesz się, jak utworzyć aplikację w Google Chat i korzystać z niej za pomocą Google Cloud Functions.
Aby utworzyć aplikację do obsługi czatu, napisz i wdróż funkcję w Cloud Functions, za pomocą której aplikacja do obsługi czatu odpowiada na wiadomość użytkownika. Odpowiedź aplikacji do obsługi czatu zawiera wiadomość z kartą zawierającą imię i nazwisko nadawcy oraz obraz awatara, jak na tym obrazie:
Cele
- skonfigurować środowisko,
- tworzenie i wdrażanie funkcji 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. Możesz włączyć 1 lub więcej interfejsów API w pojedynczym projekcie Google Cloud.W konsoli Google Cloud włącz interfejsy Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API oraz Cloud Logging API.
Tworzenie i wdrażanie funkcji w Cloud Functions
utworzyć i wdrożyć 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 aplikacji do obsługi czatu, wykonaj te czynności:
Node.js
W konsoli Google Cloud otwórz stronę Cloud Functions:
Wybierz projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W sekcji Typ reguły kliknij HTTP.
W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
Więcej informacji o uwierzytelnianiu w Google Workspace znajdziesz w artykule Uwierzytelnianie i autoryzowanie aplikacji do obsługi czatu oraz żądań do interfejsu API.
Kliknij Zapisz.
Kliknij Dalej.
W sekcji Środowisko wykonawcze wybierz Node.js 10.
W sekcji Kod źródłowy wybierz Edytor wbudowany.
W sekcji Punkt wejścia usuń domyślny tekst i wpisz
helloChat
.Zamień zawartość pliku
index.js
na ten kod:Kliknij Wdróż.
Python
W konsoli Google Cloud otwórz stronę Cloud Functions:
Wybierz projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W sekcji Typ reguły kliknij HTTP.
W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
Więcej informacji o uwierzytelnianiu w Google Workspace znajdziesz w artykule Uwierzytelnianie i autoryzowanie aplikacji do obsługi czatu oraz żądań do interfejsu API.
Kliknij Zapisz.
Kliknij Dalej.
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
.Zamień zawartość pliku
main.py
na ten kod:Kliknij Wdróż.
Java
W konsoli Google Cloud otwórz stronę Cloud Functions:
Wybierz projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W sekcji Typ reguły kliknij HTTP.
W sekcji Uwierzytelnianie wybierz Zezwalaj na nieuwierzytelnione wywołania.
Więcej informacji o uwierzytelnianiu w Google Workspace znajdziesz w artykule Uwierzytelnianie i autoryzowanie żądań aplikacji do obsługi czatu oraz żądań do interfejsu API.
Kliknij Zapisz.
Kliknij Dalej.
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
.Zamień zawartość pliku
HelloChat.java
na ten kod:Zamień zawartość pliku
pom.xml
na ten kod:Kliknij Wdróż.
Otworzy się strona Cloud Functions, a obok jej nazwy pojawi się wskaźnik postępu wdrożenia. Gdy wskaźnik postępu zniknie i pojawi się znacznik wyboru, funkcja zostanie wdrożona.
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 wybrany jest projekt, w którym włączono Cloud Functions.
Na liście funkcji kliknij QuickStartChatApp.
Na stronie Szczegóły funkcji kliknij Wyzwalacz.
W sekcji URL reguły 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 Awatar URL wpisz
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - W polu Opis wpisz
Quickstart app
. - W sekcji Funkcje wybierz Odbieraj wiadomości 1:1, Dołączaj do pokoi i rozmów grupowych i Rejestruj błędy w Cloud Logging.
- W sekcji Ustawienia połączenia wybierz URL aplikacji i wklej w polu adres URL aktywatora funkcji w Cloud Functions.
- W sekcji Uprawnienia wybierz Określone osoby i grupy w Twojej domenie i wpisz swój adres e-mail.
- W polu Nazwa aplikacji wpisz
Kliknij Zapisz.
Aplikacja jest gotowa do odbierania wiadomości w Google Chat i odpowiadania na nie.
Testowanie aplikacji do obsługi czatu
Aby przetestować aplikację Google Chat, wyślij do niej wiadomość na czacie:
- Otwórz Google Chat.
- Aby wysłać wiadomość na czacie do aplikacji, kliknij Rozpocznij czat , a następnie w wyświetlonym oknie kliknij Znajdź aplikacje.
- W oknie Znajdź aplikacje wyszukaj „Aplikacja Quickstart”.
- Aby otworzyć czat z aplikacją, znajdź aplikację z krótkim wprowadzeniem i kliknij Dodaj > Czat.
- Na czacie wpisz
Hello
i naciśnijenter
.
Aplikacja wyświetli kartę z Twoją wyświetlaną nazwą i zdjęciem awatara.
Rozwiązywanie problemów
Aby dowiedzieć się, jak rozwiązywać problemy z aplikacją Google Chat i je debugować, przeczytaj artykuł Rozwiązywanie problemów z aplikacją Google Chat i jej naprawianie.
Powiązane artykuły
Aby dodać więcej funkcji do aplikacji do obsługi czatu, zapoznaj się z tymi przewodnikami:
- Twórz karty interaktywne – wiadomości kart mogą mieć zdefiniowany układ, interaktywne elementy interfejsu (np. przyciski) i multimedia (np. obrazy). Komunikaty kart służą do prezentowania szczegółowych informacji, zbierania informacji od użytkowników i zachęcania ich do wykonania kolejnych kroków.
- Obsługa poleceń rozpoczynających się ukośnikiem – polecenia po ukośniku pozwalają rejestrować i reklamować konkretne polecenia, które użytkownicy mogą wydać aplikacji, wpisując polecenie rozpoczynające się od ukośnika (
/
), np./help
. - Okna uruchamiania – są to okna oparte na kartach, które aplikacja może otworzyć, aby wchodzić w interakcję z użytkownikiem. Możesz układać kilka kart obok siebie, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie danych w formularzu.
Więcej informacji o Google Chat API znajdziesz w dokumentacji referencyjnej.