Utwórz aplikację Google Chat, do której możesz wysyłać wiadomości bezpośrednio i która odpowiada przez powtórzenie Twoich wiadomości.
Na diagramie poniżej widać architekturę i wzorzec komunikacji:
Na poprzednim diagramie użytkownik wchodzący w interakcję z aplikacją Google Chat w języku Apps Script ma następujący przepływ informacji:
- Użytkownik wysyła wiadomość do aplikacji Google Chat (bezpośrednio lub w pokoju czatu).
- Logika aplikacji Google Chat zaimplementowana w Apps Script w Google Cloud odbiera i przetwarza wiadomość.
- Opcjonalnie logika aplikacji Google Chat może integrować się z usługami Google Workspace, takimi jak Kalendarz lub Arkusze, albo innymi usługami Google, takimi jak Mapy Google czy YouTube.
- Logika aplikacji Google Chat wysyła odpowiedź do usługi aplikacji Google Chat w Google Chat.
- Odpowiedź jest dostarczana do użytkownika.
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 projekt nie jest jeszcze otwarty, otwórz go, którego zamierzasz 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 tworzysz projekt Google Cloud, konieczne może być włączenie dla niego płatności.
Włączanie interfejsu Chat API
Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć 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 interfejs 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 aplikacji określa, co jest wyświetlane użytkownikom i weryfikatorom, a także rejestruje aplikację, aby można było ją później opublikować.
- W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran zgody OAuth.
- Jako Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
- Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. W przyszłości, gdy utworzysz aplikację do użytku poza swoją organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez aplikację.
- Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Wróć do panelu.
Konfigurowanie skryptu
Aby skonfigurować skrypt, użyj szablonu, a następnie skonfiguruj projekt Google Cloud w Apps Script.
Tworzenie skryptu na podstawie szablonu
- Otwórz stronę Apps Script – pierwsze kroki.
- Kliknij szablon Aplikacja Google Chat. Aby zobaczyć ten szablon, może być konieczne przewinięcie strony w dół.
- Kliknij Projekt bez tytułu, wpisz
Quickstart app
i kliknij Zmień nazwę.
Kopiuj numer projektu Cloud
- W konsoli Google Cloud otwórz Menu > Administracja > Ustawienia.
- Skopiuj wartość z pola Numer projektu.
Ustawianie projektu Cloud w projekcie Apps Script
- W projekcie Apps Script w 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 Set project (Ustaw projekt).
Masz teraz działający kod aplikacji, który możesz wypróbować (w sposób opisany w poniższych krokach), a następnie dostosować do swoich wymagań.
Przed otwarciem szablonu Apps Script upewnij się, że korzystasz z odpowiedniego konta Google. Bieżące konto może czasem przełączyć się na domyślne bez Twojej wiedzy.
Tworzenie wdrożenia testowego
Potrzebujesz identyfikatora wdrożenia dla tego projektu Apps Script, aby móc go użyć w następnym kroku.
Aby uzyskać identyfikator wdrożenia głównego:
- W projekcie Apps Script w aplikacji Google Chat kliknij Wdróż > Testuj wdrożenia.
- Skopiuj identyfikator wdrożenia nagłówka, aby użyć go w późniejszym kroku, i kliknij Gotowe.
Publikowanie aplikacji Google Chat
Opublikuj aplikację Google Chat z poziomu 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 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 Deployment ID (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, a następnie wpisz swój 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 za pomocą konta Google Workspace podanego podczas dodawania Ciebie jako zaufanego testera.
- Kliknij Nowy czat.
- W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji Google Chat.
Z wyników wybierz aplikację Google Chat. Otworzy się czat.
W nowym czacie z aplikacją wpisz
Hello
i naciśnijenter
.Aplikacja Google Chat dziękuje za dodanie i powtarza Twoją 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 w 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 UI Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik, na przykład wiadomość na karcie.
Mimo że komunikat o błędzie może nie być wyświetlany w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane logów, które pomogą Ci w naprawianiu błędów, gdy logowanie błędów w aplikacjach Google Chat jest włączone. Informacje o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z błędami w Google Chat.
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 do usunięcia, a następnie kliknij Usuń .
- W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby usunąć projekt.
Dalsze kroki
- Utwórz karty interaktywne – wiadomości w formie kart obsługują zdefiniowany układ, interaktywne elementy interfejsu (np. przyciski) i multimedia, takie jak obrazy. Dzięki wiadomościom na karcie możesz prezentować szczegółowe informacje oraz zbierać informacje od użytkowników i pomagać im w wykonaniu kolejnych kroków.
- Obsługa poleceń po ukośniku – polecenia po ukośniku pozwalają rejestrować i reklamować konkretne polecenia, które użytkownicy mogą przekazać aplikacji przez wpisanie polecenia rozpoczynającego się od ukośnika (
/
), na przykład/help
. - Okna uruchamiania – to okna, które działają na podstawie kart i są dostępne w aplikacji, aby wchodzić w interakcję z użytkownikiem. Z kolei można połączyć kilka kart, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wpisywanie danych w formularzu.
- Tworzenie aplikacji na potrzeby Google Chat z użyciem Gemini. Ćwiczenie z programowania: Chcesz stworzyć bardziej zaawansowaną aplikację Google Chat? Zapoznaj się z opinią Aplikacja Google Chat omawiana w ramach ćwiczenia w Codelabs