Tworzenie aplikacji Google Chat za pomocą Google Apps Script

Uwaga: w tym przewodniku dowiesz się, jak utworzyć interaktywną aplikację do obsługi czatu za pomocą zdarzeń interakcji z interfejsem Chat API. Aplikację do obsługi czatu możesz też utworzyć jako dodatek do Google Workspace. Aby dowiedzieć się, którego frameworka użyć, przeczytaj artykuł Tworzenie interaktywnej aplikacji Google Chat.

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

Ten schemat przedstawia architekturę i wzorzec przesyłania wiadomości:

Na powyższym schemacie użytkownik wchodzący w interakcję z aplikacją do obsługi czatu Apps Script ma następujący przepływ informacji:

1. Użytkownik wysyła wiadomość do aplikacji do obsługi czatu na czacie lub w pokoju w Google Chat.
2. Logika aplikacji do obsługi czatu zaimplementowana w Apps Script, która znajduje się w Google Cloud, odbiera i przetwarza wiadomość.
3. Opcjonalnie logika aplikacji do obsługi czatu może być zintegrowana z usługami Google Workspace, takimi jak Kalendarz czy Arkusze, lub z innymi usługami Google, takimi jak Mapy Google czy YouTube.
4. Logika aplikacji do obsługi czatu wysyła odpowiedź do usługi aplikacji do obsługi czatu w Google Chat.
5. Odpowiedź jest dostarczana do użytkownika.

Cele

• Skonfiguruj środowisko.
• Skonfiguruj skrypt.
• Skonfiguruj aplikację do obsługi czatu.
• Przetestuj aplikację do obsługi czatu.

Wymagania wstępne

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Projekt Google Cloud. Aby go utworzyć, przeczytaj artykuł Tworzenie projektu Google Cloud.

Konfigurowanie środowiska

Otwieranie projektu w chmurze w konsoli Google Cloud

Jeśli nie jest jeszcze otwarty, otwórz projekt w chmurze, którego chcesz użyć w tym przykładzie:

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

   Wybierz projekt w chmurze

2. Wybierz projekt w chmurze Google, 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, być może trzeba będzie włączyć w nim płatności.

Włączanie interfejsu Chat API

Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie w chmurze Google. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

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

  Włączanie API

Konfigurowanie ekranu zgody OAuth

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

1. W Konsoli interfejsów API Google otwórz Menu > Platforma uwierzytelniania Google > Elementy marki.

   Przejdź na stronę Elementy marki

2. Jeśli platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Elementy marki, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:
1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, na który użytkownicy mogą się z Tobą skontaktować, jeśli mają pytania dotyczące zgody.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzni.
5. Kliknij Dalej.
6. W sekcji Dane kontaktowe wpisz Adres e-mail, na który będziesz otrzymywać powiadomienia o wszelkich zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Zakończ zapoznaj się z Zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google. Jeśli się z nimi zgadzasz, zaznacz pole Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
9. Kliknij Dalej.
10. Kliknij Utwórz.
3. Na razie możesz pominąć dodawanie zakresów. W przyszłości, gdy będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie zgody OAuth.

Konfigurowanie skryptu

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

Tworzenie skryptu na podstawie szablonu

1. Otwórz stronę Pierwsze kroki w Apps Script.
2. U góry strony kliknij szablon Aplikacja do obsługi czatu.
3. Kliknij Projekt bez tytułu, wpisz Quickstart app i kliknij Zmień nazwę.

Jeśli w przyszłości będziesz chcieć korzystać z niektórych interfejsów API Google lub opublikować aplikację, musisz powiązać projekt w chmurze z projektem Apps Script. W tym przewodniku nie musisz tego robić. Więcej informacji znajdziesz w przewodniku po projektach Google Cloud.

Tworzenie wdrożenia testowego

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

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

1. W projekcie Apps Script aplikacji do obsługi czatu kliknij Wdróż > Wdrożenia testowe.
2. Skopiuj Identyfikator wdrożenia głównego , aby użyć go w kolejnym kroku, i kliknij Gotowe.

Konfigurowanie aplikacji do obsługi czatu

Skonfiguruj aplikację do obsługi czatu w Konsoli interfejsów API.

1. W Konsoli interfejsów API, wyszukaj Google Chat API i kliknij Google Chat API.
2. Kliknij Zarządzaj.

3. Kliknij Konfiguracja i skonfiguruj aplikację do obsługi czatu:

   1. Odznacz pole Utwórz tę aplikację do obsługi czatu jako dodatek do Google Workspace. Otworzy się okno z prośbą o potwierdzenie. W oknie kliknij Wyłącz.
   2. W polu Nazwa aplikacji wpisz Quickstart app.
   3. W polu Adres URL awatara wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.
   4. W polu Opis wpisz Quickstart app.
   5. W sekcji Funkcje wybierz Dołączanie do pokoi i rozmów grupowych.
   6. W sekcji Ustawienia połączenia wybierz Apps Script.
   7. W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia głównego.
   8. W sekcji Widoczność wybierz Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.

4. Kliknij Zapisz.

Aplikacja do obsługi czatu jest gotowa do odpowiadania na wiadomości.

Testowanie aplikacji do obsługi czatu

Aby przetestować aplikację do obsługi czatu, otwórz czat z tą aplikacją i wyślij wiadomość:

1. Otwórz Google Chat za pomocą konta Google Workspace, które zostało podane podczas dodawania siebie jako zaufanego testera.

   Otwórz Google Chat

2. Kliknij Nowy czat.
3. W polu Dodaj co najmniej 1 osobę wpisz nazwę aplikacji do obsługi czatu.

4. Wybierz aplikację do obsługi czatu z wyników. Otworzy się czat.

   Uwaga: jeśli nie widzisz aplikacji do obsługi czatu na liście wyników, sprawdź, czy Twoje konto Google Workspace zostało uwzględnione w ustawieniach Widoczność na stronie Konfiguracja interfejsu Chat API w Konsoli interfejsów API Google.

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

   Aplikacja do obsługi czatu podziękuje Ci za dodanie jej i powtórzy 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 Google Chat zwraca błąd, w interfejsie Google Chat pojawia się komunikat „Coś poszło nie tak” lub „Nie udało się przetworzyć żądania”. Czasami interfejs Google Chat nie wyświetla żadnego komunikatu o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik. Na przykład może się nie pojawić wiadomość na karcie.

Chociaż w interfejsie Google Chat może się nie wyświetlać komunikat o błędzie, dostępne są opisowe komunikaty o błędach i dane logów, które pomogą Ci naprawić błędy gdy włączone jest rejestrowanie błędów w aplikacjach Google Chat. Aby uzyskać pomoc w wyświetlaniu, debugowaniu i naprawianiu błędów, przeczytaj artykuł Rozwiązywanie problemów i naprawianie błędów w Google Chat.

Zwalnianie miejsca

Aby uniknąć obciążania konta Google Cloud opłatami za zasoby zużyte w tym samouczku, zalecamy usunięcie projektu w chmurze.

Ostrzeżenie: usunięcie projektu spowoduje, że:

• Wszystkie dane projektu zostaną usunięte. Jeśli w tym samouczku używasz istniejącego projektu, po jego usunięciu usuniesz też wszystkie inne prace wykonane w tym projekcie.
• Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu mogłeś(-aś) utworzyć niestandardowy identyfikator projektu, którego chcesz użyć w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, np. adres URL w appspot.com, usuń wybrane zasoby w projekcie zamiast całego projektu.

Jeśli zamierzasz skorzystać z innych samouczków i krótkich wprowadzeń, ponowne wykorzystanie tych samych projektów może pomóc Ci uniknąć przekroczenia Iimitów związanych z projektami.

1. W Konsoli interfejsów API Google otwórz stronę Zarządzanie zasobami. Kliknij Menu > Uprawnienia i administracja > Zarządzanie zasobami.

   Otwórz Resource Manager

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

Dalsze kroki

• Tworzenie kart interaktywnych – wiadomości na kartach obsługują zdefiniowany układ, interaktywne elementy interfejsu, takie jak przyciski, oraz rich media, np. obrazy. Używaj wiadomości na kartach, aby prezentować szczegółowe informacje, zbierać informacje od użytkowników i kierować ich do wykonania następnego kroku.
• Odpowiadanie na polecenia – polecenia pomagają użytkownikom odkrywać i używać najważniejszych funkcji aplikacji do obsługi czatu.
• Uruchamianie okien – okna to interfejsy oparte na kartach , które aplikacja może otwierać, aby wchodzić w interakcję z użytkownikiem. Można połączyć ze sobą kilka kart, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie danych formularza.
• Codelab: chcesz utworzyć bardziej zaawansowaną aplikację do obsługi czatu? Zapoznaj się z aplikacją do obsługi czatu z opiniami z codelabu Tworzenie aplikacji do Google Chat przy użyciu Gemini.