Bir kartın veya iletişim kutusunun bileşenlerini tasarlama

Bu sayfada, Google Chat'te kart mesajlarının ana kullanıcı arayüzü bileşenlerinin nasıl tasarlanacağı ve oluşturulacağı açıklanmaktadır.

Kartlar tanımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi rich media öğelerini destekler. Bilgi sunmak, giriş toplamak veya kart mesajları ve iletişim kutuları aracılığıyla kullanıcılara sonraki adımları sunmak için kartları kullanabilirsiniz.

Chat uygulamaları için JSON kart mesajları tasarlayıp önizlemek üzere Kart Oluşturucu'yu kullanın:

Kart Oluşturucu'yu açın

Kartlar ve iletişim kutuları genellikle aşağıdaki bileşenlere sahiptir:

  • Kartınızın başlığını içeren CardHeader.
  • Kartın ana gövdesini oluşturan bir veya daha fazla CardSection widget'ı.
  • Yalnızca iletişim kutularına özel bir CardFixedFooter widget'ı.

Ön koşullar

  • Google Chat'e erişimi olan bir Google Workspace hesabı.
  • Yayınlanan bir Chat uygulamasıdır. Chat uygulaması oluşturmak için bu quickstart takip edin.

    • Başlık ekleme

    CardHeader widget'ı, bir kartın başlığını temsil eder. Başlıklar, kartınız için bir başlık, alt başlık ve avatar resmi içerebilir.

    Kart mesajları ve iletişim kutuları için CardHeader ekleyebilirsiniz.

    Aşağıda bir CardHeader örneği verilmiştir:

    Kartın bir bölümünü tanımlayın

    CardSection widget'ı, bir kart içinde üst düzey bir kapsayıcıdır. Bir kart içindeki widget'ları gruplandırmak için kart bölümlerini kullanabilirsiniz. Her kart bölümü için bir başlık ve bir veya daha fazla widget ekleyebilirsiniz.

    Kart mesajları ve iletişim kutuları için CardSection ekleyebilirsiniz.

    Aşağıda, iki textParagraph widget'ı içeren bir CardSection örneği verilmiştir:

    CardFixedFooter widget'ı, bir Chat uygulaması tarafından gönderilen iletişim mesajının altbilgisini temsil eder. Altbilgiler, birincil ve ikincil düğme içerebilir.

    CardFixedFooter widget'ı yalnızca iletişim kutuları için kullanılabilir.

    Aşağıda, iki düğmeli bir CardFixedFooter widget'ı örneği verilmiştir:

    Sorun giderme

    Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu" mesajı gösterilir. veya "İsteğiniz işlenemiyor." Bazı durumlarda Chat kullanıcı arayüzünde herhangi bir hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç verir. Örneğin, kart mesajı görünmeyebilir.

    Chat kullanıcı arayüzünde hata mesajı görüntülenmese de Chat uygulamaları için hata günlük kaydı etkinleştirildiğinde hataları düzeltmenize yardımcı olmak amacıyla açıklayıcı hata mesajları ve günlük verileri sunulur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım almak için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.