Google Chat mesajlarına genel bakış

Bu sayfada, metin ve kart mesajları arasındaki farklar açıklanmaktadır.

Chat uygulamaları, temel bilgileri iletmek için kısa mesaj gönderdiğinde mesajlar, Google Chat'teki kullanıcıların mesaj yazdığı gibi satır içi olarak görünür. Chat uygulamaları, metinden daha fazlasını içeren veya kullanıcıların etkileşim kurabileceği mesajlar oluşturmak için kartlar kullanabilir. Sohbet uygulamaları, kartla birlikte kısa mesaj da ekleyebilir. Chat uygulamaları, kullanıcıların form doldurma gibi çok adımlı işlemleri tamamlamasını istemek için iletişim kutusu olarak yeni bir pencerede açılan kartlar da oluşturabilir.

Kısa mesajların anatomisi

Google Chat API'de mesajlar JSON nesneleri olarak temsil edilir. Bir ileti içinde kısa mesaj, text nesnesi olarak temsil edilir.

Aşağıdaki örnekte, bir Chat uygulaması, yazılım geliştirici ekibi için bir alanda kod dondurma işleminin yaklaştığına dair kısa mesaj oluşturur:

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

JSON aşağıdaki mesajı döndürür:

Google Chat&#39;te kod dondurulmasını duyuran örnek kısa mesaj.

Kart mesajının anatomisi

Google Chat API'de mesajlar JSON nesneleri olarak temsil edilir. Bir mesajdaki kart, cardsV2 dizisi olarak temsil edilir ve aşağıdakilerden oluşur:

  • Bir veya daha fazla CardWithId nesnesi.
  • Kartı tanımlamak için kullanılan ve belirli bir ileti kapsamında olan bir cardId. (Farklı iletilerdeki kartlar aynı kimliğe sahip olabilir.)

  • Aşağıdakilerden oluşan bir card nesnesi:

    • Başlık, altyazı ve avatar stilinde resim gibi öğeleri belirten bir header nesnesi.
    • Her biri en az bir widget içeren bir veya daha fazla section nesnesi.
    • Bir veya daha fazla widget nesnesi. Her widget, metin, resim, düğme ve diğer nesne türlerini temsil edebilen birleşik bir nesnedir.

Örneğin, aşağıdaki kart mesajı header, section ve widget nesnelerini içerir:

Kart mesajı kullanarak Chat alanında anket yapan bir Chat uygulaması

Aşağıdaki kod, kart mesajının JSON'unu temsil eder:

JSON

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
          "title": "Sasha",
          "subtitle": "Software Engineer",
          "imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
          "imageType": "CIRCLE",
          "imageAltText": "Avatar for Sasha"
        },
        "sections": [
          {
            "header": "Contact Info",
            "collapsible": true,
            "uncollapsibleWidgetsCount": 1,
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL"
                  },
                  "text": "sasha@example.com"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON"
                  },
                  "text": "<font color=\"#80e27e\">Online</font>"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE"
                  },
                  "text": "+1 (555) 555-1234"
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Share",
                      "onClick": {
                        "openLink": {
                          "url": "https://example.com/share"
                        }
                      }
                    },
                    {
                      "text": "Edit",
                      "onClick": {
                        "action": {
                          "function": "goToView",
                          "parameters": [
                            {
                              "key": "viewType",
                              "value": "EDIT"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Chat uygulamaları için mesajlaşma ve kullanıcı arayüzlerini tasarlamak ve önizlemek üzere Kart Oluşturucu'yu kullanın:

Kart Oluşturucu'yu açma