Utwórz aplikację Google Chat, do której możesz wysyłać wiadomości bezpośrednio i która odpowiada za pomocą powtarzania wiadomości.
Poniższy diagram przedstawia architekturę i wzorzec przesyłania wiadomości:
Na poprzednim diagramie użytkownik korzystający z aplikacji do obsługi czatu Apps Script otrzymuje następujące informacje:
- Użytkownik wysyła wiadomość do aplikacji Google Chat na czacie lub w pokoju czatu.
- Logika aplikacji do obsługi czatu wdrożona w Apps Script, która działa w Google Cloud, odbiera i przetwarza wiadomość.
- Opcjonalnie logika aplikacji Google Chat może zostać zintegrowana z usługami Google Workspace, takimi jak Kalendarz czy Arkusze, oraz innymi usługami Google, takimi jak Mapy Google czy YouTube.
- Logika aplikacji Google Chat wysyła odpowiedź z powrotem do tej usługi.
- Odpowiedź jest wyświetlana użytkownikowi.
Cele
- skonfigurować środowisko,
- Skonfiguruj skrypt.
- Opublikuj aplikację Google Chat.
- Przetestuj aplikację Google Chat.
Wymagania wstępne
- konto Google Workspace z dostępem do Google Chat.
- Projekt Google Cloud.
Konfigurowanie środowiska
Otwieranie projektu Cloud w konsoli Google Cloud
Jeśli nie jest jeszcze otwarty, otwórz projekt Cloud, którego chcesz użyć w tym przykładzie:
- W konsoli Google Cloud otwórz stronę Wybierz projekt.
- Wybierz projekt Google Cloud, którego chcesz użyć. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli utworzysz projekt Google Cloud, może być konieczne włączenie dla niego płatności.
Włączanie interfejsu Chat API
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 Google Chat API.
Konfigurowanie ekranu zgody OAuth
Wszystkie aplikacje korzystające z protokołu OAuth 2.0 wymagają konfiguracji ekranu zgody. Skonfigurowanie ekranu zgody OAuth w Twojej aplikacji określa, co jest widoczne dla użytkowników i weryfikatorów, oraz powoduje zarejestrowanie aplikacji, dzięki czemu możesz ją później opublikować.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran akceptacji OAuth.
- W polu Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a następnie kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez Twoją aplikację.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda na prawidłową, kliknij Back to Dashboard (Powrót do panelu).
Konfigurowanie skryptu
Aby skonfigurować skrypt, użyj szablonu, a następnie ustaw swój projekt Cloud w Apps Script.
Tworzenie skryptu na podstawie szablonu
- Otwórz stronę Apps Script Pierwsze kroki.
- Kliknij szablon Aplikacja do obsługi czatu. Aby go zobaczyć, konieczne może być przewinięcie strony.
- Kliknij Projekt bez nazwy, wpisz
Quickstart app
i kliknij Zmień nazwę.
Kopiowanie numeru projektu Cloud
- W konsoli Google Cloud kliknij Menu > Administracja > Ustawienia.
- Skopiuj wartość z pola Numer projektu.
Ustawianie projektu Cloud dla projektu Apps Script
- W projekcie Apps Script aplikacji Google Chat kliknij Ustawienia projektu .
- W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
- W polu Numer projektu GCP wklej numer projektu Google Cloud.
- Kliknij Ustaw projekt.
Masz już działający kod aplikacji, który możesz wypróbować (zgodnie z opisem w kolejnych krokach), a potem dostosować go do swoich potrzeb.
Pamiętaj, aby otworzyć szablon Apps Script i zalogować się na właściwe konto Google. Bieżące konto może czasem przełączyć się na konto domyślne, nawet jeśli tego nie wiesz.
Tworzenie wdrożenia testowego
Potrzebujesz identyfikatora wdrożenia dla tego projektu Apps Script, którego użyjesz w następnym kroku.
Aby uzyskać identyfikator wdrożenia głównego, wykonaj te czynności:
- W projekcie Apps Script aplikacji Google Chat kliknij Wdróż > Testuj wdrożenia.
- Skopiuj Identyfikator wdrożenia nagłówka do użycia w późniejszym kroku i kliknij Gotowe.
Publikowanie aplikacji Google Chat
Opublikuj aplikację Google Chat w konsoli Google Cloud.
- W konsoli Google Cloud wyszukaj
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 Avatar URL (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 i Dołączanie do pokoi i rozmów grupowych.
- W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
- W polu Identyfikator wdrożenia wklej wcześniej skopiowany identyfikator wdrożenia z nagłówka.
- W sekcji Widoczność wybierz Określone osoby i grupy w Twojej domenie i wpisz adres e-mail.
- W polu Nazwa aplikacji wpisz
Kliknij Zapisz.
Aplikacja Google Chat jest gotowa do odpowiadania na wiadomości.
Testowanie aplikacji Google Chat
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.
W nowym czacie z aplikacją wpisz
Hello
i naciśnijenter
.Aplikacja Google Chat podziękuje za jej dodanie i ponowi wiadomość.
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.
Dalsze kroki
- Twórz karty interaktywne – komunikaty karty obsługują zdefiniowany układ, interaktywne elementy interfejsu (np. przyciski) i multimedia (np. obrazy). Korzystaj z kart, aby przedstawiać szczegółowe informacje, zbierać informacje od użytkowników i zachęcać ich do wykonania kolejnych kroków.
- Obsługa poleceń po ukośniku – polecenia po ukośniku pozwalają rejestrować i reklamować określone polecenia, które użytkownicy mogą wydawać aplikacji przez wpisanie polecenia zaczynającego się od ukośnika (
/
), np./help
. - Okna uruchamiania – są to okna, które oparte na kartach interfejsu mogą otwierać aplikację, aby nawiązać kontakt z użytkownikiem. Kilka kart można układać obok siebie, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie danych formularza.
- Tworzenie aplikacji na potrzeby Google Chat przy użyciu Gemini. Ćwiczenie z programowania: chcesz utworzyć bardziej zaawansowaną aplikację Google Chat? Zapoznaj się z opinią Aplikacja Google Chat z ćwiczeń z programowania