Cards v2

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 kartları tasarlayın ve önizleyin.

Kart Oluşturucu'yu açın

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

• Google Chat uygulamaları için Kart veya iletişim kutusunun bileşenlerini tasarlama başlıklı makaleyi inceleyin.
• Google Workspace eklentileri için Kart tabanlı arayüzler bölümüne bakın.

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

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": "[e-mail]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "[phone]"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}

JSON gösterimi
{ "header": { object (CardHeader) }, "sections": [ { object (Section) } ], "sectionDividerStyle": enum (DividerStyle), "cardActions": [ { object (CardAction) } ], "name": string, "fixedFooter": { object (CardFixedFooter) }, "displayStyle": enum (DisplayStyle), "peekCardHeader": { object (CardHeader) } }

Alanlar
header	object (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[]	object (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	enum (DividerStyle) Başlık, bölümler ve alt bilgi arasındaki ayırıcı stili.
cardActions[]	object (CardAction) Kartın işlemleri. İşlemler, kartın araç çubuğu menüsüne eklenir. Google Workspace Eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz. Örneğin, aşağıdaki JSON, Settings ve Send Feedback seçenekleriyle 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 Eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
fixedFooter	object (CardFixedFooter) Bu kartın alt kısmında gösterilen sabit altbilgi. primaryButton veya secondaryButton belirtmeden fixedFooter değerini 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	enum (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	object (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.

CardHeader

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

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

JSON gösterimi
{ "title": string, "subtitle": string, "imageType": enum (ImageType), "imageUrl": string, "imageAltText": string }

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'ün altında kendi satırında görünür.
imageType	enum (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.

ImageType

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

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

Sıralamalar
SQUARE	Varsayılan değer. Resme kare maske uygular. Örneğin, 4x3 boyutundaki bir resim 3x3 boyutunda olur.
CIRCLE	Resme dairesel bir maske uygular. Örneğin, 4x3 boyutundaki bir resim 3 çaplı bir daireye dönüştürülür.

Bölüm

Bir bölüm, belirtildikleri sırayla dikey olarak oluşturulan widget koleksiyonunu içerir.

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

JSON gösterimi
{ "header": string, "widgets": [ { object (Widget) } ], "collapsible": boolean, "uncollapsibleWidgetsCount": integer, "collapseControl": { object (CollapseControl) } }

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 metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makalelere göz atın.
widgets[]	object (Widget) Bölümdeki tüm widget'lar. En az bir widget içermelidir.
collapsible	boolean Bu bölümün daraltılabilir olup olmadığını gösterir. Daraltılabilir bölümler widget'ların bazılarını veya tümü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. Gizlenen widget'ları belirlemek için uncollapsibleWidgetsCount değerini belirtin.
uncollapsibleWidgetsCount	integer 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 değeri 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	object (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. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

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.

JSON gösterimi

{ "horizontalAlignment": enum (HorizontalAlignment), // Union field data can be only one of the following: "textParagraph": { object (TextParagraph) }, "image": { object (Image) }, "decoratedText": { object (DecoratedText) }, "buttonList": { object (ButtonList) }, "textInput": { object (TextInput) }, "selectionInput": { object (SelectionInput) }, "dateTimePicker": { object (DateTimePicker) }, "divider": { object (Divider) }, "grid": { object (Grid) }, "columns": { object (Columns) }, "chipList": { object (ChipList) } // End of list of possible types for union field data. }

Alanlar
horizontalAlignment	enum (HorizontalAlignment) Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.
Birleştirme alanı data. Widget'larda 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	object (TextParagraph) Bir metin paragrafını görüntüler. Basit HTML biçimli metinleri destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makalelere göz atın. Örneğin, aşağıdaki JSON kalın metin oluşturur: "textParagraph": { "text": " <b>bold text</b>" }
image	object (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	object (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": "[e-mail]", "bottomLabel": "This is a new Email address!", "switchControl": { "name": "has_send_welcome_email_to_sasha", "selected": false, "controlType": "CHECKBOX" } }
buttonList	object (ButtonList) Düğme listesi. Örneğin, aşağıdaki JSON dosyası 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	object (TextInput) Kullanıcıların metin yazabileceği bir metin kutusu görüntüler. Ö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	object (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 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	object (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	object (Divider) Widget'lar arasında yatay bir çizgi ayırıcısı görüntüler. Örneğin, aşağıdaki JSON bir bölücü oluşturur: "divider": { }
grid	object (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ının 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 Eklentilerinde 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	object (Columns) En fazla 2 sütun gösterir. 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" } } ] } ] }
chipList	object (ChipList) Çiplerin listesi. Örneğin, aşağıdaki JSON iki çip oluşturur. İlki metin çipi, ikincisi ise bağlantıyı açan bir simge çipidir. "chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] } Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

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 metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makalelere göz atın.

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

JSON gösterimi
{ "text": string, "maxLines": integer }

Alanlar
text	string Widget'ta gösterilen metin.
maxLines	integer 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ında saklanır. Metin, belirtilen maksimum satır sayısına eşit veya bundan 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. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

Resim

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

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

JSON gösterimi
{ "imageUrl": string, "onClick": { object (OnClick) }, "altText": string }

Alanlar
imageUrl	string Resmi barındıran HTTPS URL'si. Örneğin: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick	object (OnClick) Kullanıcı resmi tıkladığında bu işlem tetiklenir.
altText	string Bu resmin erişilebilirlik için kullanılan alternatif metni.

OnClick

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

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

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) }, "overflowMenu": { object (OverflowMenu) } // End of list of possible types for union field data. }

Alanlar
Birlik alanı data. data yalnızca aşağıdakilerden biri olabilir:
action	object (Action) Belirtilirse bu onClick tarafından bir işlem tetiklenir.
openLink	object (OpenLink) Belirtilirse bu onClick bağlantı açma işlemini tetikler.
openDynamicLinkAction	object (Action) Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde bu işlemi tetikler. Bu, bağlantıyı almak için sunucuya danışması gerektiğinden yukarıdaki openLink yönteminden 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 Eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
card	object (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	object (OverflowMenu) Belirtilirse bu onClick, bir taşma menüsü açar. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

İş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 eklentilerinde kullanılabilir.

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

Alanlar
function	string İçerdiği öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel işlev. Kullanım örneği için Form verilerini okuma bölümünü inceleyin.
parameters[]	object (ActionParameter) İşlem parametrelerinin listesi.
loadIndicator	enum (LoadIndicator) Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.
persistValues	boolean İşlemden sonra form değerlerinin kalıcı olup olmadığını gösterir. Varsayılan değer: false. true ise form değerleri, işlem tetiklendikten sonra 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 de işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId metnini kullanmanız 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	enum (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, bir bağlantıyı açma veya bir işlevi çalıştırma gibi bir action çalıştırarak normal şekilde yanıt verir. interaction belirterek uygulama ö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 Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Developer Preview Programı kapsamında kullanılabilir. İ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 İşlem çağrıldığında burada listelenen widget'ların bir değeri yoksa form gönderme işlemi iptal edilir. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
allWidgetsAreRequired	boolean Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Developer Preview Programı kapsamında kullanılabilir. İ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 Eklentilerinde 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() işlevini kullanarak, ertele türünü ve ertele süresini dize parametreleri listesine iletebilirsiniz.

Daha fazla bilgi için CommonEventObject konusuna bakın.

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

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

Alanlar
key	string İşlem komut dosyası parametresinin adı.
value	string Parametrenin değeri.

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 eklentilerinde kullanılabilir.

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

Etkileşim

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

Bir kullanıcıyla kurulan etkileşimlere (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak ne yapılması gerekir?

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

Uygulama, bir interaction belirtildiğinde özel etkileşimli yöntemlerle 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, 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. 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.

OpenLink

Bir köprü açan bir etkinliği temsil eder. onClick

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

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

Alanlar
url	string Açılacak URL.
openAs	enum (OpenAs) Bağlantıyı açma. Google Workspace Eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
onClose	enum (OnClose) İstemcinin, bağlantıyı açtıktan sonra bağlantıyı unutup unutmayacağını veya pencere kapanana kadar bağlantıyı gözlemleyip gözlemleyemeyeceğini belirtir. Google Workspace Eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.

OpenAs

Bir OnClick işlem 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 platformu özelliklerine bağlıdır ve seçilen değer istemci tarafından desteklenmiyorsa 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 pencere olarak 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.

OnClose

OnClick işlemi tarafından açılan bir bağlantı kapatıldığında istemcinin ne yaptığıdır.

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

Hem OnOpen hem de OnClose işleyiciler ayarlanmışsa ve istemci platformu her iki değeri de desteklemiyorsa 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.

OverflowMenu

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

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

JSON gösterimi
{ "items": [ { object (OverflowMenuItem) } ] }

Alanlar
items[]	object (OverflowMenuItem) Zorunlu. Menü seçeneklerinin listesi.

OverflowMenuItem

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

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

JSON gösterimi
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

Alanlar
startIcon	object (Icon) Metnin önünde gösterilen simge.
text	string Zorunlu. Öğeyi kullanıcılara tanımlayan veya açıklayan metin.
onClick	object (OnClick) Zorunlu. Bir menü seçeneği seçildiğinde çağrılan işlem. Bu OnClick bir OverflowMenu içeremez, belirtilen herhangi bir OverflowMenu atlanır ve menü öğesi devre dışı bırakılır.
disabled	boolean Menü seçeneğinin devre dışı bırakılıp bırakılmayacağı. Varsayılan olarak yanlış değerine ayarlanır.

Simge

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

Yerleşik ve özel simgeleri destekler.

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

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

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 sağlanır. 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 olarak ayarlanmışsa kullanıcı düğmenin üzerine geldiğinde altText yardım metni olarak görünür. Ancak düğme aynı zamanda text değerini de ayarlarsa simgenin altText değeri yoksayılır.
imageType	enum (ImageType) Resme uygulanan kırpma stili. Bazı durumlarda, kırpma uygulanması, resmin yerleşik bir simge olduğundan daha büyük çizilmesine neden olur.
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 bölümüne bakın.
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 şunları içerir: .png ve .jpg.
materialIcon	object (MaterialIcon) Google Material simgelerinden birini gösterin. Örneğin, bir onay kutusu simgesi görüntülemek için "materialIcon": { "name": "check_box" } Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

MaterialIcon

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

Örneğin, özelleştirilmiş ağırlık ve sınıflandırmaya sahip bir onay kutusu simgesi görüntülemek için aşağıdakileri yazın:

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

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

JSON gösterimi
{ "name": string, "fill": boolean, "weight": integer, "grade": integer }

Alanlar
name	string Google Material simgesi bölümü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	boolean Simgenin doldurulmuş 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ı düzenleyin.
weight	integer Simgenin çizgi kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Yoksa varsayılan değer 400 olur. Başka bir değer belirtilirse varsayılan değer kullanılır. Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgeleri'ne gidip Özelleştir altındaki ayarları düzenleyin.
grade	integer Ağırlık ve sınıf, sembolün kalınlığını etkiler. Eğim ayarlamaları, ağırlıkta yapılan ayarlamalardan daha ayrıntılıdır ve simgenin boyutu üzerinde küçük bir etkisi vardır. {-25, 0, 200} arasından seçim yapın. Yoksa varsayılan değer 0 olur. Başka bir değer belirtilirse varsayılan değer kullanılır. Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgeleri'ne gidip Özelleştir altındaki ayarları düzenleyin.

DecoratedText

Metnin üstünde veya altında etiket, metnin önünde bir simge, bir seçim widget'ı veya metinden sonra bir düğme gibi isteğe bağlı süslemeleri olan bir metin görüntüleyen bir widget. Google Chat uygulamalarıyla ilgili bir örnek için Metni süsleme amaçlı metinle görüntüleme bölümüne bakın.

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

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 öğenin desteği sonlandırıldı. startIcon yerine kullanımdan kaldırıldı.
startIcon	object (Icon) Metnin önünde gösterilen simge.
topLabel	string text ü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 metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makalelere göz atın.
wrapText	boolean Metni kaydırma ayarı. true değerine ayarlanırsa metin kaydırılır ve birden fazla satırda görüntülenir. 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 altında görünen metin. Her zaman sarar.
onClick	object (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	object (Button) Kullanıcının bir işlemi tetiklemek için tıklayabileceği bir düğme.
switchControl	object (SwitchControl) Kullanıcının durumunu değiştirip bir işlem tetiklemek için tıklayabileceği bir anahtar widget'ı.
endIcon	object (Icon) Metinden sonra görüntülenen bir simge. Yerleşik ve özel simgeleri destekler.

Düğme

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge düğmesi. Google Chat uygulamalarında örnek görmek için Düğme ekleme başlıklı makaleyi inceleyin.

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

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

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

Alanlar
text	string Düğmenin içinde gösterilen metin.
icon	object (Icon) Düğmenin içinde gösterilen simge. Hem icon hem de text ayarlanırsa simge metinden önce görünür.
color	object (Color) İsteğe bağlı. Düğmenin rengi. Ayarlanırsa 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 sayılarda 0 (0/255) rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder. Örneğin, aşağıda renk, maksimum yoğunluğunda kırmızıya ayarlanır: "color": { "red": 1, "green": 0, "blue": 0, } alpha alanı, düğme rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.
onClick	object (OnClick) Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel işlev çalıştırma).
disabled	boolean true ise düğme etkin değil durumda görüntülenir 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 bir köprü açarsa şöyle yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici dokümanlarına gider".
type	enum (Type) İsteğe bağlı. Düğmenin türü. Ayarlanmazsa düğme türü varsayılan olarak OUTLINED olur. color alanı ayarlanmışsa düğme türü FILLED olarak zorlanır ve bu alan için ayarlanan tüm değerler yoksayılır. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Renk

RGBA renk alanındaki bir rengi temsil eder. Bu sunum, kompaktlık yerine, çeşitli dillerdeki renk gösterimlerine ve bu gösterimlerden dönüştürmenin basitleştirilmesi için tasarlanmıştır. Örneğin, bu temsilin alanları Java'da java.awt.Color sınıfının oluşturucusuna kolayca sağlanabilir; iOS'te UIColor sınıfının +colorWithRed:green:blue:alpha yöntemine de kolayca sağlanabilir. Ayrıca, biraz çalışmayla JavaScript'te kolayca bir CSS rgba() dizesi biçiminde ayarlanabilir.

Bu referans sayfasında, RGB değerini yorumlamak için kullanılması gereken mutlak renk alanıyla ilgili bilgiler (ör. sRGB, Adobe RGB, DCI-P3 ve BT.2020) yer almaz. Varsayılan olarak uygulamalar sRGB renk alanını kullanmalıdır.

Renk eşitliğine karar verilmesi gerektiğinde, aksi belirtilmediği sürece uygulamalar, kırmızı, yeşil, mavi ve alfa değerlerinin her biri en fazla 1e-5 kadar farklıysa iki rengi eşit olarak kabul eder.

Örnek (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Örnek (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Örnek (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...

JSON gösterimi
{ "red": number, "green": number, "blue": number, "alpha": number }

Alanlar
red	number [0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı.
green	number [0, 1] aralığındaki bir değer olarak renkteki yeşil miktarı.
blue	number [0, 1] aralığındaki bir değer olarak renkteki mavi miktarı.
alpha	number Bu rengin piksele uygulanması gereken oranı. Yani nihai piksel rengi şu denklemle tanımlanır: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Bu, 1.0 değerinin düz bir renge karşılık gelirken, 0.0 değerinin tamamen şeffaf bir renge karşılık geldiği anlamına gelir. Varsayılan değer ile ayarlanmamış değer arasında ayrım yapılabilmesi için bu işlemde basit bir kayan nokta skaler yerine sarmalayıcı mesaj kullanılır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açıkça 1,0 değeri verilmiş gibi).

Tür

İsteğe bağlı. Düğmenin türü. color alanı ayarlandıysa type FILLED değerine 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ş ton düğmesi, dolgulu ve dış çizgili düğmeler arasında alternatif bir orta noktadır. Düşük öncelikli bir düğmenin, ana hat düğmesinin sağlayacağından biraz daha fazla vurgu gerektirdiği durumlarda kullanışlıdır.
BORDERLESS	Düğmenin varsayılan durumunda görünmez bir kapsayıcısı yoktur. Genellikle en düşük öncelikli işlemler için kullanılır. Özellikle birden fazla seçenek sunulduğunda tercih edilir.

Anahtar Kontrolü

Açma/kapatma tarzı bir anahtar veya bir decoratedText widget'ının içindeki bir onay kutusu.

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

Yalnızca decoratedText widget'ında desteklenir.

JSON gösterimi
{ "name": string, "value": string, "selected": boolean, "onChangeAction": { object (Action) }, "controlType": enum (ControlType) }

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 edinmek 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 edinmek için Form verilerini alma başlıklı makaleyi inceleyin.
selected	boolean true olduğunda anahtar seçilidir.
onChangeAction	object (Action) Anahtar durumu değiştiğinde yapılacak işlem (ör. hangi işlevin çalıştırılacağı).
controlType	enum (ControlType) Anahtarın kullanıcı arayüzünde nasıl görüneceği. 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 eklentilerinde kullanılabilir.

Sıralamalar
SWITCH	Açma/kapatma düğmesi.
CHECKBOX	Kullanımdan kaldırıldı ve yerini CHECK_BOX aldı.
CHECK_BOX	Onay kutusu.

ButtonList

Yatay olarak yerleştirilmiş düğmelerin listesi. Google Chat uygulamalarında örnek görmek için Düğme ekleme başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

JSON gösterimi
{ "buttons": [ { object (Button) } ] }

Alanlar
buttons[]	object (Button) Düğme dizisi.

TextInput

Kullanıcıların metin girebileceği bir alan. Önerileri ve değişiklikle ilgili işlemleri destekler. Google Chat uygulamaları ile ilgili bir örnek için Kullanıcının metin girebileceği bir alan ekleme bölümüne göz atın.

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 edinmek 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 listelenmiş veriler toplamak için SelectionInput widget'ını kullanın.

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

JSON gösterimi
{ "name": string, "label": string, "hintText": string, "value": string, "type": enum (Type), "onChangeAction": { object (Action) }, "initialSuggestions": { object (Suggestions) }, "autoCompleteAction": { object (Action) }, "validation": { object (Validation) }, "placeholderText": string }

Alanlar
name	string Form girişi etkinliğinde metin girişinin tanımlandığı ad. Form girişleriyle çalışma hakkında ayrıntılar için Form verilerini alma bölümüne bakın.
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 Kullanıcı tarafından girilen ve bir form giriş etkinliğinin parçası olarak döndürülen değer. Form girişleriyle çalışma hakkında ayrıntılı bilgi edinmek için Form verilerini alma başlıklı makaleyi inceleyin.
type	enum (Type) Metin giriş alanının kullanıcı arayüzünde nasıl göründüğü. Örneğin, alanın tek mi yoksa çok satırlı mı olduğu.
onChangeAction	object (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 dizisi açma verilebilir.
initialSuggestions	object (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ı kullanıcılar ise java script yazabilir. Öneriler sunmak JavaScript kullanıcıların uygulamanızla nasıl etkileşime gireceğini standartlaştırabilir. Belirtildiği durumlarda, TextInput.type her zaman MULTIPLE_LINE olarak ayarlanmış olsa bile SINGLE_LINE olur. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
autoCompleteAction	object (Action) İsteğe bağlı. Metin giriş alanı, etkileşimde bulunan kullanıcılara öneriler sunduğunda 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	object (Validation) Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Developer Preview Programı kapsamında kullanılabilir. Bu metin giriş alanı için gerekli doğrulamayı 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ında kullanılabilir, 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 eklentilerinde 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.

RenderActions

Karta bir işlem yapmasını veya eklenti ana makine uygulamasına ya da Chat uygulamasına uygulamaya özel bir işlem yapmasını söyleyen bir dizi oluşturma talimatı.

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

Alanlar
action	Action

İşlem

Alanlar
navigations[]	Navigation Gösterilen kartları gönderin veya güncelleyin.

Gezinme

Grupa yeni bir kart ekleyin (ileri gidin). Chat uygulamaları için yalnızca uygulama ana sayfasında kullanılabilir.

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

navigations: {
  pushCard: CARD
}

Üstteki kartı yeni bir kartla değiştirin. Chat uygulamaları için yalnızca uygulama ana sayfasında kullanılabilir.

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

navigations: {
  updateCard: CARD
}

Alanlar
Birlik alanı navigate_action. navigate_action şunlardan yalnızca biri olabilir:
pushCard	Card Kart yığını, bir kartı kart yığınına aktarır.
updateCard	Card Kart yığını, en üstteki kartı yeni bir kartla günceller ve doldurulmuş form alanları değerlerini korur. Eşdeğer olmayan bir alan için değer atlanı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 anlamlandırabileceği değerleri girmelerine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript, bazı kullanıcılar ise java script yazabilir. Öneriler JavaScript , kullanıcıların uygulamanızla nasıl etkileşime gireceğini standartlaştırabilir.

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

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

JSON gösterimi
{ "items": [ { object (SuggestionItem) } ] }

Alanlar
items[]	object (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 eklentilerinde kullanılabilir.

JSON gösterimi
{ // Union field content can be only one of the following: "text": string // End of list of possible types for union field content. }

Alanlar
Birlik alanı content. content aşağıdakilerden yalnızca biri olabilir:
text	string Metin girişi alanına önerilen girişin değeri. Bu, kullanıcıların kendi girişleriyle eşdeğerdir.

Doğrulama

Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.

Eklendiği widget'ı doğrulamak için gerekli verileri temsil eder.

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

JSON gösterimi
{ "characterLimit": integer, "inputType": enum (InputType) }

Alanlar
characterLimit	integer Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Developer Preview Programı kapsamında kullanılabilir. Metin girişi widget'ları için karakter sınırını belirtin. Bunun 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 Eklentilerinde kullanılabilir.
inputType	enum (InputType) Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Developer Preview Programı kapsamında kullanılabilir. 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 değer.
EMAIL	E-posta adresi.
EMOJI_PICKER	Sistem tarafından sağlanan emoji seçiciden seçilen bir emoji.

SelectionInput

Kullanıcıların seçebileceği bir veya daha fazla kullanıcı arayüzü öğesi oluşturan widget. Örneğin, açılır menü veya onay kutuları. Tahmin edilebilir veya sayılabilir veriler 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ılar için Form verilerini alma bölümüne bakın.

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

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

JSON gösterimi

{ "name": string, "label": string, "type": enum (SelectionType), "items": [ { object (SelectionItem) } ], "onChangeAction": { object (Action) }, "multiSelectMaxSelectedItems": integer, "multiSelectMinQueryLength": integer, "validation": { object (Validation) }, // Union field multi_select_data_source can be only one of the following: "externalDataSource": { object (Action) }, "platformDataSource": { object (PlatformDataSource) } // End of list of possible types for union field multi_select_data_source. }

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 edinmek 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	enum (SelectionType) Kullanıcılara widget'ta gösterilen öğelerin türü SelectionInput 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[]	object (SelectionItem) Seçilebilir öğe dizisi. Örneğin, bir radyo düğmesi veya onay kutusu dizisi. En fazla 100 öğeyi destekler.
onChangeAction	object (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ılar için Form verilerini alma bölümüne bakın.
multiSelectMaxSelectedItems	integer Çoklu seçim menüleri için, bir 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	integer Ç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ü statik bir SelectionInput öğe dizisi kullanıyorsa varsayılan olarak 0 karakterdir ve öğeler hemen diziden doldurulur. Menüde bir dinamik veri kaynağı (multi_select_data_source) kullanılıyorsa önerilen öğelerin döndürülmesi için veri kaynağını sorgulamadan önce varsayılan olarak 3 karakter kullanılır.
validation	object (Validation) Açılır menüler için bu seçim giriş alanının doğrulaması. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
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	object (Action) İlişkisel veritabanı gibi harici bir veri kaynağı.
platformDataSource	object (PlatformDataSource) Google Workspace'teki bir veri kaynağı.

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 işaretleyebilir, 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 eklentilerinde 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. Bu durumda 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.

SelectionItem

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

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

JSON gösterimi
{ "text": string, "value": string, "selected": boolean, "startIconUri": string, "bottomText": string }

Alanlar
text	string Öğeyi kullanıcılara tanımlayan veya açıklayan metin.
value	string Bu öğeyle ilişkilendirilen değer. Müşteri bunu form giriş değeri olarak kullanmalıdır. Form girişleriyle çalışma hakkında ayrıntılı bilgi edinmek için Form verilerini alma başlıklı makaleyi inceleyin.
selected	boolean Öğ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 alanın yanında görüntülenen simgeye ait URL. text 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 alanının altında görüntülenen metin açıklaması veya etiket. text

PlatformDataSource

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

Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

JSON gösterimi
{ // Union field data_source can be only one of the following: "commonDataSource": enum (CommonDataSource), "hostAppDataSource": { object (HostAppDataSourceMarkup) } // End of list of possible types for union field data_source. }

Alanlar
Birlik alanı data_source. Veri kaynağı. data_source yalnızca aşağıdakilerden biri olabilir:
commonDataSource	enum (CommonDataSource) Tüm Google Workspace uygulamaları tarafından paylaşılan veri kaynağı (ör. Google Workspace kuruluşlarındaki kullanıcılar).
hostAppDataSource	object (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 edinmek 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ğı.

Google Chat uygulamalarında kullanılabilir, 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üleyip seçebilir.

HostAppDataSourceMarkup

Çoklu seçim menüsü kullanan bir SelectionInput widget için Google Workspace uygulamasından bir veri kaynağı. Veri kaynağı, çoklu seçim menüsü için seçim öğelerini doldurur.

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

JSON gösterimi
{ // Union field data_source can be only one of the following: "chatDataSource": { object (ChatClientDataSourceMarkup) } // End of list of possible types for union field data_source. }

Alanlar
Birlik alanı data_source. Çoklu seçim menüsüne öğe ekleyen Google Workspace uygulaması. data_source aşağıdakilerden yalnızca biri olabilir:
chatDataSource	object (ChatClientDataSourceMarkup) Google Chat'ten bir veri kaynağı.

ChatClientDataSourceMarkup

Çoklu seçim menüsü kullanan bir SelectionInput widget için Google Chat'teki bir veri kaynağı. Veri kaynağı, çoklu seçim menüsü için seçim öğelerini doldurur. Örneğin, bir kullanıcı üyesi olduğu Google Chat alanlarını seçebilir.

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

JSON gösterimi
{ // Union field source can be only one of the following: "spaceDataSource": { object (SpaceDataSource) } // End of list of possible types for union field source. }

Alanlar
Birleştirme alanı source. Google Chat veri kaynağı. source yalnızca aşağıdakilerden biri olabilir:
spaceDataSource	object (SpaceDataSource) Kullanıcının üyesi olduğu Google Chat alanları.

SpaceDataSource

Google Chat alanlarını çoklu seçim menüsü için seçim öğeleri olarak dolduran bir veri kaynağı. Yalnızca kullanıcının üyesi olduğu alanları doldurur.

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

JSON gösterimi
{ "defaultToCurrentSpace": boolean }

Alanlar
defaultToCurrentSpace	boolean true değerine ayarlanırsa çoklu seçim menüsü, mevcut Google Chat alanını varsayılan olarak öğe olarak seçer.

DateTimePicker

Kullanıcıların tarih, saat veya hem tarih hem de saat girmesine olanak tanır. Google Chat uygulamalarıyla ilgili bir ö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 Eklentilerinde kullanılabilir.

JSON gösterimi
{ "name": string, "label": string, "type": enum (DateTimePickerType), "valueMsEpoch": string, "timezoneOffsetDate": integer, "onChangeAction": { object (Action) }, "validation": { object (Validation) } }

Alanlar
name	string Form girişi etkinliğinde DateTimePicker öğesinin tanımlandığı ad. Form girişleriyle çalışma hakkında ayrıntılı bilgi edinmek 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	enum (DateTimePickerType) Widget'ın tarih, saat veya tarih ve saat girişini destekleyip desteklemediği.
valueMsEpoch	string (int64 format) Unix dönem zamanından itibaren widget'ta gösterilen varsayılan değer (milisaniye cinsinden). 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) 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 değerini 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	integer UTC ile saat dilimi arasındaki farkı dakika cinsinden temsil eden sayı. Ayarlanırsa valueMsEpoch belirtilen saat diliminde gösterilir. Ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.
onChangeAction	object (Action) Kullanıcı DateTimePicker arayüzünden Kaydet veya Temizle'yi tıkladığında tetiklenir.
validation	object (Validation) Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir. İsteğe bağlı. Bu tarih zamanlayıcı seçici için gereken doğrulamayı belirtin. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

DateTimePickerType

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

Google Chat uygulamaları ve Google Workspace eklentilerinde 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.

Refüj

Bu türde alan yok.

Widget'lar arasında bir ayırıcıyı yatay çizgi olarak görüntüler. 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 Eklentilerinde kullanılabilir.

Örneğin, aşağıdaki JSON bir ayırıcı oluşturur:

"divider": {}

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 Eklentilerinde 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"
    }
  }
}

JSON gösterimi
{ "title": string, "items": [ { object (GridItem) } ], "borderStyle": { object (BorderStyle) }, "columnCount": integer, "onClick": { object (OnClick) } }

Alanlar
title	string Izgara başlığında gösterilen metin.
items[]	object (GridItem) Izgarada gösterilecek öğeler.
borderStyle	object (BorderStyle) Her ızgara öğesine uygulanacak kenar stili.
columnCount	integer Izgarada görüntülenecek 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	object (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

Bir öğeyi ızgara düzeninde gösterir. Öğeler metin, resim veya hem metin hem de resim içerebilir.

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

JSON gösterimi
{ "id": string, "image": { object (ImageComponent) }, "title": string, "subtitle": string, "layout": enum (GridItemLayout) }

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 callback parametrelerinde döndürülür.
image	object (ImageComponent) Tablo öğesinde görüntülenen resim.
title	string Izgara öğesinin başlığı.
subtitle	string Izgara öğesinin alt başlığı.
layout	enum (GridItemLayout) Izgara öğesi için kullanılacak düzen.

ImageComponent

Bir resmi temsil eder.

Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

JSON gösterimi
{ "imageUri": string, "altText": string, "cropStyle": { object (ImageCropStyle) }, "borderStyle": { object (BorderStyle) } }

Alanlar
imageUri	string Resim URL'si.
altText	string Resmin erişilebilirlik etiketi.
cropStyle	object (ImageCropStyle) Resme uygulanacak kırpma stili.
borderStyle	object (BorderStyle) Resme uygulanacak kenarlık stili.

ImageCropStyle

Bir resme uygulanan kırpma stilini temsil eder.

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

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

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

JSON gösterimi
{ "type": enum (ImageCropType), "aspectRatio": number }

Alanlar
type	enum (ImageCropType) Kırpma türü.
aspectRatio	number Kırpma türü RECTANGLE_CUSTOM ise kullanılacak en boy oranı. Örneğin, 16:9 en boy oranının nasıl uygulanacağı aşağıda açıklanmıştır: cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }

ImageCropType

Bir resme uygulanan kırpma stilini temsil eder.

Google Chat uygulamaları ve Google Workspace eklentilerinde 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 kırpma uygular.

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 eklentilerinde kullanılabilir.

JSON gösterimi
{ "type": enum (BorderType), "strokeColor": { object (Color) }, "cornerRadius": integer }

Alanlar
type	enum (BorderType) Kenarlık türü.
strokeColor	object (Color) Tür BORDER_TYPE_STROKE olduğunda kullanılacak renkler. Çizgi 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 sayılarda 0 (0/255) rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder. Örneğin, aşağıda renk, maksimum yoğunluğunda kırmızıya ayarlanır: "color": { "red": 1, "green": 0, "blue": 0, } alpha alanı, çizgi rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.
cornerRadius	integer Kenarlık için köşe yarıçapı.

BorderType

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

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

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

GridItemLayout

Izgara öğesi için kullanılabilecek çeşitli düzen seçeneklerini gösterir.

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

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

Sütunlar

Columns widget'ı, bir kart 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 başlıklı makaleyi inceleyin.

Her sütunun yüksekliği, daha 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 yerleştirilir:

• 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 pt. veya daha az olduğunda ikinci sütun sarmalanır.
• Android cihazlarda, ekran genişliği 320 dp'den az veya bu değere eşitse ikinci sütun sarmalanır.

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

Google Chat uygulamaları ve Google Workspace eklentilerinde 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 bir Google Takvim etkinliğinde Ek iliştir menüsünden eklentiyi açtığında gösterilen iletişim kutusu.

JSON gösterimi
{ "columnItems": [ { object (Column) } ] }

Alanlar
columnItems[]	object (Column) Bir 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ı

JSON gösterimi
{ "horizontalSizeStyle": enum (HorizontalSizeStyle), "horizontalAlignment": enum (HorizontalAlignment), "verticalAlignment": enum (VerticalAlignment), "widgets": [ { object (Widgets) } ] }

Alanlar
horizontalSizeStyle	enum (HorizontalSizeStyle) Bir sütunun, kartın genişliğini nasıl dolduracağını belirtir.
horizontalAlignment	enum (HorizontalAlignment) Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.
verticalAlignment	enum (VerticalAlignment) Widget'ların bir sütunun üst, alt veya ortasına hizalanıp hizalanmayacağını belirtir.
widgets[]	object (Widgets) Bir sütuna dahil edilen widget dizisi. Widget'lar belirtildikleri sırayla 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 sütunun 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ın genişliğinin en fazla %30'unu kaplar.

YatayHizala

Widget'ların bir sütunun soluna, sağına 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 hizalar.
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.

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ı

JSON gösterimi

{ // Union field data can be only one of the following: "textParagraph": { object (TextParagraph) }, "image": { object (Image) }, "decoratedText": { object (DecoratedText) }, "buttonList": { object (ButtonList) }, "textInput": { object (TextInput) }, "selectionInput": { object (SelectionInput) }, "dateTimePicker": { object (DateTimePicker) }, "chipList": { object (ChipList) } // End of list of possible types for union field data. }

Alanlar
Birlik alanı data. data yalnızca aşağıdakilerden biri olabilir:
textParagraph	object (TextParagraph) TextParagraph widget'ı.
image	object (Image) Image widget'ı.
decoratedText	object (DecoratedText) DecoratedText widget'ı.
buttonList	object (ButtonList) ButtonList widget'ı.
textInput	object (TextInput) TextInput widget'ı.
selectionInput	object (SelectionInput) SelectionInput widget'ı.
dateTimePicker	object (DateTimePicker) DateTimePicker widget'ı.
chipList	object (ChipList) ChipList widget'ı. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

ChipList

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

Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

JSON gösterimi
{ "layout": enum (Layout), "chips": [ { object (Chip) } ] }

Alanlar
layout	enum (Layout) Belirtilen çip listesi düzeni.
chips[]	object (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.

Çip

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

Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

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

Alanlar
icon	object (Icon) Simge resmi. Hem icon hem de text ayarlanmışsa simge metnin önünde görünür.
label	string Çipin içinde gösterilen metin.
onClick	object (OnClick) İsteğe bağlı. Kullanıcı çipi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel bir işlev çalıştırma).
enabled (deprecated)	boolean Bu öğenin desteği sonlandırıldı. Ç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 kullanın.
disabled	boolean Ç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ılara çipin ne işe yaradığını gösteren 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.

CollapseControl

Genişletme ve daraltma kontrolünü temsil eder. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

JSON gösterimi
{ "horizontalAlignment": enum (HorizontalAlignment), "expandButton": { object (Button) }, "collapseButton": { object (Button) } }

Alanlar
horizontalAlignment	enum (HorizontalAlignment) Genişletme ve daraltma düğmesinin yatay hizası.
expandButton	object (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 olmayacaktır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.
collapseButton	object (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.

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 eklentilerinde 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.

CardAction

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

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

JSON gösterimi
{ "actionLabel": string, "onClick": { object (OnClick) } }

Alanlar
actionLabel	string İşlem menüsü öğesi olarak görüntülenen etiket.
onClick	object (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 değerini ayarlamak hataya neden olur.

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

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

JSON gösterimi
{ "primaryButton": { object (Button) }, "secondaryButton": { object (Button) } }

Alanlar
primaryButton	object (Button) Sabit altbilginin birincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır.
secondaryButton	object (Button) Sabit altbilginin ikincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır. secondaryButton ayarlanmışsa primaryButton değerini de ayarlamanız gerekir.

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.