Na tej stronie znajdziesz instrukcje tworzenia strony głównej wiadomości bezpośrednich w aplikacji Google Chat. Strona główna, zwana w interfejsie Google Chat API stroną główną aplikacji, to konfigurowalny interfejs karty, który pojawia się na karcie Główna pomieszczeń wiadomości bezpośrednich między użytkownikiem a aplikacją Google Chat.
Możesz użyć strony głównej aplikacji, aby udostępnić użytkownikom porady dotyczące interakcji z aplikacją Google Chat lub umożliwić im dostęp do usługi lub narzędzia zewnętrznego w Google Chat.
Za pomocą kreatora kart możesz zaprojektować i wyświetlić podgląd komunikatów oraz interfejsów użytkownika aplikacji do obsługi czatu:
Otwórz kreatora kartWymagania wstępne
Node.js
Aplikacja Google Chat, w której włączono funkcje interaktywne. Aby utworzyć interaktywną aplikację Google Chat przy użyciu usługi HTTP, wykonaj to krótkie wprowadzenie.
Python
Aplikacja Google Chat, w której można korzystać z funkcji interaktywnych. Aby utworzyć interaktywną aplikację Google Chat przy użyciu usługi HTTP, wykonaj to krótkie wprowadzenie.
Java
Aplikacja Google Chat, w której włączono funkcje interaktywne. Aby utworzyć interaktywną aplikację do obsługi czatu przy użyciu usługi HTTP, wykonaj to krótkie wprowadzenie.
Google Apps Script
Aplikacja Google Chat, w której włączono funkcje interaktywne. Aby utworzyć interaktywną aplikację Google Chat w Apps Script, wykonaj krótkie wprowadzenie.
Konfigurowanie ekranu głównego aplikacji Google Chat
Aby obsługiwać stronę główną aplikacji, musisz skonfigurować aplikację Google Chat tak, aby odbierała zdarzenia interakcji (APP_HOME
). Aplikacja Google Chat otrzymuje to zdarzenie za każdym razem, gdy użytkownik kliknie kartę Strona główna na czacie w aplikacji Google Chat.
Aby zaktualizować ustawienia konfiguracji w konsoli Google Cloud, wykonaj te czynności:
W konsoli Google Cloud otwórz Menu > Więcej usług > Google Workspace > Biblioteka usług > Google Chat API.
Kliknij Zarządzaj, a potem kartę Konfiguracja.
W sekcji Funkcje interaktywne otwórz sekcję Funkcje, aby skonfigurować stronę główną aplikacji:
- Zaznacz pole wyboru Odbieranie wiadomości 1:1.
- Zaznacz pole wyboru Strona główna aplikacji pomocy.
Jeśli Twoja aplikacja do czatu korzysta z usługi HTTP, otwórz Ustawienia połączenia i w polu Adres URL strony głównej aplikacji podaj punkt końcowy. Możesz użyć adresu URL określonego w polu URL punktu końcowego HTTP.
Kliknij Zapisz.
Tworzenie karty głównej aplikacji
Gdy użytkownik otworzy stronę główną aplikacji, aplikacja Google Chat musi obsłużyć zdarzenie interakcji APP_HOME
, zwracając instancję RenderActions
z nawigacją pushCard
i elementem Card
. Aby stworzyć interaktywną kartę, możesz użyć interaktywnych widżetów, takich jak przyciski lub pola tekstowe, które aplikacja czatu może przetwarzać i na które może odpowiadać dodatkowymi kartami lub oknem dialogowym.
W poniższym przykładzie aplikacja Google Chat wyświetla początkową kartę główną aplikacji, która zawiera czas utworzenia karty oraz przycisk. Gdy użytkownik kliknie przycisk, aplikacja Czat zwróci zaktualizowaną kartę z czasem jej utworzenia.
Node.js
Python
Java
Google Apps Script
Zaimplementuj funkcję onAppHome
, która będzie wywoływana po wszystkich zdarzeniach interakcji APP_HOME
:
W tym przykładzie wysyłamy wiadomość z karty, zwracając obiekt JSON karty. Możesz też użyć usługi kart Apps Script.
Odpowiadanie na interakcje na ekranie głównym aplikacji
Jeśli początkowa karta aplikacji zawiera interaktywne widżety, takie jak przyciski lub pola wyboru, aplikacja Chat musi obsługiwać powiązane zdarzenia interakcji, zwracając wystąpienieRenderActions
z navigacją updateCard
. Więcej informacji o obsługiwaniu widżetów interaktywnych znajdziesz w artykule Przetwarzanie informacji wprowadzanych przez użytkowników.
W poprzednim przykładzie początkowa karta aplikacji zawierała przycisk. Za każdym razem, gdy użytkownik kliknie ten przycisk, zdarzenie interakcji CARD_CLICKED
aktywuje funkcję updateAppHome
, która odświeża kartę strony głównej aplikacji, jak w tym kodzie:
Node.js
Python
Java
Google Apps Script
W tym przykładzie wysyłamy wiadomość z karty, zwracając obiekt JSON karty. Możesz też użyć usługi karty w Apps Script.
Otwórz okna
Aplikacja Google Chat może też reagować na interakcje w ekranie głównym aplikacji, otwierając dialogi.
Aby otworzyć okno ze strony głównej aplikacji, przetwórz powiązane zdarzenie interakcji, zwracając parametr renderActions
z nawigacją updateCard
, która zawiera obiekt Card
. W tym przykładzie aplikacja Google Chat reaguje na kliknięcie przycisku na karcie głównej aplikacji, przetwarzając zdarzenie interakcji CARD_CLICKED
i otwierając okno dialogowe:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
Aby zamknąć okno, przetwórz te zdarzenia interakcji:
CLOSE_DIALOG
: zamyka okno i zwraca do początkowej karty głównej aplikacji Google Chat.CLOSE_DIALOG_AND_EXECUTE
: zamyka okno i odświeża kartę główną aplikacji.
Ten przykładowy kod używa CLOSE_DIALOG
do zamknięcia okna i powrotu na stronę główną aplikacji:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Aby zbierać informacje od użytkowników, możesz też tworzyć dialogi sekwencyjne. Aby dowiedzieć się, jak tworzyć dialogi sekwencyjne, przeczytaj artykuł Otwieranie dialogów i odpowiadanie na nie.
Powiązane artykuły
- Zobacz przykłady aplikacji Google Chat, które korzystają z ekranu głównego aplikacji.
- Otwieranie i odpowiadanie na okna.