Google Chat mesajlarına genel bakış

Bu sayfada, kısa mesajlar ile 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. Metinden daha fazlasını içeren mesajlar oluşturmak veya kullanıcıların etkileşimde bulunabileceği mesajlar, Chat uygulamaları kartlar kullanın. 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 iletide kısa mesaj şu şekilde gösterilir: text nesnesini tanımlayın.

Sonraki Örneğin, bir Chat uygulaması, alanda kısa mesaj oluşturuyor. yaklaşmakta olan bir yazılım geliştiriciler ekibi için:

{
  "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. Mesaj içinde Kart, bir kart cardsV2 dizisidir ve aşağıdakilerden oluşur:

  • Bir veya daha fazla CardWithId nesne.
  • 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:

    • header nesnesi başlık, alt başlık ve avatar stili resim gibi öğeleri belirten bir dizi reklam içerir.
    • Bir veya daha fazla section nesne her biri en az bir widget içermelidir.
    • 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ında header section ve widget nesne:

Chat&#39;te anket çalıştıran bir Chat uygulaması kart kullanılan alan mesaj

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 JSON kart mesajları tasarlayıp önizlemek üzere Kart Oluşturucu'yu kullanın:

Kart Oluşturucu'yu açın