Projektowanie komponentów karty lub okna

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 kart

Karty 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

  • konto Google Workspace, z dostępem do Google Chat.
  • Opublikowaną aplikację Google Chat. Aby utworzyć Aplikacja Google Chat, obserwuj krótkie wprowadzenie.

    • 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:

    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