Tworzenie aplikacji Google Chat za pomocą Google Apps Script

Utwórz aplikację Google Chat, do której możesz wysyłać wiadomości bezpośrednio. odpowiada, powtarzając Twoje wiadomości.

Na diagramie poniżej widać architekturę i wzorzec komunikacji:

Architektura aplikacji do obsługi czatu wdrożonej za pomocą Apps Script.

Na poprzednim diagramie użytkownik korzystający z języka Apps Script W aplikacji Google Chat przepływ informacji jest następujący:

  1. użytkownik wysyła wiadomość do aplikacji Google Chat w na czacie lub w pokoju czatu.
  2. Logika aplikacji Google Chat zaimplementowana w Działająca w Google Cloud aplikacja Apps Script otrzymuje i przetworzy wiadomość.
  3. Opcjonalnie logika aplikacji Google Chat może zostać zintegrowana z usług Google Workspace, takich jak Kalendarz czy Arkuszy lub innych usług Google, takich jak Mapy Google. lub YouTube.
  4. Logika aplikacji Google Chat wysyła odpowiedź do Usługa aplikacji Google Chat w Google Chat.
  5. Odpowiedź jest dostarczana do użytkownika.

Cele

  • skonfigurować środowisko,
  • Skonfiguruj skrypt.
  • Opublikuj aplikację Google Chat.
  • Przetestuj aplikację Google Chat.

Wymagania wstępne

Konfigurowanie środowiska

Otwieranie projektu Cloud w konsoli Google Cloud

Jeśli projekt Cloud nie jest jeszcze otwarty, otwórz go, którego chcesz używać. dla tego przykładu:

  1. W konsoli Google Cloud otwórz stronę Wybierz projekt.

    Wybierz projekt Cloud

  2. 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.

Wszystkie aplikacje korzystające z protokołu OAuth 2.0 wymagają konfiguracji ekranu zgody. Konfiguruję ekran zgody OAuth aplikacji określa, co jest wyświetlane użytkownikom i aplikacji sprawdza aplikację i zarejestruje ją, aby można było ją później opublikować.

  1. W konsoli Google Cloud otwórz menu . > Interfejsy API i Usługi > Ekran zgody OAuth.

    Otwórz ekran zgody OAuth

  2. Jako Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
  3. Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.
  4. Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. w przyszłości, gdy utworzysz aplikację do użytku poza swoim Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie: dodaj zakresy autoryzacji wymagane przez aplikację.

  5. Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli aplikacja z rejestracji wszystko jest w porządku, kliknij Back to Dashboard (Powrót do panelu).

Konfigurowanie skryptu

Aby skonfigurować skrypt, użyj szablonu, a następnie ustaw Projekt Google Cloud w Apps Script.

Tworzenie skryptu na podstawie szablonu

  1. Przejdź do Strona Apps Script Wprowadzenie.
  2. Kliknij szablon Aplikacja Google Chat. Może być konieczne przewinięcie strony w dół aby zobaczyć ten szablon.
  3. Kliknij Projekt bez nazwy, wpisz Quickstart app i kliknij Zmień nazwę.

Kopiuj numer projektu Cloud

  1. W konsoli Google Cloud otwórz menu . > Administracja Administracja > Ustawienia.

    Otwórz stronę Uprawnienia Ustawienia administratora

  2. Skopiuj wartość z pola Numer projektu.

Ustawianie projektu Cloud w projekcie Apps Script

  1. W projekcie Apps Script w aplikacji Google Chat kliknij Ustawienia projektu Ikona ustawień projektu.
  2. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
  3. W polu Numer projektu GCP wklej numer projektu Google Cloud.
  4. Kliknij Set project (Ustaw projekt).

Masz teraz działający kod aplikacji, który możesz wypróbować (jak opisano w tych czynności), a następnie dostosuj go do swoich wymagań.

Po otwarciu Szablon Apps Script. Bieżące konto może czasami zostać przełączone na konto domyślne.

Tworzenie wdrożenia testowego

Musisz mieć identyfikator wdrożenia dla tego projektu Apps Script, Możesz go użyć w następnym kroku.

Aby uzyskać identyfikator wdrożenia głównego:

  1. W projekcie Apps Script w aplikacji Google Chat kliknij Wdróż. > Testuj wdrożenia.
  2. 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.

  1. W Google Cloud Console, wyszukaj Google Chat API i kliknij Google Chat API.
  2. Kliknij Zarządzaj.
  3. Kliknij Konfiguracja i skonfiguruj aplikację Google Chat:

    1. W polu Nazwa aplikacji wpisz Quickstart app.
    2. W polu URL awatara wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. W polu Opis wpisz Quickstart app.
    4. W sekcji Funkcje wybierz Odbieraj wiadomości 1:1. Dołączanie do pokoi i rozmów grupowych
    5. W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
    6. W polu Deployment ID (Identyfikator wdrożenia) wklej skopiowany wcześniej identyfikator wdrożenia z nagłówka. poprzednio skopiowanych.
    7. W sekcji Widoczność wybierz Określone osoby i grupy domeny i wpisz swój adres e-mail.
  4. 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 z aplikację Google Chat i wyślij wiadomość:

  1. Otwórz Google Chat za pomocą konta Google Workspace, którego używasz dodane podczas dodawania siebie jako zaufanego testera.

    Otwórz Google Chat

  2. Kliknij Nowy czat.
  3. W polu Dodaj co najmniej jedną osobę wpisz nazwę swojego aplikacja Google Chat.
  4. Z wyników wybierz aplikację Google Chat. A Direct

  5. W nowym czacie z aplikacją wpisz Hello i naciśnij enter.

    Dziękujemy za dodanie aplikacji Google Chat i echa wiadomość.

Aby dodać zaufanych testerów i dowiedzieć się więcej o testowaniu funkcji interaktywnych, zobacz Przetestuj funkcje interaktywne w aplikacji Aplikacje Google Chat.

Rozwiązywanie problemów

Gdy aplikacja Google Chat lub card zwraca błąd, Interfejs czatu wyświetla komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami interfejs Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja Google Chat lub zwraca nieoczekiwany wynik; na przykład wiadomość w formie karty .

Komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w naprawianiu błędów gdy logowanie błędów aplikacji Google Chat jest włączone. Aby uzyskać pomoc w wyświetlaniu, debugowania i naprawiania błędów, zapoznaj się z artykułem Rozwiązywanie problemów z błędami w Google Chat

Czyszczenie danych

Aby uniknąć obciążenia konta Google Cloud opłatami za używanych w tym samouczku, zalecamy usunięcie Projekt w chmurze.

  1. W konsoli Google Cloud otwórz stronę Zarządzanie zasobami. Kliknij Menu > Uprawnienia Administracja > Zarządzaj zasobami.

    Otwórz menedżera zasobów

  2. Na liście projektów wybierz projekt do usunięcia, a następnie kliknij Usuń .
  3. W oknie wpisz identyfikator projektu i kliknij Wyłącz, aby go usunąć. nad projektem.

Dalsze kroki

  • Utwórz karty interaktywne – karta mają zdefiniowany układ i interaktywne elementy interfejsu, takie jak przyciski; multimediów, takich jak obrazy. Szczegółowe informacje możesz przedstawić na kartce. zbierają informacje od użytkowników i pomagają im wykonać kolejny krok.
  • Obsługa poleceń po ukośniku – polecenia po ukośniku pozwalają rejestrujesz i reklamujesz konkretne polecenia dostępne dla aplikacji, wpisując polecenie rozpoczynające się od ukośnika (/), np. /help.
  • Okna uruchamiania – są wyświetlane w oknach i wyświetlają się na kartach. interfejsy, które aplikacja może otwierać, aby wchodzić w interakcję z użytkownikiem. Wiele kart mogą być układane sekwencyjnie, co ułatwia użytkownikom takich jak uzupełnianie danych w formularzach.
  • Ćwiczenia z programowania: możesz tworzyć bardziej zaawansowane aplikacje. Aplikacja Google Chat? Zobacz opinie Aplikacja do obsługi czatu z ćwiczenia z programowania Tworzenie aplikacji na potrzeby Google Chat za pomocą Gemini