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 i która odpowiada za pomocą powtarzania wiadomości.

Poniższy diagram przedstawia architekturę i wzorzec przesyłania wiadomości:

Architektura aplikacji do obsługi czatu zaimplementowana za pomocą Apps Script.

Na poprzednim diagramie użytkownik korzystający z aplikacji do obsługi czatu Apps Script otrzymuje następujące informacje:

  1. Użytkownik wysyła wiadomość do aplikacji Google Chat na czacie lub w pokoju czatu.
  2. Logika aplikacji do obsługi czatu wdrożona w Apps Script, która działa w Google Cloud, odbiera i przetwarza wiadomość.
  3. 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.
  4. Logika aplikacji Google Chat wysyła odpowiedź z powrotem do tej usługi.
  5. Odpowiedź jest wyświetlana użytkownikowi.

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 nie jest jeszcze otwarty, otwórz projekt Cloud, którego chcesz użyć w tym przykładzie:

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

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

  1. W konsoli Google Cloud otwórz Menu > Interfejsy API i usługi > Ekran akceptacji OAuth.

    Otwórz ekran zgody OAuth

  2. Wybierz typ użytkownika aplikacji, a potem kliknij Utwórz.
  3. Wypełnij formularz rejestracji aplikacji, a następnie kliknij Zapisz i kontynuuj.
  4. 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 swoją organizacją Google Workspace, musisz dodać i zweryfikować zakresy autoryzacji wymagane przez tę aplikację.

  5. Jeśli jako typ użytkownika wybierzesz Zewnętrzny, dodaj użytkowników testowych:
    1. W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
    2. Wpisz swój adres e-mail i pozostałych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz i kontynuuj.
  6. 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

  1. Otwórz stronę Apps Script Pierwsze kroki.
  2. Kliknij szablon Aplikacja do obsługi czatu. Aby go zobaczyć, konieczne może być przewinięcie strony.
  3. Kliknij Projekt bez nazwy, wpisz Quickstart app i kliknij Zmień nazwę.

Kopiowanie numeru projektu Cloud

  1. Otwórz swój projekt Cloud w konsoli Google Cloud.
  2. Kliknij Ustawienia i narzędzia > Ustawienia projektu.
  3. Skopiuj numer projektu.

Ustawianie projektu Cloud dla projektu Apps Script

  1. W projekcie Apps Script 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 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:

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

  1. W konsoli Google Cloud 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 Avatar URL (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 Odbieranie wiadomości 1:1 i Dołączanie do pokoi i rozmów grupowych.
    5. W sekcji Ustawienia połączenia wybierz Projekt Apps Script i wklej w polu identyfikator wdrożenia.
    6. W sekcji Widoczność wybierz Określone osoby i grupy w Twojej domenie i wpisz adres e-mail.
  4. Kliknij Zapisz i odśwież stronę.

  5. Na stronie konfiguracji w sekcji Stan aplikacji ustaw stan na Aktywna – dostępna dla użytkowników.

  6. Kliknij Zapisz.

Aplikacja Google Chat jest gotowa do odpowiadania na wiadomości.

Testowanie aplikacji Google Chat

  1. Otwórz Google Chat.
  2. Aby wysłać nową wiadomość na czacie do aplikacji, kliknij Rozpocznij czat > Znajdź aplikacje.
  3. Na stronie Znajdź aplikacje wyszukaj Quickstart App.
  4. Obok opcji Szybkie wprowadzenie do aplikacji kliknij Czat.
  5. W nowym czacie z aplikacją wpisz Hello i naciśnij enter.

Aplikacja Google Chat podziękuje za jej dodanie i ponownie odtworzy 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.

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.