Przedpremierowa wersja dla deweloperów: dostępna w ramach
programu Google Workspace dla deweloperów: przedpremierowa wersja , który zapewnia wcześniejszy dostęp do niektórych funkcji.
Z tej strony dowiesz się, jak skonfigurować szybkie polecenia i odpowiadać na nie w aplikacji Google Chat.
Szybkie polecenie to sposób, w jaki użytkownicy mogą wywoływać aplikację Google Chat i wchodzić z nią w interakcje. Aby użyć szybkiego polecenia, otwórz menu integracji, klikając add_circle w pokoju czatu lub rozmowie, a następnie wybierz polecenie aplikacji, którego nazwa nie zaczyna się od ukośnika (/). Wybranie szybkiego polecenia powoduje bezpośrednie wywołanie aplikacji Google Chat bez konieczności dalszego wprowadzania danych przez użytkownika, co umożliwia szybkie interakcje.
Użytkownicy mogą też wywołać aplikację Google Chat za pomocą polecenia po ukośniku . W porównaniu z poleceniami po ukośniku szybkie polecenia mają w interfejsie Google Chat bardziej przyjazną dla użytkownika nazwę, są wywoływane natychmiast po wybraniu i nie wymagają od użytkownika zapamiętywania ani wpisywania nazwy polecenia po ukośniku.
Rysunek 1. Menu integracji zawierające szybkie polecenia dotyczące aplikacji Google Chat.
Konfigurowanie szybkiego polecenia w interfejsie Google Chat API
Aby utworzyć szybkie polecenie lub zaktualizować istniejące polecenia po ukośniku, musisz podać informacje o tym poleceniu w konfiguracji interfejsu Google Chat API w aplikacji Google Chat.
Aby skonfigurować szybkie polecenie w Google Chat API, wykonaj te czynności:
W konsoli Google Cloud kliknij Menu
menu
> Interfejsy API i usługi
> Włączone interfejsy API i usługi
> Interfejs Google Chat API
Otwórz stronę interfejsu Google Chat API
Kliknij Konfiguracja .
W sekcji Ustawienia zaawansowane otwórz Wyzwalacze i sprawdź, czy pole Polecenie aplikacji zawiera wyzwalacz, taki jak punkt końcowy HTTP lub funkcja Apps Script. Aby odpowiedzieć na szybkie polecenie, musisz użyć tego wyzwalacza w następującej sekcji.
W sekcji Polecenia kliknij Dodaj polecenie .
Wpisz identyfikator, nazwę, opis i typ polecenia:
Identyfikator polecenia: liczba z zakresu 1–1000, której używa aplikacja Google Chat do rozpoznawania polecenia i zwracania odpowiedzi.Nazwa: wyświetlana nazwa polecenia. Nazwy mogą mieć maksymalnie 50 znaków i mogą zawierać znaki specjalne.
Używaj krótkich, opisowych i użytecznych słów lub wyrażeń, aby polecenia były zrozumiałe dla użytkownika. Na przykład polecenie Update contact (Zaktualizuj kontakt) służy do modyfikowania rekordu kontaktu.
Opis: tekst opisujący działanie polecenia.
Opis może mieć maksymalnie 50 znaków i może zawierać znaki specjalne.
Opis powinien być krótki i jasny, aby użytkownicy wiedzieli, czego się spodziewać po wywołaniu polecenia.
Poinformuj użytkowników, czy aplikacja Google Chat ma odpowiadać wszystkim w pokoju czy tylko użytkownikowi, który wywołał polecenie. Na przykład w przypadku szybkiego polecenia Informacje możesz podać opis Dowiedz się więcej o tej aplikacji (widoczne tylko dla Ciebie) .
Typ polecenia: wybierz Szybkie polecenie . Opcjonalnie: jeśli chcesz, aby aplikacja Google Chat odpowiadała na polecenie za pomocą okna dialogowego , zaznacz pole wyboru Otwórz okno dialogowe .
Kliknij Zapisz .
Szybkie polecenie zostało skonfigurowane w aplikacji Google Chat.
Odpowiedź na szybkie polecenie
Gdy użytkownicy wywołują szybkie polecenie, aplikacja Google Chat otrzymuje obiekt zdarzenia zawierający informacje o tym poleceniu.
Obiekt zdarzenia zawiera ładunek AppCommand
Aby odpowiedzieć na szybkie polecenie, musisz zaimplementować wyzwalacz polecenia aplikacji obiekty zdarzeń zawierające metadane polecenia aplikacji .
Poniższy kod pokazuje przykład aplikacji czatu, która odpowiada na polecenie Pomoc . Aby odpowiadać na szybkie polecenia, aplikacja Google Chat obsługuje obiekty zdarzeń z wyzwalacza polecenia aplikacji . Gdy ładunek obiektu zdarzenia zawiera identyfikator szybkiej komendy, aplikacja Google Chat zwraca działanie DataActions z obiektem createMessageAction
Google Apps Script
// The ID of the slash command "/about".
// It's not enabled by default, set to the actual ID to enable it. You must
// use the same ID as set in the Google Chat API configuration.
const HELP_COMMAND_ID = 0 ;
/**
* Responds to an APP_COMMAND event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onAppCommand ( event ) {
// Stores the Google Chat app command metadata as a variable.
const appCommandMetadata = event . chat . appCommandPayload . appCommandMetadata ;
if ( appCommandMetadata . appCommandType == "QUICK_COMMAND" ) {
// Executes the quick command logic based on its ID.
// Quick command IDs are set in the Google Chat API configuration.
switch ( appCommandMetadata . appCommandId ) {
case HELP_COMMAND_ID :
return { hostAppDataAction : { chatDataAction : { createMessageAction : { message : {
text : 'The Avatar app replies to Google Chat messages.'
}}}}};
}
}
}
Aby użyć tego przykładowego kodu, zastąp HELP_COMMAND_ID konfigurowania szybkiego polecenia w interfejsie Chat API .
Aby przetestować szybkie polecenie w Google Chat, otwórz menu integracji, klikając Narzędzia Google Workspace add_circle , a następnie wybierz szybkie polecenie.
