Z tego artykułu dowiesz się, jak tworzyć aplikacje Google Chat i korzystać z nich w Google Cloud Functions.
Aby utworzyć aplikację, napisz i wdróż funkcję w Cloud Functions, która jest używana przez aplikację do przetwarzania odpowiedzi na zdarzenie z wiadomości w Google Chat. Odpowiedź to karta z nazwą i awatarem nadawcy, jak na tym obrazie:
Cele
- skonfigurować środowisko,
- utworzyć i wdrożyć funkcję w Cloud Functions;
- Opublikuj aplikację w Google Chat.
- Przetestuj aplikację.
Wymagania wstępne
- konto Google Workspace z dostępem do Google Chat,
- Projekt Google Cloud.
- Sprawdź, czy w projekcie Cloud są włączone płatności. Dowiedz się, jak zweryfikować 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ć jeden lub więcej interfejsów API.W konsoli Google Cloud włącz interfejsy Google Chat API, Cloud Build API, Cloud Functions API i Cloud Pub/Sub API.
Tworzenie i wdrażanie funkcji w Cloud Functions
Utwórz i wdróż funkcję w Cloud Functions, która wygeneruje kartę czatu z wyświetlaną nazwą i obrazem awatara nadawcy. Gdy aplikacja do obsługi czatu otrzymuje wiadomość, uruchamia funkcję i odpowiada kartą.
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:
Sprawdź, czy wybrany jest projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W polu Typ reguły wybierz 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 (w języku angielskim).
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ń tekst domyślny i wpisz
helloChat
.Zamień zawartość pliku
index.js
na ten kod:Kliknij Wdróż.
Python
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy wybrany jest projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W polu Typ reguły wybierz 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 (w języku angielskim).
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ń tekst domyślny i wpisz
hello_chat
.Zamień zawartość pliku
main.py
na ten kod:Kliknij Wdróż.
Java
W konsoli Google Cloud otwórz stronę Cloud Functions:
Sprawdź, czy wybrany jest projekt aplikacji do obsługi czatu.
Kliknij
Utwórz funkcję.Na stronie Utwórz funkcję skonfiguruj funkcję:
- W polu Nazwa funkcji wpisz „QuickStartChatApp”.
- W polu Typ reguły wybierz 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ń do aplikacji Google Chat i 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ń tekst domyślny i wpisz
HelloChat
.Zmień nazwę pliku
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 nazwy funkcji pojawi się wskaźnik postępu wdrażania. Gdy wskaźnik 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.
Wybierz projekt, w którym włączono Cloud Functions.
Na liście funkcji kliknij QuickStartChatApp.
Na stronie ze szczegółami funkcji kliknij Aktywator.
W sekcji URL aktywatora skopiuj adres URL.
Wyszukaj interfejs „Google Chat API” i kliknij Google Chat API.
Kliknij Zarządzaj.
Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:
- W polu Nazwa aplikacji wpisz
Quickstart App
. - W polu URL awatara wpisz
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - W polu Opis wpisz
Quickstart app
. - W sekcji Funkcje wybierz Odbieranie wiadomości 1:1, Dołączanie do pokoi i rozmów grupowych oraz Rejestruj błędy w Cloud Logging.
- W sekcji Ustawienia połączenia wybierz Adres URL aplikacji i wklej w polu adres URL aktywatora funkcji w Cloud Functions.
- W sekcji Uprawnienia wybierz Określone osoby i grupy w domenie i wpisz adres e-mail.
- W polu Nazwa aplikacji wpisz
Kliknij Zapisz.
Aplikacja jest gotowa do odbierania wiadomości i odpowiadania na nie w Google Chat.
Testowanie aplikacji Google Chat
Aby przetestować aplikację Google Chat, wyślij jej wiadomość na czacie:
- Otwórz Google Chat.
- Aby wysłać czat do aplikacji, kliknij Rozpocznij czat , a następnie w wyświetlonym oknie kliknij Znajdź aplikacje.
- W oknie Znajdź aplikacje wyszukaj „Quickstart app”.
- Aby otworzyć czat z aplikacją, znajdź aplikację Quickstart i kliknij Dodaj > Google Chat.
- Na czacie wpisz
Hello
i naciśnijenter
.
Aplikacja wyświetli kartę z wyświetlaną nazwą i zdjęciem awatara.
Dalsze kroki
Informacje o rozwiązywaniu problemów z aplikacją Google Chat i debugowaniu treści znajdziesz na tych stronach:
- Podczas tworzenia aplikacji do obsługi czatu może być konieczne jej debugowanie, ponieważ odczytywane są jej dzienniki błędów. Aby odczytać logi, w konsoli Google Cloud otwórz eksplorator logów.
- Rozwiąż problemy
Aby dodać więcej funkcji do aplikacji do obsługi czatu, skorzystaj z tych przewodników:
- Tworzenie kart interaktywnych – komunikaty kart obsługują zdefiniowany układ, interaktywne elementy interfejsu (np. przyciski) i multimedia (np. obrazy). Korzystaj z kart, aby prezentować szczegółowe informacje, gromadzić informacje od użytkowników i pomagać im w kolejnych krokach.
- Polecenia po ukośniku – polecenia po ukośniku umożliwiają rejestrowanie i reklamowanie konkretnych poleceń, które użytkownicy mogą przekazać aplikacji. Wystarczy, że wpiszesz polecenie rozpoczynające się ukośnikiem (
/
), np./help
. - Okna uruchamiania – okna są oparte na kartach i mogą służyć do interakcji użytkownika z aplikacją. Wiele kart może się układać po kolei, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie danych formularza.
Więcej informacji o Google Chat API znajdziesz w dokumentacji.