Criar os componentes de um cartão ou caixa de diálogo

Nesta página, descrevemos como projetar e criar os principais componentes da interface das mensagens de cartão no Google Chat.

Cards são compatíveis com layout definido, elementos de interface interativos, como botões, e rich media, como imagens. Use cards para apresentar informações, coletar entradas ou informar as próximas etapas aos usuários por mensagens de cards e caixas de diálogo.

Use o Card Builder para criar e visualizar mensagens de cards JSON para apps do Chat:

Abrir o Card Builder

Cards e caixas de diálogo geralmente têm os seguintes componentes:

  • Um CardHeader que contém o título do seu cartão.
  • Um ou mais widgets CardSection que formam o corpo principal do card.
  • Um widget CardFixedFooter específico apenas para caixas de diálogo.

Pré-requisitos

  • Uma conta do Google Workspace com acesso ao Google Chat.
  • Um app do Chat publicado. Para criar um app do Chat, siga este quickstart.

    • Adicionar um cabeçalho

    O widget CardHeader representa o cabeçalho de um card. Os cabeçalhos podem incluir um título, um subtítulo e uma imagem de avatar para o cartão.

    Você pode incluir CardHeader para mensagens do card e caixas de diálogo.

    Veja a seguir um exemplo de CardHeader:

    Definir uma seção de um card

    O widget CardSection é um contêiner de alto nível em um card. Você pode usar seções de cards para agrupar widgets em um card. Para cada seção do card, você pode incluir um cabeçalho e um ou mais widgets.

    Você pode incluir CardSection para mensagens do card e caixas de diálogo.

    Confira abaixo um exemplo de CardSection que contém dois widgets textParagraph:

    O widget CardFixedFooter representa o rodapé de uma mensagem de caixa de diálogo enviada por um app do Chat. Os rodapés podem incluir um botão principal e um secundário.

    O widget CardFixedFooter está disponível apenas para caixas de diálogo.

    Este é um exemplo de um widget CardFixedFooter com dois botões:

    Resolver problemas

    Quando um app ou card do Google Chat retorna um erro, a interface do Chat mostra uma mensagem dizendo "Algo deu errado". ou "Não foi possível processar sua solicitação". Às vezes, a interface do Chat não exibe nenhuma mensagem de erro, mas o app ou card produz um resultado inesperado. Por exemplo, uma mensagem de card pode não aparecer.

    Embora uma mensagem de erro possa não ser exibida na interface do Chat, mensagens de erro descritivas e dados de registro estão disponíveis para ajudar você a corrigir erros quando a geração de registros de erros para apps do Chat está ativada. Se precisar de ajuda para visualizar, depurar e corrigir erros, consulte Resolver problemas e corrigir erros do Google Chat.