Süslü Metin

DecoratedText widget'ı, isteğe bağlı düzen ve işlev özelliklerine sahip metin gösterir. Örneğin:

• startIcon ile metnin önünde bir icon görüntüleyin.
• topLabel ifadesini içeren metnin önünde bir başlık gösterin.
• button ile tıklanabilir bir düğme veya switchControl ile değiştirilebilir düğme ekleyin.

Bilgileri, kullanımı kolay ve etkileşimli bir şekilde sunmanız gerektiğinde DecoratedText widget'ını kullanın. Widget; kişi kartları, sipariş durumu güncellemeleri ve iş bileti bildirimleri için idealdir.

Örnek: kişi kartı

Aşağıdaki resimde, e-posta adresi, bağlantı durumu, telefon numarası ve web sitesi gibi iletişim bilgilerini göstermek için kullanılan DecoratedText widget'ından oluşan bir kart gösterilmektedir.

Şekil 1: Google Chat'te "DeoratedText" widget'ını gösteren bir kart mesajı.

Kartın JSON'i şöyledir:

JSON

{
  "cardsV2": [
    {
      "cardId": "exampleCard",
      "card": {
        "sections": [
          {
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL",
                  },
                  "text": "[e-mail]",
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON",
                  },
                  "text": "<font color=\"#80e27e\">Online</font>",
                },
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE",
                  },
                  "text": "[phone]",
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "STAR",
                  },
                  "text": "<a href=\"https://developers.google.com/chat\">
                    Google Chat Developer Documentation</a>",
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

DecoratedText widget'ındaki metni biçimlendirme

DecoratedText widget'ı, basit metin HTML biçimlendirmesini destekler. Bu widget'ların metin içeriğini ayarlarken ilgili HTML etiketlerini eklemeniz yeterlidir. Aşağıdaki biçimler desteklenir:

Biçim	Örnek	Oluşturulan Sonuç
Kalın	<b>test</b>	test
İtalik	<i>test</i>	test
Altı çizili	<u>test</u>	test
Üstü Çizili	<s>test</s>	test
Yazı tipi rengi	<font color="#ea9999">test</font>	test
Köprü	<a href="https://www.google.com">google</a>	Google
Süre	<time>2020-02-16 15:00</time>	16.02.2020 15:00
Yeni satır	test <br> test	test test

DecoratedText JSON gösterimi ve alanları

JSON gösterimi
{ "icon": { object (Icon) }, "startIcon": { object (Icon) }, "topLabel": string, "text": string, "wrapText": boolean, "bottomLabel": string, "onClick": { object (OnClick) }, // Union field control can be only one of the following: "button": { object (Button) }, "switchControl": { object (SwitchControl) }, "endIcon": { object (Icon) } // End of list of possible types for union field control. }

Alanlar
icon (deprecated)	object ( Icon ) Bu öğe kullanımdan kaldırıldı! startIcon lehine kullanımdan kaldırıldı.
startIcon	object ( Icon ) Metnin önünde gösterilen simge.
topLabel	string text ifadesinin üzerinde görünen metin . Her zaman kırpılır.
text	string Zorunlu. Birincil metin. Basit biçimlendirmeyi destekler. Biçimlendirme ayrıntıları için Metin biçimlendirme bölümüne bakın.
wrapText	boolean Metin kaydırma ayarı. true metni ise sarmalanır ve birden fazla satırda gösterilir. Aksi takdirde metin kısaltılır. Yalnızca text için geçerlidir, topLabel ve bottomLabel için geçerli değildir.
bottomLabel	string Metnin altında görünen metin text . Her zaman kırpılır.
onClick	object ( OnClick ) Kullanıcılar topLabel veya bottomLabel öğesini tıkladığında bu işlem tetiklenir.
Birlik alanı control . decoratedText widget'ında, metnin sağ tarafında görünen bir düğme, anahtar, onay kutusu veya resim. control aşağıdakilerden yalnızca biri olabilir:
button	object ( Button ) Bir işlemi tetiklemek için tıklanabilen bir düğme.
switchControl	object ( SwitchControl ) Bir anahtar widget'ı, durumunu değiştirmek ve bir işlemi tetiklemek için tıklanabilir.
endIcon	object ( Icon ) Metinden sonra bir simge görüntülenir. Yerleşik ve özel simgeleri destekler.

Button JSON gösterimi ve alanları

JSON gösterimi
{ "text": string, "icon": { object (Icon) }, "color": { object (Color) }, "onClick": { object (OnClick) }, "disabled": boolean, "altText": string }

Alanlar
text	string Düğmenin içinde görüntülenen metin.
icon	object ( Icon ) Simge resmi. Hem icon hem de text ayarlanmışsa metinden önce simge görünür.
color	object ( Color ) Ayarlanırsa düğme düz bir arka plan rengiyle doldurulur ve arka plan rengiyle kontrastı korumak için yazı tipi rengi değişir. Örneğin, mavi bir arka plan ayarlamak büyük olasılıkla beyaz metne neden olacaktır. Bu politika ayarlanmadan bırakılırsa resim arka planı beyaz, yazı tipi rengi mavi olur. Kırmızı, yeşil ve mavi için her alanın değeri, iki şekilde ifade edilebilen bir float numarasıdır: 0 ile 255 arasında bir sayı, 255'e (153/255) bölünebilir veya 0 ile 1 (0,6) arasında bir değer olur. 0, bir rengin yokluğunu; 1 veya 255/255 de RGB ölçeğinde bu rengin tam varlığını belirtir. İsteğe bağlı olarak alfayı ayarlayın. Bu, şu denklemi kullanarak bir şeffaflık düzeyi belirler: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Alfa için 1 değeri tek bir renge, 0 değeri tamamen şeffaf bir renge karşılık gelir. Örneğin, aşağıdaki renk yarı saydam kırmızıyı temsil eder: "color": { "red": 1, "green": 0, "blue": 0, "alpha": 0.5 }
onClick	object ( OnClick ) Zorunlu. Düğme tıklandığında gerçekleştirilecek işlemdir (ör. köprü açma veya özel bir işlev çalıştırma).
disabled	boolean true düğmesi varsa düğme etkin değil durumunda gösterilir ve kullanıcı eylemlerine yanıt vermez.
altText	string Erişilebilirlik için kullanılan alternatif metin. Kullanıcılara düğmenin işlevini bildirin. Örneğin, bir düğme köprü açarsa şunu yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/chat" adresindeki Google Chat geliştirici belgelerine gider.

Icon

Karttaki bir widget'ta gösterilen simge.

Yerleşik ve özel simgeleri destekler.

JSON gösterimi
{ "altText": string, "imageType": enum (ImageType), // Union field icons can be only one of the following: "knownIcon": string, "iconUrl": string // End of list of possible types for union field icons. }

Alanlar
altText	string İsteğe bağlı. Erişilebilirlik için kullanılan simgenin açıklaması. Belirtilmemesi durumunda varsayılan değer "Düğme" olarak sağlanmıştır. En iyi uygulama olarak, simgenin gösterdiği şeyler ve (varsa) ne işe yaradığı hakkında faydalı bir açıklama belirlemeniz gerekir. Örneğin, A user's account portrait veya Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat . Simge bir Button içinde ayarlanırsa kullanıcı fareyle üzerine geldiğinde altText yardımcı metin olarak görünür. Bununla birlikte, düğme text olarak ayarlanırsa simgenin altText simgesi yok sayılır.
imageType	enum ( ImageType ) Resme uygulanan kırpma stili. Bazı durumlarda CIRCLE kırpma uygulamak, görüntünün yerleşik bir simgeden daha büyük çizilmesine neden olur.
Birlik alanı icons . Karttaki widget'ta gösterilen simge. icons aşağıdakilerden yalnızca biri olabilir:
knownIcon	string Google Workspace tarafından sağlanan yerleşik simgelerden birini görüntüleyin. Örneğin, bir uçak simgesi görüntülemek için AIRPLANE değerini belirtin. Otobüs için BUS değerini belirtin. Desteklenen simgelerin tam listesi için yerleşik simgeler bölümüne bakın.
iconUrl	string HTTPS URL'sinde barındırılan bir özel simge görüntüleyin. Örneğin: "iconUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png" Desteklenen dosya türleri şunları içerir: .png ve .jpg .

ImageType

Resmi kırpmak için kullanılan şekil.

Sıralamalar
SQUARE	Varsayılan değer. Resme kare maske ekler. Örneğin, 4x3 boyutunda bir resim 3x3 olur.
CIRCLE	Görsele dairesel bir maske uygular. Örneğin, 4x3 boyutunda bir resim çapı 3 olan bir daire haline gelir.

Onclick

Kullanıcılar, karttaki etkileşimli bir öğeyi (ör. bir düğmeyi) tıkladıklarında nasıl yanıt vereceklerini temsil eder.

JSON gösterimi
{ // Union field data can be only one of the following: "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) } // End of list of possible types for union field data. }

Alanlar
Birlik alanı data . data aşağıdakilerden yalnızca biri olabilir:
action	object ( Action ) Belirtilirse bu onClick tarafından bir işlem tetiklenir.
openLink	object ( OpenLink ) Belirtilirse bu onClick , bir açık bağlantı işlemi tetikler.
openDynamicLinkAction	object ( Action ) Eklenti, bağlantının açılması gerektiğinde bu işlemi tetikler. Bu, bağlantıyı almak için sunucuyla iletişim kurulması gerektiği için yukarıdaki openLink 'den farklıdır. Dolayısıyla, web istemcisinin açık bağlantı işlemi yanıtı döndürülmeden önce bazı hazırlık çalışmaları yapması gerekir.
card	object ( Card ) Belirtilirse, tıklama işleminden sonra kart yığınına yeni bir kart aktarılır. Google Workspace eklentileri tarafından desteklenir ancak Chat uygulamaları tarafından desteklenmez.

Action

Form gönderildiğinde davranışı açıklayan bir işlem. Örneğin, formu işlemek için Apps Komut Dosyası çağırılabilir. İşlem tetiklenirse form değerleri sunucuya gönderilir.

JSON gösterimi
{ "function": string, "parameters": [ { object (ActionParameter) } ], "loadIndicator": enum (LoadIndicator), "persistValues": boolean, "interaction": enum (Interaction) }

Alanlar
function	string Kapsayıcı öğe tıklandığında veya alt özellik etkinleştirildiğinde çağrılan özel işlev. Örneğin, Etkileşimli kart oluşturma bölümüne göz atın.
parameters[]	object ( ActionParameter ) İşlem parametrelerinin listesi.
loadIndicator	enum ( LoadIndicator ) Harekete geçirici mesaj gösterilirken işlemin gösterdiği yükleme göstergesini belirtir.
persistValues	boolean Form değerlerinin işlemden sonra da devam edip etmediğini belirtir. Varsayılan değer: false . true değeri belirlenirse form değerleri işlem tetiklendikten sonra da kalır. Kullanıcının işlem sırasında değişiklik yapmasına izin vermek için LoadEndator değerini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin Yanıt Türü 'nü UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId cardId özelliğini kullanmanız gerekir. false değeri belirlenirse işlem tetiklendiğinde form değerleri temizlenir. İşlem sırasında kullanıcının değişiklik yapmasını engellemek için LoadEndator değerini SPINNER olarak ayarlayın.
interaction	enum ( Interaction ) İsteğe bağlı. İletişim kutusu açılırken gerekir. Bir kullanıcının etkileşimine yanıt olarak yapılması gerekenler (ör. bir kullanıcı, kart mesajındaki düğmeyi tıkladığında). Belirtilmemesi halinde uygulama, normal şekilde bir action işlemi (bağlantı açma veya bir işlevi çalıştırma gibi) çalıştırarak yanıt verir. Uygulama, interaction belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction öğesini OPEN_DIALOG olarak ayarladığınızda, uygulama bir iletişim kutusu açabilir. Belirtildiğinde yükleme göstergesi gösterilmez. Chat uygulamaları tarafından desteklenir ancak Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez.

ActionParameter

İşlem yöntemi çağrıldığında verilecek dize parametrelerinin listesi. Örneğin, şu üç erteleme düğmesini kullanabilirsiniz: "ertele", "1 gün ertele", "ertesi hafta ertele". Dize parametreleri listesinde erteleme türünü ve erteleme zamanını ileterek işlem yöntemi = pause() işlemini kullanabilirsiniz.

Daha fazla bilgi için CommonEventObject bölümüne bakın.

JSON gösterimi
{ "key": string, "value": string }

Alanlar
key	string İşlem komut dosyası için parametrenin adı.
value	string Parametrenin değeri.

LoadIndicator

Harekete geçirici mesaj gösterilirken işlemin gösterdiği yükleme göstergesini belirtir.

Sıralamalar
SPINNER	İçeriğin yüklendiğini belirtmek için bir döner simge görüntüler.
NONE	Hiçbir şey gösterilmez.

Interaction

İsteğe bağlı. İletişim kutusu açılırken gerekir.

Bir kullanıcının etkileşimine yanıt olarak yapılması gerekenler (ör. bir kullanıcı, kart mesajındaki düğmeyi tıkladığında).

Belirtilmemesi halinde uygulama, normal şekilde bir action işlemi (bağlantı açma veya bir işlevi çalıştırma gibi) çalıştırarak yanıt verir.

Uygulama, interaction belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction öğesini OPEN_DIALOG olarak ayarladığınızda, uygulama bir iletişim kutusu açabilir.

Belirtildiğinde yükleme göstergesi gösterilmez.

Chat uygulamaları tarafından desteklenir ancak Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez.

Sıralamalar
INTERACTION_UNSPECIFIED	Varsayılan değer. action normal şekilde çalışır.
OPEN_DIALOG	Chat uygulamalarının kullanıcılarla etkileşim kurmak için kullandığı, pencereye dayalı, kart tabanlı bir arayüz olan iletişim kutusunu açar. Yalnızca kart mesajlarındaki düğme tıklamalarına yanıt olarak Chat uygulamaları tarafından desteklenir. Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez.

OpenLink

Bir köprünün açıldığı onClick etkinliğini temsil eder.

JSON gösterimi
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

Alanlar
url	string Açılacak URL.
openAs	enum ( OpenAs ) Bağlantı nasıl açılır? Chat uygulamaları tarafından desteklenmez.
onClose	enum ( OnClose ) İstemcinin bir bağlantıyı açtıktan sonra unutup unutmadığı veya pencere kapanıncaya kadar gözlemleyip gözlemlemeyeceği. Chat uygulamaları tarafından desteklenmez.