Na tej stronie znajdziesz omówienie tworzenia dodatków Google Workspace, które rozszerzają możliwości Google Chat.
Dodatki Google Workspace, które rozszerzają możliwości Google Chat, mogą pomóc użytkownikom w:
- wyświetlać podgląd linków z wiadomości w Google Chat i podejmować działania bez opuszczania rozmowy;
- Automatyzowanie zadań lub wykonywanie ich w aplikacjach Google Workspace.
- otrzymywać alerty lub powiadomienia o zewnętrznych narzędziach i usługach.
Jak działają dodatki Google Workspace w Google Chat
W Google Chat dodatki są widoczne dla użytkowników jako aplikacje Google Chat. Aby wchodzić w interakcje z użytkownikami, aplikacje Google Chat mogą:
- Wysyłaj wiadomości zawierające tekst, karty i interaktywne elementy interfejsu.
- reagować na szybkie polecenia.
- odpowiadać na polecenia po ukośniku.
- Otwieraj dialogi, aby ułatwić użytkownikom wykonywanie wieloetapowych procesów, takich jak wypełnianie formularzy.
- Podgląd linków w wiadomościach poprzez dołączanie kart z przydatnymi informacjami, które umożliwiają użytkownikom podejmowanie działań bezpośrednio w trakcie rozmowy.
Rozpocznij
Aby zacząć tworzyć dodatki Google Workspace, które działają w Chat, zapoznaj się z tymi materiałami:
- Wypróbuj samouczek, aby utworzyć podstawową aplikację Czat za pomocą Google Apps Script lub usługi HTTP.
- Skonfiguruj aplikację Google Chat i jej funkcje interaktywne za pomocą interfejsu Chat API.
- Dowiedz się, jak tworzyć interfejsy czatu za pomocą dodatkowych reguł, działań i obiektów zdarzeń.
Ograniczenia i znane problemy
Te funkcje czatu i dodatków są niedostępne:
- Dialogflow i Pub/Sub. Dodatki rozszerzające Google Chat musisz tworzyć za pomocą Apps Script lub usługi HTTP.
- Usługa kart w Apps Script. Aby używać czynności w czacie i tworzyć karty, zamiast tego zwracaj obiekty JSON. Przykłady znajdziesz w artykułach Otwieranie interaktywnych dialogów i Podgląd linków.
- niestandardowe karty autoryzacyjne. Aby uwierzytelnić użytkownika i przyznać mu uprawnienia do usługi z Google Chat, aplikacja Google Chat musi zwrócić kartę autoryzacji podstawowej.
- stronę główną dodatku na pasku bocznym Google Chat. Jeśli skonfigurujesz wyzwalacz strony głównej dla swojego dodatku, strona główna będzie się pojawiać tylko na pasku bocznym innych aplikacji Google Workspace, które rozszerza Twój dodatek.
- Strony główne aplikacji do obsługi czatu, które są wyświetlane na karcie Strona główna w wiadomościach bezpośrednich w aplikacji Chat.
Jeśli aktualizujesz istniejący dodatek Google Workspace, weź pod uwagę te wymagania dotyczące konfiguracji aplikacji Google Chat:
- Ustawienia instalacji Google Workspace Marketplace muszą zezwalać na instalowanie dodatku zarówno użytkownikom indywidualnym, jak i administratorom Google Workspace.
- W Chat ignorowane są wszystkie typowe ustawienia konfiguracyjne w manifest (
addons.common) rozszerzenia. Aby skonfigurować dodatek do działania w Google Chat, musisz włączyć i skonfigurować interfejs Chat API. Instrukcje znajdziesz w artykule Konfigurowanie aplikacji Google Chat. - Jeśli tworzysz usługę za pomocą usługi HTTP, musisz włączyć interfejs Google Workspace Add-ons API. Zasoby REST
deploymentiprojectmają zastosowanie tylko do wdrożeń dodatków w innych aplikacjach Google Workspace. - Aby wdrożyć i przetestować dodatek w Google Chat, musisz użyć ustawienia Widoczność w interfejsie Chat API. Wszystkie ustawienia widoczności i testowania skonfigurowane w pakiecie SDK Google Workspace Marketplace są ignorowane. Aby wdrożyć wersję testową dodatku w Google Chat, zapoznaj się z artykułem Testowanie funkcji interaktywnych aplikacji Google Chat w dokumentacji interfejsu Chat API.
- Jeśli Twoje dodatki są opublikowane w Google Workspace Marketplace, nie możesz zapisać wersji roboczej żadnych zmian w ustawieniach konfiguracji interfejsu Google Chat API. Gdy zaktualizujesz ustawienia konfiguracji interfejsu API Google Chat, zaktualizowana aplikacja Google Chat będzie natychmiast dostępna dla wszystkich dotychczasowych użytkowników. Aby zaktualizować informacje o produkcie w Marketplace, przed przesłaniem zmian możesz utworzyć wersję roboczą.