Package google.apps.card.v1

Dizin

İşlem

Form gönderilirken davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası komut dosyası çağırabilirsiniz. İşlem tetiklenirse form değerleri sunucuya gönderilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
function

string

İçerdiği öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel işlev.

Örnek kullanım için Form verilerini okuma başlıklı makaleyi inceleyin.

parameters[]

ActionParameter

İşlem parametrelerinin listesi.

loadIndicator

LoadIndicator

Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.

persistValues

bool

Form değerlerinin işlemden sonra devam edip etmediğini belirtir. Varsayılan değer: false.

true ise işlem tetiklendikten sonra form değerleri kalır. İşlem işlenirken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator değerini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki card_id değerini kullanmanız da gerekir.

false ise işlem tetiklendiğinde form değerleri temizlenir. İşlem işlenirken kullanıcının değişiklik yapmasını önlemek için LoadIndicator değerini SPINNER olarak ayarlayın.

interaction

Interaction

İsteğe bağlı. İletişim kutusu açarken gereklidir.

Kullanıcıyla etkileşime (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılacak işlem.

Belirtilmemişse uygulama, normal şekilde bir action (ör. bağlantı açma veya işlev çalıştırma) yürüterek yanıt verir.

Uygulama, interaction belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction değerini OPEN_DIALOG olarak ayarlayarak uygulama bir iletişim kutusu açabilir. Belirtilen durumlarda yükleme göstergesi gösterilmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

requiredWidgets[]

string

İsteğe bağlı. Bu listeyi, geçerli bir gönderim için bu işlemin ihtiyaç duyduğu widget'ların adlarıyla doldurun.

Bu işlem çağrıldığında burada listelenen widget'ların değeri yoksa form gönderimi iptal edilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

allWidgetsAreRequired

bool

İsteğe bağlı. Bu doğruysa tüm widget'lar bu işlem için gerekli olarak kabul edilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

ActionParameter

İşlem yöntemi çağrıldığında sağlanacak dize parametrelerinin listesi. Örneğin, üç erteleme düğmesi düşünelim: şimdi erteleme, bir gün erteleme veya gelecek hafta erteleme. action method = snooze() değerini kullanarak, ertele türünü ve ertele süresini dize parametreleri listesine iletebilirsiniz.

Daha fazla bilgi için CommonEventObject sayfasına bakın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
key

string

İşlem komut dosyası için parametrenin adı.

value

string

Parametrenin değeri.

Etkileşim

İsteğe bağlı. İletişim kutusu açarken gereklidir.

Kullanıcıyla etkileşime (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılacak işlem.

Belirtilmemişse uygulama, normal şekilde bir action (ör. bağlantı açma veya işlev çalıştırma) yürüterek yanıt verir.

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

Belirtilen durumlarda yükleme göstergesi gösterilmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Sıralamalar
INTERACTION_UNSPECIFIED Varsayılan değer. action normal şekilde yürütülür.
OPEN_DIALOG

Chat uygulamalarının kullanıcılarla etkileşime geçmek için kullandığı pencereli, karta dayalı 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. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

LoadIndicator

Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
SPINNER İçeriğin yüklendiğini belirten bir dönen simge gösterir.
NONE Hiçbir şey gösterilmez.

BorderStyle

Kenarlık türü ve rengi dahil olmak üzere bir kartın veya widget'ın kenarlığı için stil seçenekleri.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
type

BorderType

Kenarlık türü.

strokeColor

Color

Tür BORDER_TYPE_STROKE olduğunda kullanılacak renkler.

Satır rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Bu değerde 0 (0/255), rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıdaki ifade rengi maksimum yoğunlukta kırmızı olarak ayarlar:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

alpha alanı, satır rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.

cornerRadius

int32

Kenarlık için köşe yarıçapı.

BorderType

Widget'lara uygulanan kenar türünü temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
BORDER_TYPE_UNSPECIFIED Kullanmayın. Belirtilmedi.
NO_BORDER Varsayılan değer. Kenarlık yok.
STROKE Ana hat.

Düğme

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge düğmesi. Google Chat uygulamalarında örnek için Düğme ekleme bölümüne bakın.

Bir resmi tıklanabilir bir düğme yapmak için Image (ImageComponent değil) belirtin ve bir onClick işlemi ayarlayın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
text

string

Düğmenin içinde gösterilen metin.

icon

Icon

Düğmenin içinde gösterilen simge. Hem icon hem de text ayarlanırsa simge metnin önünde görünür.

color

Color

İsteğe bağlı. Düğmenin rengi. Bu ayar etkinleştirilirse type düğmesi FILLED olarak ayarlanır ve text ile icon alanlarının rengi, okunabilirlik için zıt bir renge ayarlanır. Örneğin, düğme rengi mavi olarak ayarlanırsa düğmedeki metinler veya simgeler beyaz olarak ayarlanır.

Düğme rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Bu değerde 0 (0/255), rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıdaki ifade rengi maksimum yoğunlukta kırmızı olarak ayarlar:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

alpha alanı, düğme rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.

onClick

OnClick

Zorunlu. Kullanıcı düğmeyi tıkladığında yapılacak işlem (ör. köprü açma veya özel işlev çalıştırma).

disabled

bool

true ise düğme etkin olmayan bir durumda gösterilir ve kullanıcı işlemlerine yanıt vermez.

altText

string

Erişilebilirlik için kullanılan alternatif metin.

Kullanıcılara düğmenin ne işe yaradığını bildiren açıklayıcı bir metin ayarlayın. Örneğin, bir düğme köprü bağlantısı açıyorsa şunu yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider.

type

Type

İsteğe bağlı. Düğmenin türü. Ayarlanmazsa düğme türü varsayılan olarak OUTLINED olur. color alanı ayarlanırsa düğme türü FILLED olarak zorlanır ve bu alan için ayarlanan tüm değerler yoksayılır.

Tür

İsteğe bağlı. Düğmenin türü. color alanı ayarlandıysa type alanı FILLED olarak ayarlanır.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Sıralamalar
TYPE_UNSPECIFIED Kullanmayın. Belirtilmedi.
OUTLINED Dış çizgili düğmeler, orta düzeyde vurgulu düğmelerdir. Bunlar genellikle önemli olan ancak Chat uygulamasında veya eklentisinde birincil işlem olmayan işlemleri içerir.
FILLED Doldurulmuş düğmelerde düz renkli bir kapsayıcı bulunur. En fazla görsel etkiye sahiptir ve Chat uygulamasında veya eklentisinde önemli ve birincil işlem için önerilir.
FILLED_TONAL Doldurulmuş tonlu düğme, doldurulmuş ve kenarlıklandırılmış düğmeler arasında alternatif bir orta yoldur. Düşük öncelikli bir düğmenin, ana hat düğmesinin sağlayacağından biraz daha fazla vurgu gerektirdiği durumlarda faydalıdır.
BORDERLESS Düğmenin varsayılan durumunda görünmez kapsayıcı yoktur. Genellikle en düşük öncelikli işlemler için kullanılır. Özellikle birden fazla seçenek sunulduğunda bu simge kullanılır.

ButtonList

Yatay olarak yerleştirilmiş düğmelerin listesi. Google Chat uygulamalarında örnek için Düğme ekleme bölümüne bakın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
buttons[]

Button

Düğme dizisi.

Kart

Google Chat mesajında veya Google Workspace eklentisinde gösterilen kart arayüzü.

Kartlar, tanımlanmış bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi zengin medyayı destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma yönlendirmek için kartlardan yararlanın.

Kart Oluşturucu ile kart tasarlayın ve önizleyin.

Kart Oluşturucu'yu açma

Kart oluşturmayı öğrenmek için aşağıdaki dokümanlara göz atın:

Not: Kart başına en fazla 100 widget ekleyebilirsiniz. Bu sınırı aşan widget'lar yok sayılır. Bu sınır, hem Google Chat uygulamalarındaki kart mesajları ve iletişim kutuları hem de Google Workspace eklentilerindeki kartlar için geçerlidir.

Örnek: Google Chat uygulaması için kart mesajı

Örnek kişi kartı

Google Chat'te örnek kart mesajını oluşturmak için aşağıdaki JSON'u kullanın:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/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"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
Alanlar
header

CardHeader

Kartın başlığı. Başlıklar genellikle bir resim ve başlık içerir. Üstbilgiler her zaman kartın üst kısmında görünür.

sections[]

Section

Bir widget koleksiyonu içerir. Her bölümün isteğe bağlı bir başlığı vardır. Bölümler, görsel olarak bir çizgiyle ayrılır. Google Chat uygulamalarında bir örnek için Kart bölümünü tanımlama bölümüne bakın.

sectionDividerStyle

DividerStyle

Başlık, bölümler ve alt bilgi arasındaki ayırıcı stili.

cardActions[]

CardAction

Kartın işlemleri. İşlemler kartın araç çubuğu menüsüne eklenir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Örneğin, aşağıdaki JSON, Settings ve Send Feedback seçenekleri içeren bir kart işlem menüsü oluşturur:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

Kartın adı. Kart gezinmesinde kart tanımlayıcısı olarak kullanılır.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

fixedFooter

CardFixedFooter

Bu kartın alt kısmında gösterilen sabit altbilgi.

primaryButton veya secondaryButton belirtmeden fixedFooter ayarlamak hataya neden olur. Chat uygulamalarında iletişim kutularında sabit altbilgi kullanabilirsiniz ancak kart mesajlarında kullanamazsınız.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

displayStyle

DisplayStyle

Google Workspace eklentilerinde peekCardHeader öğesinin görüntüleme özelliklerini belirler.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

peekCardHeader

CardHeader

İçeriğe dayalı içerikler gösterilirken göz atma kartı başlığı, kullanıcının ana sayfa kartları ile içeriğe dayalı kartlar arasında ileri geri gezinebilmesi için yer tutucu görevi görür.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

CardAction

Kart işlemi, kartla ilişkili işlemdir. Örneğin, bir fatura kartı; faturayı silme, faturayı e-postayla gönderme veya faturayı bir tarayıcıda açma gibi işlemler içerebilir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Alanlar
actionLabel

string

İşlem menüsü öğesi olarak gösterilen etiket.

onClick

OnClick

Bu işlem öğesi için onClick işlemi.

CardFixedFooter

Kartın alt kısmında görünen kalıcı (yapışkan) bir altbilgi.

primaryButton veya secondaryButton belirtmeden fixedFooter ayarlamak hataya neden olur.

Chat uygulamalarında iletişim kutularında sabit altbilgi kullanabilirsiniz ancak kart mesajlarında kullanamazsınız. Google Chat uygulamalarında örnek için Kalıcı bir altbilgi ekleme başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
primaryButton

Button

Sabit altbilginin birincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır.

secondaryButton

Button

Sabit altbilginin ikincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır. secondaryButton ayarlandıysa primaryButton'u da ayarlamanız gerekir.

CardHeader

Kart başlığını temsil eder. Google Chat uygulamalarında bir örnek için Başlık ekleme bölümüne bakın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
title

string

Zorunlu. Kart başlığının başlığı. Başlığın yüksekliği sabittir: Hem başlık hem de alt başlık belirtilirse her biri bir satır kaplar. Yalnızca başlık belirtilirse her iki satır da başlığı kaplar.

subtitle

string

Kart başlığının alt başlığı. Belirtilirse title öğesinin altında kendi satırında görünür.

imageType

ImageType

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

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

imageUrl

string

Kart başlığındaki resmin HTTPS URL'si.

imageAltText

string

Bu resmin erişilebilirlik için kullanılan alternatif metni.

DisplayStyle

Google Workspace Eklentilerinde, kartın nasıl görüntüleneceğini belirler.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Sıralamalar
DISPLAY_STYLE_UNSPECIFIED Kullanmayın. Belirtilmedi.
PEEK Kartın başlığı, kenar çubuğunun alt kısmında görünür ve grubun mevcut üst kartını kısmen kapatır. Başlığı tıkladığınızda kart, kart yığınına eklenir. Kartta üstbilgi yoksa bunun yerine oluşturulan bir üstbilgi kullanılır.
REPLACE Varsayılan değer. Kart, kart grubundaki en üstteki kartın görünümü değiştirilerek gösterilir.

DividerStyle

Kartın ayırıcı stili. Şu anda yalnızca kart bölümleri arasındaki ayırıcılar için kullanılır.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
DIVIDER_STYLE_UNSPECIFIED Kullanmayın. Belirtilmedi.
SOLID_DIVIDER Varsayılan seçenek. Sağlam bir ayırıcı oluşturun.
NO_DIVIDER Ayarlanırsa bölücü oluşturulmaz. Bu stil, ayırıcıyı düzenden tamamen kaldırır. Sonuç, hiç bölücü eklememekle aynıdır.

NestedWidget

CarouselCard gibi kapsayıcı bir düzende görüntülenebilecek widget'ların listesi. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Alanlar

Birlik alanı data.

data yalnızca aşağıdakilerden biri olabilir:

textParagraph

TextParagraph

Metin paragrafı widget'ı.

buttonList

ButtonList

Düğme listesi widget'ı.

image

Image

Resim widget'ı.

Bölüm

Bölüm, belirtildikleri sırayla dikey olarak oluşturulan bir widget koleksiyonu içerir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
header

string

Bir bölümün en üstünde görünen metin. Basit HTML biçimli metinleri destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

widgets[]

Widget

Bölümdeki tüm widget'lar. En az bir widget içermelidir.

collapsible

bool

Bu bölümün daraltılabilir olup olmadığını gösterir.

Daraltılabilir bölümler, widget'ların bir kısmını veya tamamını gizler. Ancak kullanıcılar, Daha fazla göster'i tıklayarak gizli widget'ları görmek için bölümü genişletebilir. Kullanıcılar Daha az göster'i tıklayarak widget'ları tekrar gizleyebilir.

Hangi widget'ların gizleneceğini belirlemek için uncollapsibleWidgetsCount değerini belirtin.

uncollapsibleWidgetsCount

int32

Bir bölüm daraltıldığında bile görünür kalan daraltılamaz widget'ların sayısı.

Örneğin, bir bölüm beş widget içeriyorsa ve uncollapsibleWidgetsCount 2 olarak ayarlanmışsa ilk iki widget her zaman gösterilir ve son üçü varsayılan olarak daraltılır. uncollapsibleWidgetsCount yalnızca collapsible true olduğunda dikkate alınır.

collapseControl

CollapseControl

İsteğe bağlı. Bölümün genişlet ve daralt düğmesini tanımlayın. Bu düğme yalnızca bölüm daraltılabilir durumdaysa gösterilir. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Kaydırma çubuğu olarak da bilinen bant, widget'ların listesini slayt gösterisi biçiminde döndürerek gösterir. Bu bantta, önceki veya sonraki widget'a gitme düğmeleri bulunur.

Örneğin, bu üç metin paragrafı widget'ı içeren bir bandın JSON gösterimidir.

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Alanlar
carouselCards[]

CarouselCard

Banta eklenen kartların listesi.

CarouselCard

Bant öğesi olarak görüntülenebilen bir kart. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Alanlar
widgets[]

NestedWidget

Bant kartında gösterilen widget'ların listesi. Widget'lar, belirtildikleri sırada gösterilir.

footerWidgets[]

NestedWidget

Bant kartının alt kısmında görüntülenen widget'ların listesi. Widget'lar, belirtildikleri sırada gösterilir.

Çip

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge çipi.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
icon

Icon

Simge resmi. Hem icon hem de text ayarlanırsa simge metnin önünde görünür.

label

string

Çipin içinde gösterilen metin.

onClick

OnClick

İsteğe bağlı. Kullanıcı çipi tıkladığında yapılacak işlem (ör. köprü açma veya özel işlev çalıştırma).

enabled
(deprecated)

bool

Çipin etkin durumda olup olmadığını ve kullanıcı işlemlerine yanıt verip vermediğini belirtir. Varsayılan olarak true değerine ayarlanır. Kullanımdan kaldırıldı. Bunun yerine disabled politikasını kullanın.

disabled

bool

Çipin etkin durumda olup olmadığını ve kullanıcı işlemlerini yoksayıp yoksamadığını belirtir. Varsayılan olarak false değerine ayarlanır.

altText

string

Erişilebilirlik için kullanılan alternatif metin.

Kullanıcıların çipin ne işe yaradığını bilmesini sağlayan açıklayıcı bir metin ayarlayın. Örneğin, bir çip köprü açıyorsa şunu yazın: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider.

ChipList

Yatay olarak yerleştirilmiş çiplerin listesi. Bu liste yatay olarak kaydırılabilir veya bir sonraki satıra sarılabilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
layout

Layout

Belirtilen çip listesi düzeni.

chips[]

Chip

Bir çip dizisi.

Düzen

Çip listesi düzeni.

Sıralamalar
LAYOUT_UNSPECIFIED Kullanmayın. Belirtilmedi.
WRAPPED Varsayılan değer. Yeterli yatay alan yoksa çip listesi bir sonraki satıra kaydırılır.
HORIZONTAL_SCROLLABLE Kullanılabilir alana sığmayan çipler yatay olarak kaydırılır.

CollapseControl

Genişletme ve daraltma kontrolünü temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
horizontalAlignment

HorizontalAlignment

Genişletme ve daraltma düğmesinin yatay hizası.

expandButton

Button

İsteğe bağlı. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

collapseButton

Button

İsteğe bağlı. Bölümü daraltmak için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Sütunlar

Columns widget'ı, bir kartta veya iletişim kutusunda en fazla 2 sütun gösterir. Her sütuna widget ekleyebilirsiniz. Widget'lar, belirtildikleri sırayla görünür. Google Chat uygulamalarında bir örnek için Kartları ve iletişim kutularını sütunlarda görüntüleme bölümüne bakın.

Her sütunun yüksekliği, en uzun sütuna göre belirlenir. Örneğin, ilk sütun ikinci sütundan daha uzunsa her iki sütun da ilk sütunun yüksekliğine sahip olur. Her sütun farklı sayıda widget içerebileceğinden satır tanımlayamaz veya sütunlar arasında widget'ları hizalayamazsınız.

Sütunlar yan yana gösterilir. HorizontalSizeStyle alanını kullanarak her sütunun genişliğini özelleştirebilirsiniz. Kullanıcının ekran genişliği çok darsa ikinci sütun ilk sütunun altına sığar:

  • Web'de, ekran genişliği 480 pikselden az veya eşitse ikinci sütun kaydırılır.
  • iOS cihazlarda, ekran genişliği 300 puntodan az veya bu değere eşitse ikinci sütun kaydırılır.
  • Android cihazlarda, ekran genişliği 320 dp'den az veya bu değere eşitse ikinci sütun kaydırılır.

İkiden fazla sütun eklemek veya satır kullanmak için Grid widget'ını kullanın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir. Sütunları destekleyen eklenti kullanıcı arayüzleri şunlardır:

  • Kullanıcılar eklentiyi bir e-posta taslağı üzerinden açtığında görüntülenen iletişim kutusu.
  • Kullanıcılar Google Takvim etkinliğindeki Ek ekle menüsünden eklentiyi açtığında görüntülenen iletişim kutusu.
Alanlar
columnItems[]

Column

Sütun dizisi. Bir karta veya iletişim kutusuna en fazla 2 sütun ekleyebilirsiniz.

Sütun

Bir sütun.

Google Workspace eklentileri ve Chat uygulamaları

Alanlar
horizontalSizeStyle

HorizontalSizeStyle

Bir sütunun kartın genişliğini nasıl doldurduğunu belirtir.

horizontalAlignment

HorizontalAlignment

Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.

verticalAlignment

VerticalAlignment

Widget'ların bir sütunun üst, alt veya ortasına hizalanıp hizalanmayacağını belirtir.

widgets[]

Widgets

Bir sütuna dahil edilen widget dizisi. Widget'lar, belirtildikleri sırada görünür.

HorizontalSizeStyle

Bir sütunun kartın genişliğini nasıl doldurduğunu belirtir. Her sütunun genişliği hem HorizontalSizeStyle'e hem de sütundaki widget'ların genişliğine bağlıdır.

Google Workspace eklentileri ve Chat uygulamaları

Sıralamalar
HORIZONTAL_SIZE_STYLE_UNSPECIFIED Kullanmayın. Belirtilmedi.
FILL_AVAILABLE_SPACE Varsayılan değer. Sütun, kartın genişliğinin% 70'ine kadar olan kullanılabilir alanı doldurur. Her iki sütun da FILL_AVAILABLE_SPACE olarak ayarlanırsa her sütun alanın% 50'sini doldurur.
FILL_MINIMUM_SPACE Sütun, mümkün olan en az alanı doldurur ve kart genişliğinin en fazla% 30'unu kaplar.

VerticalAlignment

Widget'ların bir sütunun üst, alt veya ortasına hizalanıp hizalanmayacağını belirtir.

Google Workspace eklentileri ve Chat uygulamaları

Sıralamalar
VERTICAL_ALIGNMENT_UNSPECIFIED Kullanmayın. Belirtilmedi.
CENTER Varsayılan değer. Widget'ları bir sütunun ortasına hizalar.
TOP Widget'ları sütunun üst tarafına hizalar.
BOTTOM Widget'ları bir sütunun alt kısmına hizalar.

Widget'lar

Bir sütuna ekleyebileceğiniz desteklenen widget'lar.

Google Workspace eklentileri ve Chat uygulamaları

Alanlar

Birlik alanı data.

data yalnızca aşağıdakilerden biri olabilir:

textParagraph

TextParagraph

TextParagraph widget'ı.

image

Image

Image widget'ı.

decoratedText

DecoratedText

DecoratedText widget'ı.

buttonList

ButtonList

ButtonList widget'ı.

textInput

TextInput

TextInput widget'ı.

selectionInput

SelectionInput

SelectionInput widget'ı.

dateTimePicker

DateTimePicker

DateTimePicker widget'ı.

chipList

ChipList

ChipList widget'ı.

DataActions

Google Workspace verilerini güncelleyen bir eklenti işlemi.

Alanlar
hostAppDataAction

HostAppDataActionMarkup

Google Workspace verilerinin nasıl güncelleneceğini tanımlar.

DateTimePicker

Kullanıcıların tarih, saat veya hem tarih hem de saat girmesine olanak tanır. Form gönderimi doğrulamasını destekler. Action.all_widgets_are_required true olarak ayarlandığında veya bu widget Action.required_widgets içinde belirtildiğinde, bir değer seçilmediği sürece gönderim işlemi engellenir. Google Chat uygulamalarında örnek için Kullanıcının tarih ve saat seçmesine izin verme başlıklı makaleyi inceleyin.

Kullanıcılar metin girebilir veya tarih ve saat seçmek için seçiciyi kullanabilir. Kullanıcılar geçersiz bir tarih veya saat girerse seçici, kullanıcıların bilgileri doğru şekilde girmelerini isteyen bir hata gösterir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
name

string

DateTimePicker öğesinin bir form girişi etkinliğinde tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

label

string

Kullanıcılardan tarih, saat veya tarih ve saat girmelerini isteyen metin. Örneğin, kullanıcılar randevu planlıyorsa Appointment date veya Appointment date and time gibi bir etiket kullanın.

type

DateTimePickerType

Widget'ın tarih, saat veya tarih ve saat girişini destekleyip desteklemediği.

valueMsEpoch

int64

Unix sıfır zamanından itibaren milisaniye cinsinden widget'ta gösterilen varsayılan değer.

Değeri, seçicinin türüne göre belirtin (DateTimePickerType):

  • DATE_AND_TIME: UTC'de bir takvim tarihi ve saati. Örneğin, 1 Ocak 2023, saat 12:00 (UTC) değerini temsil etmek için 1672574400000 değerini kullanın.
  • DATE_ONLY: UTC'de 00:00:00 olan bir takvim tarihi. Örneğin, 1 Ocak 2023'ü temsil etmek için 1672531200000 kullanın.
  • TIME_ONLY: UTC'de bir saat. Örneğin, 12:00'yi temsil etmek için 43200000 (veya 12 * 60 * 60 * 1000) kullanın.
timezoneOffsetDate

int32

UTC ile saat dilimi arasındaki farkı dakika cinsinden temsil eden sayı. Ayarlanırsa value_ms_epoch, belirtilen saat diliminde gösterilir. Ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.

onChangeAction

Action

Kullanıcı DateTimePicker arayüzünden Kaydet veya Temizle'yi tıkladığında tetiklenir.

DateTimePickerType

DateTimePicker widget'ındaki tarih ve saat biçimi. Kullanıcıların tarih, saat veya hem tarih hem de saat girip giremeyeceğini belirler.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
DATE_AND_TIME Kullanıcılar bir tarih ve saat girer.
DATE_ONLY Kullanıcılar bir tarih girer.
TIME_ONLY Kullanıcılar bir zaman girer.

DecoratedText

Metni, metnin üstünde veya altında bir etiket, metnin önünde bir simge, seçim widget'ı veya metnin ardından bir düğme gibi isteğe bağlı süslemelerle gösteren widget. Google Chat uygulamalarında bir örnek için Dekoratif metinle metin görüntüleme bölümüne bakın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
icon
(deprecated)

Icon

startIcon için kullanımdan kaldırıldı.

startIcon

Icon

Metnin önünde gösterilen simge.

topLabel

string

text öğesinin üzerinde görünen metin. Her zaman kısaltılır.

text

string

Zorunlu. Birincil metin.

Basit biçimlendirmeyi destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

wrapText

bool

Metin kaydırma ayarı. true ise metin kaydırılı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

text öğesinin altında görünen metin. Her zaman sarmalanır.

onClick

OnClick

Bu işlem, kullanıcılar topLabel veya bottomLabel simgesini tıkladığında tetiklenir.

Birlik alanı control. decoratedText widget'ındaki metnin sağ tarafında görünen bir düğme, anahtar, onay kutusu veya resim. control yalnızca aşağıdakilerden biri olabilir:
button

Button

Kullanıcının bir işlemi tetiklemek için tıklayabileceği bir düğme.

switchControl

SwitchControl

Kullanıcının durumunu değiştirip bir işlem tetiklemek için tıklayabileceği bir anahtar widget'ı.

endIcon

Icon

Metinden sonra görüntülenen bir simge.

Yerleşik ve özel simgeleri destekler.

Anahtar Kontrolü

decoratedText widget'ında açma/kapatma düğmesi veya onay kutusu.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Yalnızca decoratedText widget'ında desteklenir.

Alanlar
name

string

Anahtar widget'ının bir form girişi etkinliğinde tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

value

string

Bir kullanıcı tarafından girilen ve form girişi etkinliği kapsamında döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

selected

bool

true olduğunda anahtar seçilidir.

onChangeAction

Action

Anahtar durumu değiştiğinde yapılacak işlem (ör. hangi işlevin çalıştırılacağı).

controlType

ControlType

Anahtar, kullanıcı arayüzünde nasıl görünür?

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

ControlType

Anahtar, kullanıcı arayüzünde nasıl görünür?

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
SWITCH Açma/kapatma düğmesi.
CHECKBOX CHECK_BOX için kullanımdan kaldırıldı.
CHECK_BOX Onay kutusu.

Refüj

Bu türde alan yoktur.

Widget'lar arasında yatay bir çizgi olarak bir ayırıcı gösterir. Google Chat uygulamalarında bir örnek için Widget'lar arasına yatay bölücü ekleme başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Örneğin, aşağıdaki JSON bir bölücü oluşturur:

"divider": {}

EndNavigation

Google Chat'teki eklentiler için bir iletişim kutusunu kapatır.

Alanlar
action

Action

Google Chat'teki eklentiler için bir iletişim kutusunu kapatan işlem.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

İşlem

Google Chat'teki eklentiler için EndNavigation işlemleri.

Sıralamalar
ACTION_UNSPECIFIED İşlem belirtilmedi.
CLOSE_DIALOG Bir iletişim kutusunu kapatır.
CLOSE_DIALOG_AND_EXECUTE Bir iletişim kutusunu kapatır ve iletişim kutusunu açan kartı yeniler.

GetAutocompletionResponse

Metin alanı için otomatik tamamlama öğelerini göstermek için gerekli öğeleri içeren otomatik tamamlama kapsayıcısını alma yanıtı.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz. Örneğin:

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
Alanlar
autoComplete

Suggestions

schema

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlevsiz bir şema alanıdır.

Izgara

Öğe koleksiyonunun yer aldığı bir ızgara görüntüler. Öğeler yalnızca metin veya resim içerebilir. Duyarlı sütunlar için veya metin ya da resimlerden daha fazlasını eklemek için Columns öğesini kullanın. Google Chat uygulamalarında bir örnek için Öğe koleksiyonu içeren bir ızgara görüntüleme bölümüne bakın.

Izgara, istediğiniz sayıda sütun ve öğeyi destekler. Satır sayısı, öğelerin sütunlara bölünmesiyle belirlenir. 10 öğe ve 2 sütun içeren bir tabloda 5 satır vardır. 11 öğe ve 2 sütun içeren bir tabloda 6 satır bulunur.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Örneğin, aşağıdaki JSON tek bir öğe içeren 2 sütunlu bir ızgara oluşturur:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
Alanlar
title

string

Izgara başlığında görünen metin.

items[]

GridItem

Izgarada gösterilecek öğeler.

borderStyle

BorderStyle

Her ızgara öğesine uygulanacak kenar stili.

columnCount

int32

Izgarada gösterilecek sütun sayısı. Bu alan belirtilmezse varsayılan bir değer kullanılır ve bu varsayılan değer, ızgaranın gösterildiği yere (ileti dizisi veya yardımcı) bağlı olarak farklıdır.

onClick

OnClick

Bu geri çağırma, her bir tablo öğesi tarafından yeniden kullanılır ancak öğenin, geri çağırma parametrelerine eklenen öğeler listesindeki tanımlayıcı ve dizini ile birlikte kullanılır.

GridItem

Izgara düzenindeki bir öğeyi temsil eder. Öğeler metin, resim veya hem metin hem de resim içerebilir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
id

string

Bu ızgara öğesi için kullanıcı tarafından belirtilen bir tanımlayıcı. Bu tanımlayıcı, üst ızgaranın onClick geri çağırma parametrelerinde döndürülür.

image

ImageComponent

Tablo öğesinde görüntülenen resim.

title

string

Izgara öğesinin başlığı.

subtitle

string

Izgara öğesinin alt başlığı.

layout

GridItemLayout

Izgara öğesi için kullanılacak düzen.

GridItemLayout

Bir ızgara öğesi için kullanılabilen çeşitli düzen seçeneklerini temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
GRID_ITEM_LAYOUT_UNSPECIFIED Kullanmayın. Belirtilmedi.
TEXT_BELOW Başlık ve alt başlık, ızgara öğesinin resminin altında gösterilir.
TEXT_ABOVE Başlık ve alt başlık, ızgara öğesinin resminin üzerinde gösterilir.

Simge

Karttaki bir widget'ta gösterilen simge. Google Chat uygulamalarında örnek için Simge ekleme bölümüne bakın.

Yerleşik ve özel simgeleri destekler.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
altText

string

İsteğe bağlı. Erişilebilirlik için kullanılan simgeye dair açıklama. Belirtilmediği takdirde varsayılan değer Button olur. En iyi uygulama olarak, simgenin neyi gösterdiği ve varsa ne işe yaradığına dair yararlı bir açıklama ayarlamanız 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/workspace/chat.

Simge Button içinde ayarlanırsa kullanıcı imlecini düğmenin üzerine getirdiğinde altText yardım metni olarak görünür. Ancak düğme text değerini de ayarlarsa simgenin altText değeri yoksayılır.

imageType

ImageType

Resme uygulanan kırpma stili. Bazı durumlarda CIRCLE kırpma uygulandığında resim, yerleşik bir simge olduğundan daha büyük çizilir.

Birlik alanı icons. Karttaki widget'ta gösterilen simge. icons yalnızca aşağıdakilerden biri olabilir:
knownIcon

string

Google Workspace tarafından sağlanan yerleşik simgelerden birini gösterin.

Örneğin, uçak simgesi göstermek için AIRPLANE değerini belirtin. Otobüs için BUS değerini belirtin.

Desteklenen simgelerin tam listesi için yerleşik simgeler başlıklı makaleyi inceleyin.

iconUrl

string

HTTPS URL'sinde barındırılan özel bir simge görüntüleyin.

Örneğin:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

Desteklenen dosya türleri .png ve .jpg'dur.

materialIcon

MaterialIcon

Google Materyal Simgelerinden birini gösterin.

Örneğin, onay kutusu simgesi göstermek için

"materialIcon": {
  "name": "check_box"
}

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Resim

URL ile belirtilen ve onClick işlemi içerebilen bir resim. Örnek için Resim ekleme bölümüne bakın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
imageUrl

string

Resmi barındıran HTTPS URL'si.

Örneğin:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

OnClick

Kullanıcı resmi tıkladığında bu işlem tetiklenir.

altText

string

Bu resmin erişilebilirlik için kullanılan alternatif metni.

ImageComponent

Bir resmi temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
imageUri

string

Resim URL'si.

altText

string

Resmin erişilebilirlik etiketi.

cropStyle

ImageCropStyle

Resme uygulanacak kırpma stili.

borderStyle

BorderStyle

Resme uygulanacak kenarlık stili.

ImageCropStyle

Bir resme uygulanan kırpma stilini temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Örneğin, 16:9 en boy oranını uygulamak için:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
Alanlar
type

ImageCropType

Kırpma türü.

aspectRatio

double

Kırpma türü RECTANGLE_CUSTOM ise kullanılacak en boy oranı.

Örneğin, 16:9 en boy oranını uygulamak için:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

Bir resme uygulanan kırpma stilini temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
IMAGE_CROP_TYPE_UNSPECIFIED Kullanmayın. Belirtilmedi.
SQUARE Varsayılan değer. Kare kırpma uygular.
CIRCLE Dairesel kırpma uygular.
RECTANGLE_CUSTOM Özel en boy oranına sahip dikdörtgen bir kırpma uygular. aspectRatio ile özel en boy oranını ayarlayın.
RECTANGLE_4_3 4:3 en boy oranına sahip dikdörtgen bir kırpma uygular.

LinkPreview

Kart ve akıllı çip göstererek üçüncü taraf bağlantısını önizleyen kart işlemi. Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme başlıklı makaleyi inceleyin.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Örneğin, aşağıdaki JSON, bağlantı önizlemesi ve akıllı çipi için benzersiz bir başlık ve bir başlık ile metin açıklaması içeren bir önizleme kartı döndürür:

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

Örnek, aşağıdaki bağlantı önizlemesini döndürür:

Örnek bağlantı önizlemesi

Alanlar
previewCard

Card

Üçüncü taraf hizmetindeki bir bağlantıyla ilgili bilgileri gösteren kart.

title

string

Bağlantı önizlemesi için akıllı çipte gösterilen başlık. Ayarlanmazsa akıllı çip, preview_card öğesinin başlığını gösterir.

linkPreviewTitle

string

Bağlantı önizlemesinde gösterilen başlık. Ayarlanmamışsa bağlantı önizlemesinde preview_card öğesinin başlığı gösterilir.

MaterialIcon

2.500'den fazla seçenek içeren bir Google Material simgesi.

Örneğin, özelleştirilmiş ağırlık ve not içeren bir onay kutusu simgesi görüntülemek için şunları yazın:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Alanlar
name

string

Google Material simgesi'nde tanımlanan simge adı (ör. check_box). Geçersiz adlar atlanır ve boş dizeyle değiştirilir. Bu da simgenin oluşturulamamasına neden olur.

fill

bool

Simgenin dolu olarak oluşturulup oluşturulmayacağı. Varsayılan değer yanlıştır.

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.

weight

int32

Simgenin çizgi kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Bu ayar yoksa varsayılan değer 400'dür. Başka bir değer belirtilirse varsayılan değer kullanılır.

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.

grade

int32

Ağırlık ve sınıf, sembolün kalınlığını etkiler. Nottaki düzenlemeler, ağırlıktaki düzenlemelerden daha ayrıntılıdır ve sembolün boyutu üzerinde küçük bir etkiye sahiptir. {-25, 0, 200} arasından seçim yapın. Bu değer yoksa varsayılan değer 0'dır. Başka bir değer belirtilirse varsayılan değer kullanılır.

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.

ModifyCard

Google Chat'teki eklentiler için bir kartı kullanıcı etkileşimine göre günceller. Dizi yalnızca tek bir nesne içermelidir.

Alanlar

Birlik alanı operation.

operation yalnızca aşağıdakilerden biri olabilir:

updateWidget

UpdateWidget

Google Chat'teki eklentiler için bir karttaki veya iletişim kutusunda bir widget'ı günceller.

UpdateWidget

Google Chat'teki eklentiler için bir karttaki veya iletişim kutusunda bir widget'ı günceller.

Alanlar
Birlik alanı updated_widget. Widget'daki güncellemeler. updated_widget yalnızca aşağıdakilerden biri olabilir:
selectionInputWidgetSuggestions

SelectionInputWidgetSuggestions

selectionInput widget'ları için çoklu seçim menüsündeki önerilen öğe dizisi. Çoklu seçim menüsü, öğelerini doldurmak için harici bir veri kaynağı kullandığında widget, menüye yazılanlara göre önerileri dinamik olarak doldurabilir. Daha fazla bilgi için Google Chat kullanıcılarından bilgi toplama başlıklı makaleyi inceleyin.

SelectionInputWidgetSuggestions

Çoklu seçim menüsü kullanan bir selectionInput widget'ı için harici bir dinamik veri kaynağından seçim öğelerini döndürür.

Alanlar
suggestions[]

SelectionItem

Kullanıcının çoklu seçim menüsüne yazması sonrasında gösterilen, seçilebilir öğe dizisi.

Kart grubundaki kartları günceller veya kartlar arasında gezinir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Örneğin:

1) Yeni bir kartı iade edin (İleri gidin).

 navigations : {
    pushCard : CARD
  }

2) Paketin üst kısmındaki kartı güncelleyin (yerinde güncelleme).

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) Güncellemeden bir adım geri dönün.

  navigations : {
    popCard : true,
  }

4) Birkaç adım geri gidip ilgili kartı güncelleyin.

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) Tanımlanmış bir CARD_NAME'e gitmek için birden fazla adım geri gidin.

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) Kökene geri dönün ve ilgili kartı güncelleyin.

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) Belirtilen karta gidip bu kartı da açın.

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) Üstteki kartı yeni bir kartla değiştirin.

  navigations : {
    updateCard : CARD
  }
Alanlar

Birlik alanı navigate_action.

navigate_action yalnızca aşağıdakilerden biri olabilir:

popToRoot

bool

Kök kart hariç tüm kartları çıkarır.

pop

bool

Bir kart çıkarır.

popToCard

string

Belirtilen kartın üzerindeki tüm kartları, belirtilen kart adıyla pop-up olarak gösterir.

pushCard

Card

Bir kartı kart yığınına iter.

Geliştirici Önizlemesi: Google Chat'teki iletişim kutuları için bir iletişim kutusunu açar veya günceller.

updateCard

Card

Üstteki kartı yeni bir kartla günceller ve doldurulmuş form alanı değerlerini korur. Eşdeğer olmayan bir alan için değer atlanır.

Geliştirici Önizlemesi: Google Chat'teki iletişim kutuları için bir iletişim kutusunu açar veya günceller.

endNavigation

EndNavigation

Google Chat'teki eklentiler için bir iletişim kutusunu kapatır.

Bildirim

Kullanıcı bir kartla etkileşime geçtiğinde barındıran Google Workspace uygulamasında bildirim gösteren bir işlem.

Geliştirici Önizlemesi: Google Chat'teki eklentiler için kullanıcılar bir iletişimi gönderip kapattığında bildirim gösterir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Alanlar
text

string

Bildirimde gösterilecek düz metin (HTML etiketleri olmadan).

OnClick

Kullanıcılar karttaki etkileşimli bir öğeyi (ör. düğme) tıkladığında nasıl yanıt verileceğini gösterir.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar

Birlik alanı data.

data yalnızca aşağıdakilerden biri olabilir:

action

Action

Belirtilen bu onClick tarafından bir işlem tetiklenir.

openDynamicLinkAction

Action

Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde bu işlemi tetikler. Bu, bağlantıyı almak için sunucuyla iletişim kurması gerektiğinden yukarıdaki open_link ile farklıdır. Bu nedenle, bağlantı açma işlemi yanıtı gelmeden önce web istemcisinin yapması gereken bazı hazırlık çalışmaları gerekir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

card

Card

Belirtilen durumlarda, tıklandıktan sonra kart yığınına yeni bir kart eklenir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

overflowMenu

OverflowMenu

Belirtilen bu onClick, taşma menüsünü açar.

OnClose

OnClick işlemiyle açılan bir bağlantı kapatıldığında istemcinin yaptığı işlem.

Uygulama, istemci platformu özelliklerine bağlıdır. Örneğin, bir web tarayıcısı, bağlantıyı OnClose işleyici içeren bir pop-up pencerede açabilir.

Hem OnOpen hem de OnClose işleyicileri ayarlanmışsa ve istemci platformu her iki değeri de destekleyemiyorsa OnClose öncelikli olur.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Sıralamalar
NOTHING Varsayılan değer. Kart yeniden yüklenmez ve hiçbir şey olmaz.
RELOAD

Çocuk penceresi kapandıktan sonra kartı yeniden yükler.

OpenAs.OVERLAY ile birlikte kullanılırsa alt pencere modal iletişim kutusu gibi davranır ve alt pencere kapanana kadar üst kart engellenir.

OpenAs

Bir OnClick işlemi bir bağlantıyı açtığında istemci, bağlantıyı tam boyutlu pencere (istemci tarafından kullanılan çerçeve bu ise) veya yer paylaşımı (pop-up gibi) olarak açabilir. Uygulama, istemci platformunun özelliklerine bağlıdır ve istemci bu değeri desteklemiyorsa seçilen değer yoksayılabilir. FULL_SIZE tüm istemciler tarafından desteklenir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Sıralamalar
FULL_SIZE Bağlantı, tam boyutlu bir pencerede açılır (müşteri tarafından kullanılan çerçeve bu ise).
OVERLAY Bağlantı, pop-up gibi bir yer paylaşımı olarak açılır.

OverflowMenu

Kullanıcıların çağırabileceği bir veya daha fazla işlemi içeren bir pop-up menü sunan widget. Örneğin, bir kartta birincil olmayan işlemleri göstermek. İşlemler mevcut alana sığmadığında bu widget'ı kullanabilirsiniz. Kullanmak için bu widget'ı, destekleyen widget'ların OnClick işleminde belirtin. Örneğin, Button içinde.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
items[]

OverflowMenuItem

Zorunlu. Menü seçeneklerinin listesi.

OverflowMenuItem

Kullanıcıların taşma menüsünde kullanabileceği bir seçenek.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
startIcon

Icon

Metnin önünde gösterilen simge.

text

string

Zorunlu. Öğeyi kullanıcılara tanımlayan veya açıklayan metin.

onClick

OnClick

Zorunlu. Bir menü seçeneği seçildiğinde çağrılan işlem. Bu OnClick, OverflowMenu içeremez. Belirtilen tüm OverflowMenu'lar bırakılır ve menü öğesi devre dışı bırakılır.

disabled

bool

Menü seçeneğinin devre dışı olup olmadığı. Varsayılan değer yanlıştır.

RenderActions

Eklentiye bir kartta veya ana uygulamada işlem yapmasını söyleyen bir dizi oluşturma talimatı.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Alanlar
action

Action

Eklentilerin kullanıcı arayüzünü güncellemek için kullanabileceği işlem.

Geliştirici Önizlemesi: Google Chat'te eklentiler.

hostAppAction

HostAppActionMarkup

Barındırıcı uygulamalar tarafından işlenen işlemler.

schema

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlevsiz bir şema alanıdır.

İşlem

Eklentilerin kartlarda veya ana uygulamada kullanabileceği işlemler.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

Alanlar
navigations[]

Navigation

Bir kartı iter, çıkarır veya günceller.

Geliştirici Önizlemesi: Google Chat'te eklentiler.

notification

Notification

Kullanıcı bir kartla etkileşime geçtiğinde barındıran Google Workspace uygulamasında bildirim gösterir.

Geliştirici Önizlemesi: Google Chat'teki eklentiler için kullanıcılar bir iletişimi gönderip kapattığında bildirim gösterir.

linkPreview

LinkPreview

Google Dokümanlar, Google E-Tablolar ve Google Slaytlar'da kullanılabilir. Bağlantıları akıllı çiplerle ve kartla önizler. Ayrıntılı bilgi için Akıllı çiplerle bağlantıları önizleme başlıklı makaleyi inceleyin.

modifyOperations[]

ModifyCard

Google Chat'teki eklentiler için bir kartı kullanıcı etkileşimine göre günceller. Dizi yalnızca tek bir nesne içermelidir.

SelectionInput

Kullanıcıların seçebileceği bir veya daha fazla kullanıcı arayüzü öğesi oluşturan bir widget. Yalnızca dropdown ve multiselect menüleri için form gönderimi doğrulamasını destekler. Action.all_widgets_are_required true olarak ayarlandığında veya bu widget Action.required_widgets içinde belirtildiğinde, bir değer seçilmediği sürece gönderim işlemi engellenir. Örneğin, açılır menü veya onay kutuları. Tahmin edilebilir veya sayılabilir verileri toplamak için bu widget'ı kullanabilirsiniz. Google Chat uygulamalarında bir örnek için Seçilebilir kullanıcı arayüzü öğeleri ekleme bölümüne bakın.

Chat uygulamaları, kullanıcıların seçtiği veya girdiği öğelerin değerini işleyebilir. Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

Kullanıcılardan tanımlanmamış veya soyut veriler toplamak için TextInput widget'ını kullanın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
name

string

Zorunlu. Form girişi etkinliğindeki seçim girişini tanımlayan ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

label

string

Kullanıcı arayüzündeki seçim giriş alanının üzerinde görünen metin.

Kullanıcının, uygulamanızın ihtiyaç duyduğu bilgileri girmesine yardımcı olacak metin belirtin. Örneğin, kullanıcılar bir iş kaydının aciliyetini açılır menüden seçiyorsa etiket "Aciliyet" veya "Aciliyeti seçin" olabilir.

type

SelectionType

SelectionInput widget'ında kullanıcılara gösterilen öğelerin türü. Seçim türleri farklı etkileşim türlerini destekler. Örneğin, kullanıcılar bir veya daha fazla onay kutusunu seçebilir ancak açılır menüden yalnızca bir değer seçebilir.

items[]

SelectionItem

Seçilebilir öğe dizisi. Örneğin, bir radyo düğmesi veya onay kutusu dizisi. En fazla 100 öğeyi destekler.

onChangeAction

Action

Belirtilen durumlarda, seçim değiştiğinde form gönderilir. Belirtilmemişse formu gönderen ayrı bir düğme belirtmeniz gerekir.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

multiSelectMaxSelectedItems

int32

Çoklu seçim menüleri için kullanıcının seçebileceği maksimum öğe sayısı. Minimum değer 1 öğedir. Belirtilmemişse varsayılan olarak 3 öğe olur.

multiSelectMinQueryLength

int32

Çoklu seçim menüleri için, kullanıcının menü önerilen seçim öğelerini döndürmeden önce girdiği metin karakterlerinin sayısı.

Ayarlanmazsa çoklu seçim menüsü aşağıdaki varsayılan değerleri kullanır:

  • Menüde statik bir SelectionInput öğesi dizisi kullanılıyorsa varsayılan olarak 0 karakter olur ve öğeler hemen diziden doldurulur.
  • Menü dinamik bir veri kaynağı (multi_select_data_source) kullanıyorsa önerilen öğeleri döndürmek için veri kaynağını sorgulamadan önce varsayılan olarak 3 karakter kullanılır.

Birlik alanı multi_select_data_source. Çoklu seçim menüsü için seçim öğelerini dinamik olarak dolduran bir veri kaynağı.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz. multi_select_data_source yalnızca aşağıdakilerden biri olabilir:

externalDataSource

Action

İlişkisel veritabanı gibi harici bir veri kaynağı.

platformDataSource

PlatformDataSource

Google Workspace'teki bir veri kaynağı.

PlatformDataSource

Çoklu seçim menüsü kullanan bir SelectionInput widget'ı için Google Workspace'teki bir veri kaynağı. Çoklu seçim menüsündeki öğeleri doldurmak için kullanılır.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Alanlar
Birlik alanı data_source. Veri kaynağı. data_source yalnızca aşağıdakilerden biri olabilir:
commonDataSource

CommonDataSource

Tüm Google Workspace uygulamaları tarafından paylaşılan bir veri kaynağı (ör. bir Google Workspace kuruluşundaki kullanıcılar).

hostAppDataSource

HostAppDataSourceMarkup

Google Workspace barındıran uygulamasına (ör. Google Chat'teki alanlar) özgü bir veri kaynağı.

Bu alan Google API istemci kitaplıklarını destekler ancak Cloud istemci kitaplıklarında kullanılamaz. Daha fazla bilgi için İstemci kitaplıklarını yükleme başlıklı makaleyi inceleyin.

CommonDataSource

Tüm Google Workspace uygulamaları tarafından paylaşılan bir veri kaynağıdır.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Sıralamalar
UNKNOWN Varsayılan değer. Kullanmayın.
USER Google Workspace kullanıcıları. Kullanıcı yalnızca Google Workspace kuruluşundaki kullanıcıları görüntüleyebilir ve seçebilir.

SelectionItem

Kullanıcıların bir seçim girişinde seçebileceği bir öğe (ör. onay kutusu veya anahtar). En fazla 100 öğeyi destekler.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
text

string

Öğeyi kullanıcılara tanımlayan veya açıklayan metin.

value

string

Bu öğeyle ilişkili değer. Müşteri bunu form giriş değeri olarak kullanmalıdır.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

selected

bool

Öğenin varsayılan olarak seçili olup olmadığı. Seçim girişi yalnızca bir değer kabul ediyorsa (ör. radyo düğmeleri veya açılır menü) bu alanı yalnızca bir öğe için ayarlayın.

startIconUri

string

Çoklu seçim menüleri için öğenin text alanının yanında görüntülenen simgenin URL'si. PNG ve JPEG dosyalarını destekler. HTTPS URL'si olmalıdır. Örneğin, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

bottomText

string

Çoklu seçim menüleri için öğenin text alanının altında gösterilen metin açıklaması veya etiket.

SelectionType

Kullanıcıların seçebileceği öğelerin biçimi. Farklı seçenekler farklı etkileşim türlerini destekler. Örneğin, kullanıcılar birden fazla onay kutusunu seçebilir ancak açılır menüden yalnızca bir öğe seçebilir.

Her seçim girişi bir seçim türünü destekler. Örneğin, onay kutuları ve anahtarları birlikte kullanmak desteklenmez.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
CHECK_BOX Bir dizi onay kutusu. Kullanıcılar bir veya daha fazla onay kutusunu işaretleyebilir.
RADIO_BUTTON Bir grup radyo düğmesi. Kullanıcılar bir radyo düğmesi seçebilir.
SWITCH Bir dizi anahtar. Kullanıcılar bir veya daha fazla anahtarı açabilir.
DROPDOWN Açılır menü. Kullanıcılar menüden bir öğe seçebilir.
MULTI_SELECT

Metin kutusu içeren bir menü. Kullanıcılar bir veya daha fazla öğe yazıp seçebilir. Google Workspace eklentileri için öğeleri statik bir SelectionItem nesnesi dizisi kullanarak doldurmanız gerekir.

Google Chat uygulamaları için dinamik bir veri kaynağı kullanarak öğeleri doldurabilir ve kullanıcılar menüye yazarken öğeleri otomatik olarak önerebilirsiniz. Örneğin, kullanıcılar bir Google Chat alanının adını yazmaya başlayabilir ve widget, alanı otomatik olarak önerir. Çoklu seçim menüsündeki öğeleri dinamik olarak doldurmak için aşağıdaki veri kaynağı türlerinden birini kullanın:

  • Google Workspace verileri: Öğeler, Google Workspace'teki veriler (ör. Google Workspace kullanıcıları veya Google Chat alanları) kullanılarak doldurulur.
  • Harici veriler: Öğeler, Google Workspace dışındaki harici bir veri kaynağından doldurulur.

Chat uygulamaları için çoklu seçim menüsünün nasıl uygulanacağına dair örnekler için Çoklu seçim menüsü ekleme başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

SubmitFormResponse

Kartın ve/veya eklenti ana uygulamanın gerçekleştirmesi gereken işlemleri ve kartın durumunun değişip değişmediğini içeren bir otomatik tamamlama kapsayıcısı almak dışında, form gönderme işlemine verilen yanıt.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz. Örneğin:

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: salam.heba@example.com"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}
Alanlar
renderActions

RenderActions

Karta bir işlem yapmasını ve/veya eklenti ana uygulamasına uygulamaya özgü bir işlem yapmasını söyleyen bir dizi oluşturma talimatı.

stateChanged

bool

Kartların durumunun değişip değişmediği ve mevcut kartlardaki verilerin güncel olup olmadığı.

schema

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlevsiz bir şema alanıdır.

Öneriler

Kullanıcıların girebileceği önerilen değerler. Bu değerler, kullanıcılar metin giriş alanını tıkladığında görünür. Kullanıcılar yazarken önerilen değerler, kullanıcıların yazdığıyla eşleşecek şekilde dinamik olarak filtrelenir.

Örneğin, programlama dili için bir metin giriş alanı Java, JavaScript, Python ve C++'yu önerebilir. Kullanıcılar Jav yazmaya başladığında öneri listesi Java ve JavaScript'yi gösterecek şekilde filtrelenir.

Önerilen değerler, kullanıcıların uygulamanızın anlayabileceği değerler girmesine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript, bazıları ise java script yazabilir. JavaScript önermek, kullanıcıların uygulamanızla etkileşim şeklini standartlaştırabilir.

Belirtildiğinde TextInput.type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
items[]

SuggestionItem

Metin giriş alanlarında otomatik tamamlama önerileri için kullanılan önerilerin listesi.

SuggestionItem

Kullanıcıların bir metin giriş alanına girebileceği önerilen bir değer.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar

Birlik alanı content.

content yalnızca aşağıdakilerden biri olabilir:

text

string

Metin girişi alanına önerilen girişin değeri. Bu, kullanıcıların kendileri girdikleri değere eşdeğerdir.

TextInput

Kullanıcıların metin girebileceği bir alan. Önerileri ve değişiklikle ilgili işlemleri destekler. Form gönderimi doğrulamasını destekler. Action.all_widgets_are_required true olarak ayarlandığında veya bu widget Action.required_widgets içinde belirtildiğinde, bir değer girilmediği sürece gönderim işlemi engellenir. Google Chat uygulamalarında örnek görmek için Kullanıcıların metin girebileceği bir alan ekleme başlıklı makaleyi inceleyin.

Sohbet uygulamaları, form giriş etkinlikleri sırasında girilen metnin değerini alır ve işleyebilir. Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

Kullanıcılardan tanımlanmamış veya soyut veriler toplamanız gerektiğinde metin girişi kullanın. Kullanıcılardan tanımlanmış veya numaralandırılmış veriler toplamak için SelectionInput widget'ını kullanın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
name

string

Form girişi etkinliğinde metin girişinin tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

label

string

Kullanıcı arayüzündeki metin giriş alanının üzerinde görünen metin.

Kullanıcının, uygulamanızın ihtiyaç duyduğu bilgileri girmesine yardımcı olacak metin belirtin. Örneğin, bir kişinin adını soruyorsanız ancak özellikle soyadını öğrenmek istiyorsanız name yerine surname yazın.

hintText belirtilmediyse gereklidir. Aksi takdirde isteğe bağlıdır.

hintText

string

Metin giriş alanının altında görünen ve kullanıcılara belirli bir değer girmelerini isteyerek yardımcı olmayı amaçlayan metin. Bu metin her zaman görünür durumdadır.

label belirtilmediyse gereklidir. Aksi takdirde isteğe bağlıdır.

value

string

Bir kullanıcı tarafından girilen ve form girişi etkinliği kapsamında döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

type

Type

Metin giriş alanı kullanıcı arayüzünde nasıl görünür? Örneğin, alanın tek satır mı yoksa çok satır mı olduğu.

onChangeAction

Action

Metin giriş alanında bir değişiklik olduğunda yapılacak işlem. Örneğin, kullanıcının alana metin eklemesi veya metinleri silme işlemi.

Yapılacak işlemlere örnek olarak Google Chat'te özel işlev çalıştırma veya iletişim kutusu açma verilebilir.

initialSuggestions

Suggestions

Kullanıcıların girebileceği önerilen değerler. Bu değerler, kullanıcılar metin giriş alanını tıkladığında görünür. Kullanıcılar yazarken önerilen değerler, kullanıcıların yazdığıyla eşleşecek şekilde dinamik olarak filtrelenir.

Örneğin, programlama dili için bir metin giriş alanı Java, JavaScript, Python ve C++ önerebilir. Kullanıcılar Jav yazmaya başladığında öneri listesi yalnızca Java ve JavaScript'yi gösterecek şekilde filtrelenir.

Önerilen değerler, kullanıcıların uygulamanızın anlayabileceği değerler girmesine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript, bazıları ise java script yazabilir. JavaScript önermek, kullanıcıların uygulamanızla etkileşim şeklini standartlaştırabilir.

Belirtildiğinde TextInput.type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

autoCompleteAction

Action

İsteğe bağlı. Metin giriş alanı, onunla etkileşime geçen kullanıcılara öneriler sağladığında hangi işlemin yapılacağını belirtin.

Belirtilmemişse öneriler initialSuggestions tarafından ayarlanır ve istemci tarafından işlenir.

Belirtilen durumda uygulama, burada belirtilen işlemi (ör. özel işlev çalıştırma) gerçekleştirir.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.

validation

Validation

Bu metin alanı için gerekli giriş biçimi doğrulamasını belirtin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

placeholderText

string

Alan boşken metin giriş alanında görünen metin. Kullanıcılardan değer girmelerini istemek için bu metni kullanın. Örneğin, Enter a number from 0 to 100.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Tür

Metin giriş alanı kullanıcı arayüzünde nasıl görünür? Örneğin, tek satırlık giriş alanı mı yoksa çok satırlık giriş mi olduğu. initialSuggestions belirtilirse type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
SINGLE_LINE Metin giriş alanı sabit bir yüksekliğe (bir satır) sahiptir.
MULTIPLE_LINE Metin giriş alanı, birden fazla satırın sabit yüksekliğine sahiptir.

TextParagraph

Biçimlendirmeyi destekleyen bir metin paragrafı. Google Chat uygulamalarında bir örnek için Biçimlendirilmiş metin paragrafı ekleme başlıklı makaleyi inceleyin. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
text

string

Widget'ta gösterilen metin.

maxLines

int32

Widget'ta gösterilen maksimum metin satırı sayısı. Metin, belirtilen maksimum satır sayısını aşarsa fazla içerik daha fazla göster düğmesinin arkasına gizlenir. Metin, belirtilen maksimum satır sayısına eşit veya daha kısaysa daha fazla göster düğmesi gösterilmez.

Varsayılan değer 0'dır. Bu durumda tüm bağlam gösterilir. Negatif değerler yoksayılır.

Doğrulama

Bağlı olduğu widget'ı doğrulamak için gerekli verileri temsil eder.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Alanlar
characterLimit

int32

Metin girişi widget'ları için karakter sınırını belirtin. Bu özelliğin yalnızca metin girişi için kullanıldığını ve diğer widget'lar için yoksayıldığını unutmayın.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

inputType

InputType

Giriş widget'larının türünü belirtin.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

InputType

Giriş widget'ının türü.

Sıralamalar
INPUT_TYPE_UNSPECIFIED Belirtilmemiş tür. Kullanmayın.
TEXT Tüm karakterleri kabul eden normal metin.
INTEGER Tam sayı değeri.
FLOAT Kayan noktalı değer.
EMAIL Bir e-posta adresi.
EMOJI_PICKER Sistem tarafından sağlanan emoji seçiciden seçilen bir emoji.

Widget

Her kart widget'lardan oluşur.

Widget, metin, resim, düğme ve diğer nesne türlerinden birini temsil edebilen birleşik bir nesnedir.

Alanlar
horizontalAlignment

HorizontalAlignment

Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.

Birlik alanı data. Bir widget'ta yalnızca aşağıdaki öğelerden biri bulunabilir. Daha fazla öğe görüntülemek için birden fazla widget alanı kullanabilirsiniz. data yalnızca aşağıdakilerden biri olabilir:
textParagraph

TextParagraph

Metin paragrafı gösterir. Basit HTML biçimli metinleri destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

Örneğin, aşağıdaki JSON kalın metin oluşturur:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

Image

Bir resim görüntüler.

Örneğin, aşağıdaki JSON, alternatif metin içeren bir resim oluşturur:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

DecoratedText

Süslenmiş bir metin öğesi gösterir.

Örneğin, aşağıdaki JSON, e-posta adresini gösteren süslenmiş bir metin widget'ı oluşturur:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

ButtonList

Düğme listesi.

Örneğin, aşağıdaki JSON iki düğme oluşturur. Birincisi mavi metin düğmesi, ikincisi ise bağlantı açan resim düğmesidir:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

TextInput

Kullanıcıların metin yazabileceği bir metin kutusu gösterir.

Örneğin, aşağıdaki JSON, bir e-posta adresi için metin girişi oluşturur:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Başka bir örnek olarak, aşağıdaki JSON, statik öneriler içeren bir programlama dili için metin girişi oluşturur:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

SelectionInput

Kullanıcıların öğe seçmesine olanak tanıyan bir seçim denetimi gösterir. Seçim kontrolleri onay kutuları, radyo düğmeleri, anahtarlar veya açılır menüler olabilir.

Örneğin, aşağıdaki JSON, kullanıcıların bir beden seçmesine olanak tanıyan bir açılır menü oluşturur:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

DateTimePicker

Kullanıcıların tarih, saat veya tarih ve saat girmelerine olanak tanıyan bir widget gösterir.

Örneğin, aşağıdaki JSON, randevu planlamak için bir tarih ve saat seçici oluşturur:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}
divider

Divider

Widget'lar arasında yatay bir çizgi ayırıcı gösterir.

Örneğin, aşağıdaki JSON bir bölücü oluşturur:

"divider": {
}
grid

Grid

Öğe koleksiyonunun yer aldığı bir ızgara görüntüler.

Izgara, istediğiniz sayıda sütun ve öğeyi destekler. Satır sayısı, öğe sayısının üst sınırlarına sütun sayısına bölünmesiyle belirlenir. 10 öğe ve 2 sütun içeren bir tabloda 5 satır vardır. 11 öğe ve 2 sütun içeren bir tabloda 6 satır bulunur.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Örneğin, aşağıdaki JSON tek bir öğe içeren 2 sütunlu bir ızgara oluşturur:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

Columns

En fazla 2 sütun görüntülenir.

2'den fazla sütun eklemek veya satır kullanmak için Grid widget'ını kullanın.

Örneğin, aşağıdaki JSON her biri metin paragrafları içeren 2 sütun oluşturur:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

Carousel

Bant, iç içe yerleştirilmiş widget'lardan oluşan bir koleksiyon içerir. Örneğin, bu iki metin paragrafı içeren bir bandın JSON gösterimidir.

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}
chipList

ChipList

Çiplerin listesi.

Örneğin, aşağıdaki JSON iki çip oluşturur. İlki bir metin çipi, ikincisi ise bağlantı açan bir simge çipidir:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

HorizontalAlignment

Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.

Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Sıralamalar
HORIZONTAL_ALIGNMENT_UNSPECIFIED Kullanmayın. Belirtilmedi.
START Varsayılan değer. Widget'ları sütunun başlangıç konumuna hizalar. Soldan sağa düzenler için sola hizalanır. Sağdan sola düzenler için sağa hizalanır.
CENTER Widget'ları sütunun ortasına hizalar.
END Widget'ları sütunun son konumuna hizalar. Soldan sağa düzenler için widget'ları sağa hizalar. Sağdan sola düzenler için widget'ları sola hizalar.

ImageType

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

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

Sıralamalar
SQUARE Varsayılan değer. Resme kare maske uygular. Örneğin, 4x3 boyutundaki bir resim 3x3 boyutuna getirilir.
CIRCLE Resme dairesel bir maske uygular. Örneğin, 4x3 boyutunda bir resim 3 çapında bir daire haline gelir.