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 BuilderCards 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:
- Serviço HTTP com o Google Cloud Functions
- Google Apps Script
- Dialogflow CX do Google Cloud
- Google Cloud Pub/Sub
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:
Adicionar um rodapé permanente
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.