Krótkie wprowadzenie do Google Chat Script

Utwórz aplikację Google Chat, na którą możesz bezpośrednio wysyłać wiadomości i które odpowiadają na Twoje polecenia.

Cele

• skonfigurować środowisko,
• Skonfiguruj skrypt.
• Opublikuj aplikację.
• Uruchom skrypt.

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:

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 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ć jeden lub więcej interfejsów API.

• W konsoli Google Cloud włącz interfejs Google Chat API.

  Włączanie interfejsu API

Skonfiguruj ekran zgody OAuth

Wszystkie aplikacje używające protokołu OAuth 2.0 wymagają konfiguracji ekranu zgody. Skonfigurowanie ekranu zgody OAuth określa, co jest wyświetlane użytkownikom i weryfikatorom aplikacji, oraz rejestruje aplikację, aby można ją było opublikować później.

1. W konsoli Google Cloud kliknij Menu > Interfejsy API i usługi > Ekran zgody OAuth.

   Otwórz ekran zgody OAuth

2. Wybierz typ użytkownika aplikacji 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 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 Testerzy kliknij Dodaj użytkowników.
   2. Wpisz adres e-mail i innych autoryzowanych użytkowników testów, a potem kliknij Zapisz i kontynuuj.
6. Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edit (Edytuj). Jeśli rejestracja aplikacji wygląda dobrze, kliknij Powrót do panelu.

Konfigurowanie skryptu

Aby skonfigurować skrypt, użyj szablonu, a następnie skonfiguruj projekt Cloud w Apps Script.

Tworzenie skryptu na podstawie szablonu

1. Otwórz stronę Apps ScriptPierwsze kroki w Apps Script.
2. Kliknij szablon Google Chat. Aby zobaczyć ten szablon, może być konieczne przewinięcie strony w dół.
3. Kliknij Projekt bez tytułu, wpisz Quickstart app i kliknij Zmień nazwę.

Skopiuj numer projektu Cloud

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

Ustawianie projektu Cloud w języku Apps Script

1. W projekcie Apps Script aplikacji Google Chat kliknij Ustawienia 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ć (w sposób opisany poniżej), a następnie dostosować go do swoich wymagań.

Podczas otwierania szablonu Apps Script upewnij się, że logujesz się na właściwe konto Google. Bieżące konto może czasem przełączyć się na konto domyślne bez powiadamiania użytkownika.

Tworzenie wdrożenia testowego

Potrzebujesz identyfikatora wdrożenia dla tego projektu Apps Script, aby użyć go w następnym kroku.

Aby uzyskać identyfikator wdrożenia nagłówka, wykonaj te czynności:

1. W projekcie Apps Script aplikacji Google Chat kliknij Wdróż > Przetestuj wdrożenia.
2. Skopiuj identyfikator wdrażania nagłówka, którego użyjesz w kolejnym kroku, i kliknij Gotowe.

Publikowanie aplikacji do obsługi czatu

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 Adres 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 Wiadomości 1:1 i Dołącz do pokoi i rozmów grupowych.
   5. W ustawieniach połączenia wybierz Projekt Apps Script i wklej identyfikator wdrożenia w polu.
   6. W sekcji Uprawnienia wybierz Określone osoby i grupy i wpisz adres e-mail.

4. Kliknij Zapisz i odśwież stronę.

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

6. Kliknij Zapisz.

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

Uruchamianie skryptu

1. Otwórz Google Chat.
2. Wyślij nową wiadomość na czacie, klikając Rozpocznij czat > Znajdź aplikacje.
3. Na stronie Znajdź aplikacje wyszukaj Quickstart App.
4. Obok Aplikacja Szybki start kliknij Czat.
5. W nowym czacie z aplikacją wpisz Hello i naciśnij enter.

Aplikacja podziękuje za dodanie i powtórzy wiadomość.

Dalsze kroki

• Tworzenie kart interaktywnych – komunikaty z karty 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.
• Obsługa poleceń 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 zaczynające się od ukośnika (/), np. /help.
• Okna uruchamiania – okna w osobnych interfejsach, które aplikacja może otwierać w celu interakcji z użytkownikiem. Wiele kart może się układać po kolei, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie danych formularza.