Krótkie wprowadzenie do Google Chat Script

Utwórz aplikację Google Chat, do której możesz bezpośrednio wysłać wiadomość i na nią odpowiedzieć.

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 projekt Cloud nie jest jeszcze otwarty, wybierz ten projekt Cloud:

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, może być konieczne włączenie płatności w tym projekcie.

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

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

  Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

Wszystkie aplikacje używające protokołu OAuth 2.0 wymagają konfiguracji ekranu zgody. Konfigurowanie ekranu zgody OAuth w aplikacji 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, a następnie 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ć jej zakresy autoryzacji.

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 swój adres e-mail i innych autoryzowanych użytkowników testu, 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 swój projekt Cloud w Apps Script.

Tworzenie skryptu na podstawie szablonu

1. Otwórz stronę Pierwsze kroki Apps Script.
2. Kliknij szablon Google Chat. Aby go zobaczyć, może być konieczne przewinięcie strony w dół.
3. Kliknij Projekt bez tytułu, wpisz Quickstart app, a następnie 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 Google Apps Script Apps 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 potrzeb.

Podczas otwierania szablonu Apps Script upewnij się, że korzystasz z właściwego konta Google. Bieżące konto może czasem przełączyć się na Twoje konto domyślne bez zauważenia.

Tworzenie wdrożenia testowego

Musisz mieć identyfikator wdrożenia tego projektu Apps Script, aby móc go użyć w następnym kroku.

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

1. W projekcie Google Apps Script Apps kliknij Wdróż > Testuj wdrożenia.
2. Skopiuj identyfikator wdrażania nagłówka, którego użyjesz w kolejnym 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 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 Odbieranie 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 w 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.

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 aplikacji Quickstart kliknij Google Chat.
5. W nowej wiadomości bezpośredniej w aplikacji wpisz Hello i naciśnij enter.

Aplikacja podziękuje Ci za dodanie go i odtworzy komunikat.

Dalsze kroki

• Tworzenie interaktywnych kart – komunikaty kart obsługują zdefiniowany układ, interaktywne elementy interfejsu, takie jak przyciski, oraz elementy multimedialne, takie jak obrazy. Za pomocą wiadomości na karcie możesz przedstawiać szczegółowe informacje, zbierać informacje od użytkowników, a także zachęcać użytkowników do wykonania kolejnego kroku.
• Polecenia po ukośniku – polecenia po ukośniku umożliwiają rejestrację i reklamowanie konkretnych poleceń, które użytkownicy mogą przekazać aplikacji, wpisując polecenie, które zaczyna się od ukośnika (/), np. /help.
• Uruchomienia – okna podzielone na karty, które można otworzyć w celu interakcji użytkownika z aplikacją. Poszczególne karty mogą być umieszczane w tej samej kolejności, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak uzupełnianie danych formularzy.