Na tej stronie dowiesz się, jak zaprojektować i utworzyć główne komponenty UI karty wiadomości w Google Chat.
Karty obsługują zdefiniowany układ, interaktywnych elementów interfejsu, takich jak przyciski; multimediów, takich jak obrazy. Możesz używać kart do prezentowania informacji, zbierania danych lub wskazać użytkownikom kolejne kroki wiadomości z kart oraz okna dialogowe.
Za pomocą kreatora kart możesz zaprojektować i wyświetlić podgląd wiadomości kart JSON przeznaczonych do aplikacji Google Chat:
Otwórz kreator kartKarty i okna dialogowe zwykle zawierają te komponenty:
CardHeader
z tytułem karty.- Co najmniej jeden widżet
CardSection
, który tworzy główny element karty. - Widżet
CardFixedFooter
przeznaczony tylko do okna dialogowego.
Wymagania wstępne
Aplikacja Google Chat, w której można korzystać z funkcji interaktywnych. Aby utworzyć interaktywna aplikacja do obsługi czatu, wykonaj jedno z tych krótkich wprowadzeń dotyczące architektury aplikacji, której chcesz używać:
- Usługa HTTP z Google Cloud Functions.
- Skrypt Google Apps Script
- Google Cloud Dialogflow CX,
- Google Cloud Pub/Sub
Dodaj nagłówek
Widżet CardHeader
reprezentuje nagłówek karty. Nagłówki mogą zawierać
tytuł, podtytuł oraz awatara karty.
Możesz uwzględnić CardHeader
w tych usługach:
wiadomości z kart i
okna dialogowe.
Oto przykład właściwości CardHeader
:
Zdefiniuj sekcję karty
Widżet CardSection
to
kontener wysokiego poziomu na karcie. Korzystasz z karty
aby zgrupować widżety na karcie. W każdej sekcji karty możesz dodać
nagłówek i co najmniej jeden widżet.
Możesz uwzględnić CardSection
w tych usługach:
wiadomości z kart i
okna dialogowe.
Oto przykład danych CardSection
, które zawierają dwa textParagraph
widżety:
Dodawanie stałej stopki
CardFixedFooter
widżet reprezentuje stopkę wiadomości dialogowej wysłanej przez
aplikacji do obsługi czatu.
Stopki mogą zawierać przyciski główne i dodatkowe.
Widżet CardFixedFooter
jest dostępny tylko dla
okna dialogowe.
Poniżej znajdziesz przykład widżetu CardFixedFooter
z 2 przyciskami:
Rozwiązywanie problemów
Gdy aplikacja Google Chat lub card zwraca błąd, Interfejs czatu wyświetla komunikat „Coś poszło nie tak”. lub „Nie można przetworzyć żądania”. Czasami interfejs Google Chat nie wyświetla się żaden komunikat o błędzie, ale aplikacja Google Chat lub zwraca nieoczekiwany wynik; na przykład wiadomość w formie karty .
Komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w naprawianiu błędów gdy logowanie błędów aplikacji Google Chat jest włączone. Aby uzyskać pomoc w wyświetlaniu, debugowania i naprawiania błędów, zapoznaj się z artykułem Rozwiązywanie problemów z błędami w Google Chat