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

Esta página descreve como projetar e criar os principais componentes de IU de cartões mensagens no Google Chat.

Os cards são compatíveis com um layout definido. elementos interativos da IU, como botões e rich media, como imagens. Você pode usar cards para apresentar informações, coletar entradas, ou informar as próximas etapas aos usuários mensagens do cartão 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 a Google Chat.
  • Um app do Chat publicado. Para criar um App do Chat, siga este guia de início rápido.

    • Adicionar um cabeçalho

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

    Você pode incluir CardHeader para mensagens do cartão 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 cartão. Você usa um cartão para agrupar widgets em um card. Em cada seção do cartão, você pode incluir um cabeçalho e um ou mais widgets.

    Você pode incluir CardSection para mensagens do cartão e caixas de diálogo.

    Este é um exemplo de CardSection que contém duas textParagraph widgets:

    O CardFixedFooter representa o rodapé de uma mensagem de caixa de diálogo enviada pelo um app do Chat. Os rodapés podem incluir um botão principal e um botão 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 retornar um erro, o A interface do chat mostra a mensagem "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 do Chat ou produz um resultado inesperado; por exemplo, uma mensagem de cartão pode não aparecer.

    Embora uma mensagem de erro possa não aparecer na interface do Chat, mensagens de erro descritivas e dados de registro estão disponíveis para ajudar você a corrigir os erros quando a geração de registros de erros nos apps do Chat está ativada. Para receber ajuda com a visualização, depurar e corrigir erros, consulte Resolver problemas e corrigir erros do Google Chat.