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

Um app do Google Chat com recursos interativos ativados. Para criar um interativo do Chat, conclua um dos seguintes guias de início rápido com base na arquitetura do app que você quer usar:

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 geral em um card. Você usa um cartão para agrupar widgets em um card. Em cada seção do card, 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.