Na tej stronie znajdziesz ogólne informacje o tym, jak tworzyć dodatki do Google Workspace, które rozszerzają funkcje Google Chat.
Dodatki do Google Workspace, które rozszerzają funkcje Google Chat, mogą pomóc użytkownikom w wykonywaniu tych czynności:
- Wyświetlaj podgląd linków z wiadomości na czacie i podejmuj działania bez opuszczania rozmowy.
- Automatyzacja lub wykonywanie zadań w aplikacjach Google Workspace.
- otrzymywać alerty lub powiadomienia dotyczące narzędzi lub usług zewnętrznych;
Jak dodatki do Google Workspace działają w Google Chat
W Chat dodatki są widoczne dla użytkowników jako aplikacje Google Chat. Aby wchodzić w interakcje z użytkownikami, aplikacje w Google Chat mogą:
- Wysyłanie wiadomości zawierających tekst, karty i interaktywne elementy interfejsu.
- Reagowanie na szybkie polecenia.
- Odpowiadanie na polecenia po ukośniku.
- Otwieraj okna dialogowe, aby pomagać użytkownikom w wykonywaniu wieloetapowych procesów, takich jak wypełnianie danych w formularzu.
- Wyświetlaj podgląd linków w wiadomościach, dołączając karty z przydatnymi informacjami, które umożliwiają użytkownikom podejmowanie działań bezpośrednio z poziomu rozmowy.
Rozpocznij
Aby zacząć tworzyć dodatki do Google Workspace, które działają w Chat, zapoznaj się z tymi dokumentami:
- Wypróbuj przewodnik Szybki start, aby utworzyć podstawową aplikację Google Chat za pomocą Google Apps Script lub usługi HTTP.
- Skonfiguruj aplikację do obsługi czatu i jej funkcje interaktywne za pomocą interfejsu Chat API.
- Dowiedz się, jak tworzyć interfejsy czatu za pomocą wyzwalaczy, działań i obiektów zdarzeń dodatku.
Ograniczenia i znane problemy
Niedostępne są te funkcje czatu i dodatków:
- Architektury aplikacji do obsługi czatu Dialogflow, Pub/Sub i AppSheet są niedostępne. Zamiast tego musisz utworzyć aplikację do obsługi Google Chat za pomocą Apps Script lub usługi HTTP.
- usługi kart Apps Script. Aby używać działań na czacie i tworzyć karty, zwracaj obiekty JSON. Przykłady znajdziesz w sekcjach Otwieranie interaktywnych okien dialogowych i Wyświetlanie podglądu linków.
- karty autoryzacji niestandardowej, Aby uwierzytelnić usługę i przyznać jej autoryzację w Google Chat, aplikacja Google Chat musi zwrócić podstawową kartę autoryzacji.
- Strony główne dodatków na pasku bocznym Google Chat. Jeśli w dodatku skonfigurowano wyzwalacz strony głównej, strona główna będzie się wyświetlać tylko na pasku bocznym innych aplikacji Google Workspace, które rozszerza dodatek.
- strony główne aplikacji do obsługi czatu, które pojawiają się na karcie Strona główna w wiadomościach bezpośrednich z aplikacją do obsługi czatu;
Jeśli aktualizujesz istniejący dodatek do Google Workspace, weź pod uwagę te wymagania konfiguracyjne dotyczące aplikacji do czatu:
- Ustawienia instalacji Google Workspace Marketplace muszą zezwalać zarówno osobom, jak i administratorom Google Workspace na instalowanie dodatku.
- W Chat wszystkie typowe ustawienia konfiguracyjne w pliku manifestu dodatku (
addons.common) są ignorowane. Aby skonfigurować dodatek do pracy w Google Chat, musisz włączyć i skonfigurować interfejs Chat API. Instrukcje znajdziesz w artykule Konfigurowanie aplikacji Google Chat. - Aby wdrożyć i przetestować dodatek w Google Chat, musisz użyć ustawienia Widoczność interfejsu Chat API. Wszystkie ustawienia widoczności i testowania skonfigurowane w pakiecie SDK Google Workspace Marketplace są ignorowane. Aby wdrożyć testową wersję dodatku w Google Chat, zapoznaj się z artykułem Testowanie funkcji interaktywnych aplikacji Google Chat w dokumentacji interfejsu Chat API.
- Jeśli dodatek jest opublikowany w Google Workspace Marketplace, nie możesz zapisać wersji roboczej żadnych zmian w ustawieniach konfiguracji interfejsu Google Chat API. Gdy zaktualizujesz ustawienia konfiguracji interfejsu Chat API, zaktualizowana aplikacja do czatu będzie natychmiast dostępna dla wszystkich dotychczasowych użytkowników. Aby zaktualizować wizytówkę w Marketplace, przed przesłaniem zmian możesz utworzyć wersję roboczą.