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.
Na stronie głównej aplikacji możesz udostępniać porady dotyczące interakcji z aplikacją Google Chat lub zezwalać użytkownikom na 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 można korzystać z funkcji interaktywnych. 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ć interaktywna aplikacja do obsługi czatu przy użyciu usługi HTTP zapoznaj się z tym krótkim wprowadzeniem.
Java
Aplikacja Google Chat, w której włączono funkcje interaktywne. Aby utworzyć interaktywna aplikacja do obsługi czatu przy użyciu usługi HTTP zapoznaj się z tym krótkim wprowadzeniem.
Google Apps Script
Aplikacja Google Chat, w której można korzystać z funkcji interaktywnych. Aby utworzyć interaktywną aplikację Google Chat w Apps Script, wykonaj te czynności.
Konfigurowanie ekranu głównego aplikacji Google Chat
Aby umożliwić korzystanie z ekranu głównego aplikacji, musisz skonfigurować aplikację Google Chat tak, aby odbierała APP_HOME
zdarzenia interakcji. Aplikacja Google Chat otrzymuje to zdarzenie za każdym razem, gdy użytkownik kliknie kartę Ekran główny 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 następnie 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 Pomoc techniczna App Home.
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ć tego samego adresu URL, który został podany w polu URL punktu końcowego HTTP.
Kliknij Zapisz.
Utwórz kartę strony głównej aplikacji
Gdy użytkownik otworzy ekran główny aplikacji, aplikacja Google Chat musi obsłużyć
zdarzenie interakcji APP_HOME
przez zwrócenie wystąpienia
RenderActions
z nawigacją pushCard
i
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 przykładzie poniżej aplikacja Google Chat wyświetla pierwszą kartę strony głównej aplikacji, która zawiera godzinę 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 jest 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 Usługa karty Apps Script.
reagować na interakcje z ekranem 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. Kiedykolwiek
użytkownik klika przycisk, zdarzenia interakcji CARD_CLICKED
.
wyzwala funkcję updateAppHome
odświeżającą kartę strony głównej aplikacji, jak pokazano
w tym kodzie:
Node.js
Python
Java
Google Apps Script
Ten przykładowy kod karty wysyła wiadomość przez zwrócenie card JSON. Możesz też użyć usługi Usługa karty 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 według
zwracanie funkcji renderActions
z nawigacją updateCard
, która zawiera Card
obiektu. 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 wraca do Pierwsza karta główna aplikacji Google Chat.CLOSE_DIALOG_AND_EXECUTE
: zamyka okno i odświeża stronę główną aplikacji
W tym przykładowym kodzie do zamykania okna dialogowego i powrotu do karty głównej aplikacji służy metoda CLOSE_DIALOG
:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Aby zbierać informacje od użytkowników, możesz też tworzyć dialogi sekwencyjne. Do dowiedz się, jak tworzyć sekwencyjne okna dialogowe, zobacz Otwieranie okien i odpowiadanie na nie
Powiązane artykuły
- Zobacz przykładowe aplikacje do obsługi czatu, które używają strony głównej aplikacji.
- Otwieranie i odpowiadanie na okna dialogowe