Google Chat mesajlarına genel bakış

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

Chat uygulamaları temel bilgileri aktarmak için kısa mesaj gönderdiğinde Bu mesajlar, Google Chat'teki kullanıcıların yazdıkları metinlere benzer şekilde satır içinde mesaj. 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ı, kart içeren bir kısa mesaj da ekleyebilir. Alıcı: Kullanıcılardan, form doldurma, form doldurma, Sohbet uygulamaları ayrıca yeni bir pencerede açılan kartlar da oluşturabilir: iletişim kutuları.

Kısa mesajı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 bir 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 kodun dondurmasını bildiren ö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 ve belirli bir mesaj kapsamında yer almak için kullanılan cardId. (Farklı mesajlardaki kartların kimliği aynı olabilir.)

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

    • Başlık, altyazı ve avatar tarzı 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 nesne. Her widget; metin, resim ve görünümlerinizi temsil edebilen ve diğer nesne türlerini kapsar.

Ö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çın