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

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.

1. W Konsoli interfejsów API Google otwórz stronę Zarządzanie zasobami. Kliknij Menu 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ń delete.
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.
• code 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.