Tworzenie aplikacji Google Chat za pomocą Google Apps Script

Na tej stronie dowiesz się, jak utworzyć aplikację Google Chat za pomocą Google Apps Script. Aplikacja do Google Chat umożliwia wysyłanie wiadomości bezpośrednich i odpowiada, powtarzając Twoje wiadomości.

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

Na powyższym diagramie użytkownik wchodzący w interakcję z aplikacją Google Chat w Apps Script ma następujący przepływ informacji:

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

Cele

• skonfigurować środowisko,
• Skonfiguruj skrypt.
• Skonfiguruj aplikację Google Chat.
• Przetestuj aplikację do Google Chat.

Wymagania wstępne

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

Konfigurowanie środowiska

Otwieranie projektu w chmurze w konsoli Google Cloud

Jeśli nie masz jeszcze otwartego projektu w chmurze, którego chcesz użyć w tym przykładzie, otwórz go:

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

Włączanie interfejsu Google 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ć 1 lub więcej interfejsów API.

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

  Włączanie interfejsu API

Konfigurowanie ekranu zgody OAuth

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

1. W Konsoli interfejsów API Google kliknij Menu  > Platforma Google Auth > Marka.

   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 Marka, 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ą pisać, aby się z Tobą skontaktować, jeśli mają pytania dotyczące zgody.
3. Kliknij Dalej.
4. W sekcji Odbiorcy wybierz Wewnętrzny.
5. Kliknij Dalej.
6. W sekcji Informacje kontaktowe wpisz adres e-mail, na który chcesz otrzymywać powiadomienia o zmianach w projekcie.
7. Kliknij Dalej.
8. W sekcji Finish (Zakończ) zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsów API Google i jeśli się z nimi zgadzasz, zaznacz pole I agree to the Google API Services: User Data Policy (Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów API Google).
9. Kliknij Dalej.
10. Kliknij Utwórz.
3. Na razie możesz pominąć dodawanie zakresów. Jeśli w przyszłości utworzysz aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji, których wymaga Twoja aplikacja. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie ekranu zgody OAuth.

Konfigurowanie skryptu

Aby skonfigurować skrypt, użyj szablonu aplikacji Google Chat ze strony Pierwsze kroki w Apps Script.

Tworzenie projektu Apps Script

1. Na stronie Pierwsze kroki w Apps Script przejdź do sekcji Dodatki do Google Workspace i kliknij szablon Aplikacja do Google Chat:

   Otwórz szablon aplikacji Google Chat

2. W nowym projekcie Apps Script, który się otworzy, nadaj mu nazwę:

   1. Kliknij Projekt bez tytułu.

   2. W polu Nazwa projektu wpisz Quickstart app.

   3. Kliknij Zmień nazwę.

Jeśli w przyszłości zechcesz używać określonych interfejsów API Google lub opublikować aplikację, musisz powiązać projekt w chmurze z projektem Apps Script. W przypadku tego przewodnika 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 użyć go w następnym kroku.

Aby uzyskać identyfikator wdrożenia head, wykonaj te czynności:

1. W projekcie Apps Script aplikacji do Google Chat kliknij Wdróż > Testuj wdrożenia.
2. Skopiuj identyfikator wdrożenia Head, aby użyć go w kolejnym kroku, i kliknij Gotowe.

Konfigurowanie aplikacji Google Chat

Aby skonfigurować aplikację Google Chat, wykonaj te czynności:

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ę Google Chat:

   1. W polu Nazwa aplikacji wpisz Quickstart app.
   2. W polu Avatar URL (Adres URL awatara) wpisz https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   3. W polu Opis wpisz Quickstart app.
   4. W sekcji Funkcje wybierz Dołączanie do pokoi i rozmów grupowych.
   5. W sekcji Ustawienia połączenia wybierz Projekt Apps Script.
   6. W polu Identyfikator wdrożenia wklej skopiowany wcześniej identyfikator wdrożenia Head.
   7. W sekcji Widoczność wybierz Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.

4. Kliknij Zapisz.

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

Testowanie aplikacji do Google Chat

Aby przetestować aplikację do Google Chat, otwórz czat z aplikacją do Google Chat i wyślij wiadomość:

1. Otwórz Google Chat, używając konta Google Workspace podanego 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 Google Chat.

4. Wybierz aplikację do Google Chat z wyników. Otworzy się czat.

   Uwaga: jeśli nie widzisz swojej aplikacji do Google Chat na liście wyników, upewnij się, że Twoje konto Google Workspace jest 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 Google Chat podziękuje za dodanie i powtórzy Twoją wiadomość.

Aby dowiedzieć się, jak dodawać zaufanych testerów i testować funkcje interaktywne, zapoznaj się z artykułem Testowanie funkcji interaktywnych w aplikacjach do Google Chat.

Rozwiązywanie problemów

Gdy aplikacja Google Chat lub karta zwraca błąd, interfejs Google Chat wyświetla 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 generuje nieoczekiwany wynik, np. wiadomość na karcie może się nie pojawić.

Chociaż komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, opisowe komunikaty o błędach i dane dziennika są dostępne, aby pomóc Ci naprawić błędy, gdy włączone jest rejestrowanie błędów w aplikacjach do Google Chat. Pomoc dotyczącą wyświetlania, debugowania i naprawiania błędów znajdziesz w artykule Rozwiązywanie i naprawianie błędów w Google Chat.

Czyszczenie danych

Aby uniknąć obciążenia 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żyto istniejącego projektu, usunięcie go spowoduje również usunięcie wszystkich innych prac wykonanych w tym projekcie.
• Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu mogłeś utworzyć niestandardowy identyfikator projektu, którego chcesz używać 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 usuwać cały projekt.

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 > IAM i administrator > Zarządzaj zasobami.

   Otwórz Resource Managera

2. Z listy 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 interaktywnych kart – wiadomości na kartach obsługują zdefiniowany układ, interaktywne elementy interfejsu, takie jak przyciski, oraz rich media, takie jak obrazy. Używaj wiadomości w formie kart, aby przedstawiać szczegółowe informacje, zbierać informacje od użytkowników i zachęcać ich do wykonania kolejnego kroku.
• Odpowiadanie na polecenia – polecenia pomagają użytkownikom odkrywać i używać kluczowych funkcji aplikacji do Google Chat.
• Uruchamianie okien dialogowych – okna dialogowe to interfejsy oparte na kartach, które aplikacja może otwierać, aby wchodzić w interakcje z użytkownikiem. Można połączyć ze sobą kilka kart, co ułatwia użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie formularzy.
• Ćwiczenie: chcesz utworzyć bardziej zaawansowaną aplikację do Google Chat? Zobacz aplikację do obsługi czatu z opiniami z ćwiczenia z programowania Tworzenie aplikacji do Google Chat przy użyciu Gemini.

Aplikacje do Google Chat, które nie są dodatkami: Tworzenie aplikacji do Google Chat za pomocą Google Apps Script

Aby utworzyć aplikację do Google Chat, która nie jest dodatkiem do Google Workspace, za pomocą Apps Script, wykonaj te czynności, aby utworzyć skrypt z szablonu i skonfigurować aplikację do Google Chat, która nie jest dodatkiem.

Tworzenie skryptu na podstawie szablonu

1. Otwórz szablon aplikacji Google Chat

2. Kliknij Projekt bez tytułu, wpisz Quickstart app i kliknij Zmień nazwę.

   Jeśli w przyszłości zechcesz używać określonych interfejsów API Google lub opublikować aplikację, musisz powiązać projekt w chmurze z projektem Apps Script. W przypadku tego przewodnika nie musisz tego robić. Więcej informacji znajdziesz w przewodniku po projektach Google Cloud.

3. W projekcie Apps Script aplikacji do Google Chat kliknij Wdróż > Testuj wdrożenia.

4. Skopiuj identyfikator wdrożenia Head, aby użyć go w następnym kroku, i kliknij Gotowe.

Konfigurowanie aplikacji do Google Chat, która nie jest dodatkiem

Skonfiguruj aplikację do Google Chat, która nie jest dodatkiem, 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ę Google Chat, która nie jest dodatkiem:

   1. Odznacz pole Utwórz tę aplikację do Google Chat 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 Avatar URL (Adres URL awatara) wpisz https://developers.google.com/workspace/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 Head.
   8. W sekcji Widoczność wybierz Określeni użytkownicy i grupy w Twojej domenie i wpisz swój adres e-mail.

4. Kliknij Zapisz.