Cards v2

Kart

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

Kartlar; tanımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resim gibi rich media'yı destekler. Ayrıntılı bilgiler sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adımı atmaya yönlendirmek için kartları kullanın.

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

Kart Oluşturucu'yu açın

Kartların nasıl oluşturulacağını öğrenmek için aşağıdaki dokümanlara bakın:

• Google Chat uygulamaları için: Bir kartın veya iletişim kutusunun bileşenlerini tasarlayın.
• Google Workspace eklentileri için bkz. Kart tabanlı arayüzler.

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

Google Chat'te örnek kart mesajını oluşturmak için aşağıdaki JSON 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ığı. Üstbilgiler 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) Widget koleksiyonu içerir. Her bölümün isteğe bağlı kendi başlığı vardır. Bölümler, çizgi ayırıcıyla görsel olarak ayrılır. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Kartın bir bölümünü tanımlayın.
sectionDividerStyle	enum (DividerStyle) Bölümler arasındaki ayırma 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 dosyasında Settings ve Send Feedback seçenekler: "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ı 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. Ayar fixedFooter bir primaryButton veya secondaryButton bir hataya neden olur. Chat uygulamalarında, sabit altbilgileri iletişim kutuları gösterilir, ancak kart mesajları verebilirsiniz. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
displayStyle	enum (DisplayStyle) Google Workspace eklentilerinde, peekCardHeader Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
peekCardHeader	object (CardHeader) Bağlamsal içerik görüntülenirken, göz atma kartı başlığı bir yer tutucu görevi görür. Böylece, kullanıcı ana sayfa kartları ile içerik kartları arasında ileri gidebilir. Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.

CardHeader

Kart başlığını temsil eder. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Bir başlık ekleyin.

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ığı. Üstbilginin sabit yüksekliği vardır: Hem başlık hem de alt başlık belirtilmişse her biri bir satır kaplar. Yalnızca başlık belirtilirse her iki satırı da kaplar.
subtitle	string Kart başlığının alt başlığı. Belirtilirse title
imageType	enum (ImageType) Resmi kırpmak için kullanılan şekil. Google Chat uygulamaları ve Google Workspace Eklentilerinde 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 yuvarlak bir maske uygular. Örneğin, 4x3 boyutundaki bir resim çapı 3 olan bir daireye dönüşü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 üst kısmında görünen metin. Basit HTML biçimlendirilmiş metni destekler. Metin biçimlendirme hakkında daha fazla bilgi için bkz. Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme.
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ı belirtir. Daraltılabilir bölümler widget'ların bazılarını veya tümünü gizler, ancak kullanıcılar bir öğeyi tıklayarak bölümü genişleterek gizli widget'ların gösterilmesini sağlayabilir. Daha fazla göster. Kullanıcılar şunu tıklayarak widget'ları tekrar gizleyebilir: Daha az göster. Hangi widget'ların gizleneceğini belirlemek için uncollapsibleWidgetsCount
uncollapsibleWidgetsCount	integer Bir bölüm daraltıldığında bile görünür kalan daraltılamayan widget'ların sayısı. Örneğin, bir bölümde beş widget ve uncollapsibleWidgetsCount , olarak ayarlandı 2, ilk iki widget her zaman gösterilir ve son üçü varsayılan olarak daraltılmış durumdadır. İlgili içeriği oluşturmak için kullanılan uncollapsibleWidgetsCount yalnızca collapsible : true.
collapseControl	object (CollapseControl) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. İ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ında kullanılabilir ve Google Workspace Eklentileriyle 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 soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir.
Birlik alanı data Bir widget'ta aşağıdaki öğelerden yalnızca biri bulunabilir. Daha fazla öğe görüntülemek için birden fazla widget alanı kullanabilirsiniz. data aşağıdakilerden yalnızca biri olabilir:
textParagraph	object (TextParagraph) Bir metin paragrafını görüntüler. Basit HTML biçimlendirilmiş metni destekler. Metin biçimlendirme hakkında daha fazla bilgi için bkz. Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme. Örneğin, aşağıdaki JSON'de kalın bir metin oluşturulur: "textParagraph": { "text": " <b>bold text</b>" }
image	object (Image) Bir görsel gösterir. Ö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 öğesini 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. İlki mavi metin düğmesi, ikincisi ise bağlantıyı açan bir resim düğmesidir: "buttonList": { "buttons": [ { "text": "Edit", "color": { "red": 0, "green": 0, "blue": 1, "alpha": 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'de bir e-posta adresi için metin girişi oluşturulur: "textInput": { "name": "mailing_address", "label": "Mailing Address" } Başka bir örnek olarak aşağıdaki JSON, statik önerilerle 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 öğeleri seçebilmesini sağlayan bir seçim kontrolü görüntüler. 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 boyut seçmesini sağlayan 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 girmesine olanak tanıyan bir widget görüntüler. Ö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 ayırıcı oluşturur: "divider": { }
grid	object (Grid) Öğe koleksiyonu içeren bir tablo görüntüler. Izgara, istenilen sayıda sütun ve öğe 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 ızgarada 5 satır vardır. 11 öğe ve 2 sütun içeren bir ızgarada 6 satır vardır. 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ı tıklayın. Örneğin, aşağıdaki JSON'de her biri metin paragrafları içeren 2 sütun oluşturulur: "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) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Çip 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ında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

TextParagraph

Biçimlendirmeyi destekleyen bir metin paragrafı. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Biçimlendirilmiş metin paragrafı ekleyin. Metin biçimlendirme hakkında daha fazla bilgi için bkz. Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme.

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 Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Widget'ta görüntülenen maksimum metin satırı sayısı. Metin belirtilen maksimum satır sayısını aşarsa, fazla içerik bir daha fazla göster düğmesini tıklayın. Metin, belirtilen maksimum satır sayısına eşit veya bundan daha kısaysa daha fazla göster düğmesi görüntülenmiyor. 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 ve Google Workspace Eklentileriyle kullanılamaz.

Resim

URL ile belirtilen ve onClick eyleme dökülebilir. Örnek için bkz. Resim ekleyin.

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, tıklama bu işlemi tetikler.
altText	string Bu resmin erişilebilirlik için kullanılan alternatif metni.

OnClick

Kullanıcılar karttaki düğme gibi etkileşimli bir öğeyi 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 aşağıdakilerden yalnızca biri olabilir:
action	object (Action) Belirtilirse bu komut tarafından bir işlem tetiklenir onClick
openLink	object (OpenLink) Belirtilmişse onClick açık bağlantı işlemini tetikler.
openDynamicLinkAction	object (Action) İşlemin bir bağlantıyı açması gerektiğinde eklenti bu işlemi tetikler. Bu, openLink Bağlantıyı almak için sunucuyla iletişim kurması gerektiğini unutmayın. Bu nedenle, açık bağlantı işlemi yanıtı geri gelmeden önce web istemcisinin bazı hazırlık çalışmaları yapması gerekir. Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
card	object (Card) Belirtilmişse yeni bir kart tıklandıktan sonra kart grubuna aktarılır. Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
overflowMenu	object (OverflowMenu) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Belirtilmişse onClick bir taşma menüsü açar. Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

İşlem

Form gönderildiğinde gerçekleşen davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası'nı ç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 Kapsayıcı öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel bir işlev. Örneğin kullanım Form verilerini okuma.
parameters[]	object (ActionParameter) İşlem parametrelerinin listesi.
loadIndicator	enum (LoadIndicator) Eylem çağrısı yapılırken işlemin gösterildiğ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 Eğer true, 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 şunları ayarlayın: LoadIndicator - NONE. Örneğin, kart mesajları Chat uygulamalarında, eylemin ResponseType - UPDATE_MESSAGE ve aynı cardId işlemi içeren karttan alınır. Eğer false, işlem tetiklendiğinde form değerleri temizlenir. İşlem işlenirken kullanıcının değişiklik yapmasını önlemek için LoadIndicator - SPINNER.
interaction	enum (Interaction) İsteğe bağlı. Bir iletişim kutusunu kullanın. 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? Belirtilmezse uygulama, action (ör. bir bağlantıyı açma veya bir işlevi çalıştırma) normal şekilde çalışır. Bir interaction, uygulama özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction - OPEN_DIALOG, uygulama bir iletişim kutusunu kullanın. Belirtildiğinde bir 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ında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.
requiredWidgets[]	string Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. İsteğe bağlıdır. Bu listeyi, bu İşlemin geçerli bir gönderim için 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 Eklentilerinde kullanılabilir.
allWidgetsAreRequired	boolean Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. İsteğe bağlıdır. Bu durumda, bu işlemin tüm widget'ları gerektirdiği 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, şu üç erteleme düğmesini kullanabilirsiniz: şimdi ertele, bir gün ertele veya sonraki hafta ertele. Şunu kullanabilirsiniz: action method = snooze(), dize parametreleri listesinde erteleme türünü ve erteleme süresini geçirir.

Daha fazla bilgi edinmek için bkz. CommonEventObject.

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

Eylem çağrısı yapılırken işlemin gösterildiği yükleme göstergesini belirtir.

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

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

Etkileşim

İsteğe bağlı. Bir iletişim kutusunu kullanın.

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?

Belirtilmezse uygulama, action (ör. bir bağlantıyı açma veya bir işlevi çalıştırma) normal şekilde çalışır.

Bir interaction, uygulama özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction - OPEN_DIALOG, uygulama bir iletişim kutusunu kullanın.

Belirtildiğinde bir 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ında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

Sıralamalar
INTERACTION_UNSPECIFIED	Varsayılan değer. İlgili içeriği oluşturmak için kullanılan action normal şekilde yürütülür.
OPEN_DIALOG	Şunu açar: dialog, Chat uygulamalarının kullanıcılarla etkileşime geçmek için kullandığı pencereli, kart tabanlı bir arayüzdür. 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ında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

OpenLink

Bir temsil eder onClick bir köprü açan etkinliktir.

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ı nasıl açılır? Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
onClose	enum (OnClose) İstemcinin bir bağlantıyı açtıktan sonra unutup unutmadığı veya pencere kapanana kadar bağlantıyı gözlemleyip gözlemlemediğini belirtir. Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.

OpenAs

Bir OnClick işlemi bir bağlantı açar, ardından müşteri bunu tam boyutlu bir pencere (istemci tarafından kullanılan çerçeveyse) 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 müşteriler tarafından desteklenir.

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

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

OnClose

Bir bağlantı bir web sitesi tarafından OnClick işlem kapatıldı.

Uygulama, istemci platformu özelliklerine bağlıdır. Örneğin bir web tarayıcısı, OnClose gösterir.

Her ikisi de OnOpen ve OnClose işleyicilerin ayarlandığından ve istemci platformu her iki değeri de destekleyemez. OnClose öncelik sırasına koyduk.

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

Sıralamalar
NOTHING	Varsayılan değer. Kart yeniden yüklenmez; hiçbir şey olmaz.
RELOAD	Alt pencere kapandıktan sonra kartı yeniden yükler. Şununla birlikte kullanılırsa: OpenAs.OVERLAY için ayarlanırsa alt pencere, kalıcı iletişim kutusu görevi görür ve üst kart, alt pencere kapanana kadar engellenir.

OverflowMenu

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

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ığdığında bu widget'ı kullanabilirsiniz. Kullanmak için bu widget'ı OnClick widget'ların eylemleriyle ortaya çıkar. Örneğin, Button

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

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

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

OverflowMenuItem

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

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

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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 belirlendiğinde çağrılan işlem. Bu OnClick şunu içeremez: OverflowMenu, belirtilen herhangi biri 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

Bir karttaki widget'ta gösterilen simge. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Bir simge ekleyin.

Destekler yerleşik olarak ve özel simgelerine dokunun.

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 simgenin açıklaması. Belirtilmemişse varsayılan değer Button sağlanır. En iyi uygulama olarak, simgenin ne gösterdiği ve varsa ne yaptığı konusunda faydalı bir açıklama belirlemeniz gerekir. Örneğin, A user's account portrait veya Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat. Simge Button, altText kullanıcı düğmenin üzerine geldiğinde yardımcı metin olarak görünür. Ancak, düğme aynı zamanda text, simge altText yok sayılır.
imageType	enum (ImageType) Resme uygulanan kırpma stili. Bazı durumlarda, CIRCLE resmin yerleşik simgeden daha büyük çizilmesine neden olur.
Birlik alanı icons Karttaki widget'ta gösterilen simge. icons aşağıdakilerden yalnızca biri olabilir:
knownIcon	string Google Workspace tarafından sağlanan yerleşik simgelerden birini gösterir. Örneğin, bir uçak simgesi görüntülemek için AIRPLANE Otobüs için şunu belirtin: BUS Desteklenen simgelerin tam listesi için bkz. yerleşik simgeler.
iconUrl	string HTTPS URL'sinde barındırılan bir özel 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) Aşağıdakilerden birini görüntüleyin: Google Material Simgeleri. Örneğin, bir onay kutusu simgesi varsa "materialIcon": { "name": "check_box" } Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

MaterialIcon

CEVAP 2.500'den fazla seçenek içeren Google Material Simgesi.

Örneğin, bir onay kutusu simgesi özelleştirilmiş ağırlık ve dereceyle şunu yazın:

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

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

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

Alanlar
name	string Şurada tanımlanan simge adı: Google Material Simgesi, örneğin, check_box. Geçersiz adlar terk edilir ve boş dizeyle değiştirilir. Bu da, simgenin görüntülenememesine neden olur.
fill	boolean Simgenin doldurulmuş olarak oluşturulup oluşturulmayacağı. Varsayılan değer false'tur. Farklı simge ayarlarını önizlemek için şuraya gidin: Google Yazı Tipi Simgeleri ve şuradaki ayarları düzenleyin: Özelleştir.
weight	integer Simgenin fırça kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Yoksa varsayılan değer 400 olur. Başka herhangi bir değer belirtilirse varsayılan değer kullanılır. Farklı simge ayarlarını önizlemek için şuraya gidin: Google Yazı Tipi Simgeleri ve şuradaki ayarları düzenleyin: Özelleştir.
grade	integer Ağırlık ve eğim, bir simgenin 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 herhangi bir değer belirtilirse varsayılan değer kullanılır. Farklı simge ayarlarını önizlemek için şuraya gidin: Google Yazı Tipi Simgeleri ve şuradaki ayarları düzenleyin: Özelleştir.

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üslemelere sahip metin görüntüleyen bir widget. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Metni süsleme amaçlı metinle görüntüleyin.

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 öğe kullanımdan kaldırıldı. Kullanımdan kaldırıldı, startIcon
startIcon	object (Icon) Metnin önünde gösterilen simge.
topLabel	string Yukarıda görünen metin text 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 bkz. Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme.
wrapText	boolean Metni kaydırma ayarı. Eğer true, metin kaydırılır ve birden çok satırda görüntülenir. Aksi takdirde metin kısaltılır. Yalnızca şunlar için geçerlidir: text, şu değil: topLabel ve bottomLabel.
bottomLabel	string Aşağıda gösterilen metin text Her zaman sarmalar.
onClick	object (OnClick) Bu işlem, kullanıcılar topLabel veya bottomLabel.
Birlik alanı control decoratedText widget'ını tıklayın. control aşağıdakilerden yalnızca biri olabilir:
button	object (Button) Kullanıcının bir işlemi tetiklemek için tıklayabileceği düğme.
switchControl	object (SwitchControl) Kullanıcının durumunu değiştirmek ve bir işlemi tetiklemek için tıklayabileceği bir anahtar widget'ı.
endIcon	object (Icon) Metinden sonra gösterilen bir simge. Destekler yerleşik olarak ve özel simgelerine dokunun.

Düğme

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge düğmesi. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Düğme ekleyin.

Bir resmi tıklanabilir düğmeye dönüştürmek için Image ( ImageComponent) ve bir onClick eyleme dökülebilir.

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örüntülenen metin.
icon	object (Icon) Simge resmi. Her ikisi de icon ve text ayarlandıktan sonra metinden önce simge görünür.
color	object (Color) Ayarlandığında düğme düz bir arka plan rengiyle doldurulur ve arka plan rengiyle kontrastı korumak için yazı tipi rengi değişir. Örneğin, mavi bir arka plan ayarlamak muhtemelen beyaz metinle sonuçlanır. Ayarlanmadan bırakılırsa resmin arka planı beyaz, yazı tipi rengi ise mavi olur. Kırmızı, yeşil ve mavi için her alanın değeri bir float bir sayı olmak üzere iki şekilde ifade edebilirsiniz: 0 ile 255 arasında bir sayının 255'e bölünmesi (153/255) veya 0 ile 1 arasında bir değer (0,6). 0, renk olmadığını, 1 veya 255/255 değeri ise RGB ölçeğindeki rengin tamamını temsil eder. İsteğe bağlı olarak alpha, şu denklemi kullanarak bir şeffaflık düzeyi belirler: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Örneğin, alpha, değeri 1 düz bir renge ve 0 tamamen şeffaf bir renge karşılık gelir. Örneğin, aşağıdaki renk yarı şeffaf kırmızıyı temsil eder: "color": { "red": 1, "green": 0, "blue": 0, "alpha": 0.5 }
onClick	object (OnClick) Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel bir işlev çalıştırma).
disabled	boolean Eğer true ise, düğme etkin olmayan 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 yaptığını açıklayan 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 şu adresteki Google Chat geliştirici dokümanlarına gider: " https://developers.google.com/workspace/chat".
type	enum (Type) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Düğmenin türünü belirler. Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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 gösterimin alanları görevini oluşturan kişiye java.awt.Color Java'da; resmi olarak UIColor'ın +colorWithRed:green:blue:alpha yöntemidir; ve küçük bir çalışmayla kolayca CSS'ye dönüştürülebilir. rgba() dizesine benzer.

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ı kabul etmelidir.

Renk eşitliğinin belirlenmesi gerektiğinde, aksi belirtilmediği sürece uygulamalarda, kırmızı, yeşil, mavi ve alfa değerlerinin her biri en fazla farklılık gösterse de iki rengi eşit kabul eder 1e-5

Ö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şilin miktarı.
blue	number [0, 1] aralığındaki bir değer olarak renkteki mavi miktarı.
alpha	number Bu rengin piksele uygulanması gereken oranı. Yani son piksel rengi denklemle tanımlanır: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Bu, 1,0 değeri düz bir renge karşılık gelirken, 0.0 değeri tamamen şeffaf bir renge karşılık gelir. Bu yöntem, varsayılan değer ile ayarlanmayan değeri birbirinden ayırt edebilmek için basit bir kayan skaler yerine bir sarmalayıcı mesajı kullanır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açık bir şekilde 1, 0 değeri verilmiş gibi).

Tür

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

İlgili içeriği oluşturmak için kullanılan tür görebilirsiniz.

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

Sıralamalar
TYPE_UNSPECIFIED	Kullanmayın. Belirtilmedi.
OUTLINED	Dış çizgili düğmeler orta vurgulu düğmelerdir. Bunlar genellikle önemli olan ancak bir Chat uygulamasında veya eklentide birincil işlem olmayan işlemleri içerir.
FILLED	Doldurulmuş bir düğmenin düz renkli bir kapsayıcısı vardır. Görsel etki en yüksek olan bu işlem, Chat uygulamalarındaki veya eklentilerindeki önemli ve birincil işlem için önerilir.
FILLED_TONAL	Doldurulmuş ton düğmesi, doldurulmuş ve dış çizgili düğmeler arasında alternatif bir orta noktadır. Bu düğmeler, düşük öncelikli düğmenin anahat düğmesinden biraz daha fazla vurgu gerektirdiği durumlarda kullanışlıdır.
BORDERLESS	Bir düğmenin varsayılan durumunda görünmez bir kapsayıcısı yoktur. Genellikle en düşük önceliğe sahip işlemler için, özellikle de birden fazla seçenek sunulduğunda kullanılır.

Anahtar Kontrolü

Açma/kapatma biçiminde bir anahtar veya decoratedText widget'ını tıklayın.

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

Yalnızca şurada desteklenir: decoratedText widget'ını tıklayın.

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ş etkinliğinde tanımlandığı ad. Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma.
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ılar için bkz. Form verilerini alma.
selected	boolean Zaman true, anahtar seçilidir.
onChangeAction	object (Action) Anahtar durumu değiştirildiğ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 Eklentilerinde kullanılabilir.

ControlType

Anahtarın kullanıcı arayüzünde nasıl görüneceği.

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

Sıralamalar
SWITCH	Açma/kapatma düğmesi tarzında bir düğme.
CHECKBOX	Kullanımdan kaldırıldı, CHECK_BOX
CHECK_BOX	Onay kutusu.

ButtonList

Yatay olarak düzenlenmiş düğmelerin listesi. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Düğme ekleyin.

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şiklik yapıldığında yapılan işlemleri destekler. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Kullanıcıların metin girebileceği bir alan ekleyin.

Chat 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ılar için bkz. Form verilerini alma.

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ış verileri toplamak için SelectionInput widget'ını tıklayı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 Metin girişinin form giriş etkinliğinde tanımlanmasını sağlayan ad. Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma.
label	string Kullanıcı arayüzünde 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 metni belirtin. Örneğin, bir kişinin adını soruyorsanız ve özellikle soyadına ihtiyacınız varsa surname yerine name. Şu durumda gereklidir: hintText belirtilmemiş. Aksi takdirde isteğe bağlıdır.
hintText	string Metin giriş alanının altında görünen metin, kullanıcılardan belirli bir değer girmelerini isteyerek onlara yardımcı olmayı amaçlar. Bu metin her zaman görünür. Şu durumda gereklidir: label belirtilmemiş. 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ılar için bkz. Form verilerini alma.
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 ne yapmak gerekir? Örneğin, bir kullanıcının alana eklemesi veya metin silmesi. Yapılacak işlemlere örnek olarak özel bir işlev çalıştırmak veya iletişim kutusu Google Chat'te bulabilirsiniz.
initialSuggestions	object (Suggestions) Kullanıcıların girebileceği önerilen değerler. Bu değerler, kullanıcılar metin giriş alanının içini tıkladığında görünür. Önerilen değerler, kullanıcılar yazdıkça dinamik olarak kullanıcıların yazdıklarıyla eşleşecek şekilde filtrelenir. Örneğin, programlama dili için bir metin giriş alanı Java, JavaScript, Python ve C++ uygulamalarını önerebilir. Kullanıcılar yazmaya ne zaman başlar? Jav, yalnızca gösterilecek öneri filtrelerinin listesi Java ve JavaScript. Önerilen değerler, kullanıcıların, uygulamanızın anlamlandırabileceği değerleri girmelerine yardımcı olur. Bazı kullanıcılar JavaScript'ten bahsederken, javascript ve diğerleri java script. Önerme JavaScript kullanıcıların uygulamanızla etkileşimini standart hale getirebilir. Belirtildiğinde, TextInput.type her zaman SINGLE_LINE, MULTIPLE_LINE. 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 ve müşteri tarafından işlenir. Belirtilirse uygulama, burada belirtilen işlemi (ör. özel bir işlev çalıştırmak) gerçekleştirir. Google Workspace eklentileriyle kullanılabilir, Google Chat uygulamalarında kullanılamaz.
validation	object (Validation) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Bu metin giriş alanı için gerekli doğrulamayı belirtin. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
placeholderText	string Alan boş olduğunda 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 ve Google Workspace Eklentileriyle kullanılamaz.

Tür

Metin giriş alanının kullanıcı arayüzünde nasıl göründüğü. Örneğin, tek satırlı bir giriş alanı mı yoksa çok satırlı bir giriş mi olabilir. Eğer initialSuggestions belirtildiğinde type her zaman SINGLE_LINE, MULTIPLE_LINE.

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

Sıralamalar
SINGLE_LINE	Metin giriş alanının yüksekliği bir satır olmak üzere sabittir.
MULTIPLE_LINE	Metin giriş alanının yüksekliği birden fazla satır olacak şekilde sabit.

RenderActions

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

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

Alanlar
action	Action

İşlem

Alanlar
navigations[]	Navigation Görüntülenen kartları aktarın veya güncelleyin.

Gezinme

Gruba yeni bir kart ekleyin (ileri git). Chat uygulamalarında, yalnızca uygulama ana sayfasında kullanılabilir.

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

navigations: {
  pushCard: CARD
}

En üstteki kartı yeni bir kartla değiştirin. Chat uygulamalarında, yalnızca uygulama ana sayfasında kullanılabilir.

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

navigations: {
  updateCard: CARD
}

Alanlar
Birleştirme 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ın içini tıkladığında görünür. Önerilen değerler, kullanıcılar yazdıkça dinamik olarak kullanıcıların yazdıklarıyla eşleşecek şekilde filtrelenir.

Örneğin, programlama dili için bir metin giriş alanı Java, JavaScript, Python ve C++ uygulamalarını önerebilir. Kullanıcılar yazmaya ne zaman başlar? Jav, gösterilecek öneri filtreleri listesi Java ve JavaScript.

Önerilen değerler, kullanıcıların, uygulamanızın anlamlandırabileceği değerleri girmelerine yardımcı olur. Bazı kullanıcılar JavaScript'ten bahsederken, javascript ve diğerleri java script. Önerme JavaScript kullanıcıların uygulamanızla etkileşimini standart hale getirebilir.

Belirtildiğinde, TextInput.type her zaman SINGLE_LINE, MULTIPLE_LINE.

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

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

Alanlar
items[]	object (SuggestionItem) Metin giriş alanlarındaki otomatik tamamlama önerileri için kullanılan önerilerin listesi.

SuggestionItem

Kullanıcıların 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ş alanı için önerilen bir girişin değeri. Bu, kullanıcıların kendi girişleriyle eşdeğerdir.

Doğrulama

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

Bağlı olduğu widget'ı doğrulamak için gereken verileri gösterir.

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

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

Alanlar
characterLimit	integer Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Metin girişi widget'ları için karakter sınırlaması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: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. Giriş widget'larının türünü belirtin. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

InputType

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

Sıralamalar
INPUT_TYPE_UNSPECIFIED	Tür belirtilmedi. 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 bir widget. Örneğin, açılır menü veya onay kutuları. Tahmin edilebilecek veya numaralandırılabilen verileri toplamak için bu widget'ı kullanabilirsiniz. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Seçilebilir kullanıcı arayüzü öğeleri ekleyin.

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 bkz. Form verilerini alma.

Kullanıcılardan tanımlanmamış veya soyut veriler toplamak için TextInput widget'ını tıklayı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ş etkinliğinde seçim girişini tanımlayan ad. Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma.
label	string Kullanıcı arayüzünde 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 metni belirtin. Örneğin, kullanıcılar açılır menüden bir iş biletinin aciliyetini seçiyorsa etiket "Aciliyet" olabilir. veya "Aciliyeti seçin".
type	enum (SelectionType) Şurada kullanıcılara gösterilen öğelerin türü: SelectionInput widget'ını tıklayın. Seçim türleri, farklı etkileşim türlerini destekler. Örneğin, kullanıcılar bir veya daha fazla onay kutusunu işaretleyebilir, ancak açılır menüden yalnızca bir değer seçebilir.
items[]	object (SelectionItem) Seçilebilir öğelerden oluşan bir dizi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. 100 adede kadar öğeyi destekler.
onChangeAction	object (Action) Belirtilirse form seçim değiştiğinde 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 bkz. Form verilerini alma.
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ülerinde, kullanıcının uygulama sorguları otomatik olarak tamamlamadan önce girdiği metin karakteri sayısı ve menüde önerilen öğeleri gösterir. Belirtilmemişse varsayılan olarak statik veri kaynakları için 0 karakter, harici veri kaynakları için ise 3 karakter olur.
validation	object (Validation) Açılır menülerde, bu seçim giriş alanı için doğrulama. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
Birlik alanı multi_select_data_source Çoklu seçim menüsü için seçim öğelerini dolduran veri kaynağı. Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz. multi_select_data_source aşağıdakilerden yalnızca biri olabilir:
externalDataSource	object (Action) İlişkisel veri tabanı gibi harici bir veri kaynağı.
platformDataSource	object (PlatformDataSource) Google Workspace'ten 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. Onay kutuları ve anahtarların birlikte kullanılması desteklenmez.

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

Sıralamalar
CHECK_BOX	Onay kutuları. Kullanıcılar bir veya daha fazla onay kutusunu işaretleyebilir.
RADIO_BUTTON	Bir dizi 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	Statik veya dinamik veriler için çoklu seçim menüsü. Kullanıcılar, menü çubuğundan bir veya daha fazla öğe seçer. Kullanıcılar, dinamik verileri doldurmak için değerler de girebilir. Örneğin, kullanıcılar bir Google Chat alanının adını yazmaya başlayabilir. Bu durumda widget, alanı otomatik olarak önerir. Bir çoklu seçim menüsünün öğelerini doldurmak için aşağıdaki veri kaynağı türlerinden birini kullanabilirsiniz: Statik veri: Öğeler şu şekilde belirtilir: SelectionItem nesneleri ifade eder. En fazla 100 öğe. Google Workspace verileri: Öğeler, Google Workspace kullanıcıları veya Google Chat alanları gibi Google Workspace verileri kullanılarak doldurulur. Harici veriler: Öğeler Google Workspace dışındaki harici bir veri kaynağından doldurulur. Çoklu seçim menülerinin nasıl uygulanacağına ilişkin örnekler için Çoklu seçim menüsü ekleme. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

SelectionItem

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

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. İstemci bunu bir form giriş değeri olarak kullanmalıdır. Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma.
selected	boolean Öğenin varsayılan olarak seçili olup olmadığı. Seçim girişi yalnızca tek bir değer kabul ediyorsa (radyo düğmeleri veya açılır menü gibi) bu alanı yalnızca bir öğe için ayarlayın.
startIconUri	string Çoklu seçim menülerinde, öğenin yanındaki simgenin URL'si text girin. PNG ve JPEG dosyalarını destekler. Bir HTTPS URL'yi tıklayın. Örneğin, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
bottomText	string Çoklu seçim menüleri için öğenin altında görüntülenen bir metin açıklaması veya etiket text girin.

PlatformDataSource

Örneğin, SelectionInput widget'ını keşfedin. Çoklu seçim menüsündeki öğeleri doldurmak için kullanılır.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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 aşağıdakilerden yalnızca 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 Chat'teki alanlar gibi Google Workspace barındırma uygulamasına özel veri kaynağıdır.

CommonDataSource

Tüm kullanıcılar tarafından paylaşılan bir veri kaynağı Google Workspace uygulamaları.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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

Örneğin, SelectionInput widget'ını keşfedin. Veri kaynağı, çoklu seçim menüsü için seçim öğelerini doldurur.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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ü için öğeleri dolduran Google Workspace uygulaması. data_source aşağıdakilerden yalnızca biri olabilir:
chatDataSource	object (ChatClientDataSourceMarkup) Google Chat'ten bir veri kaynağı.

ChatClientDataSourceMarkup

Örneğin, SelectionInput widget'ını keşfedin. 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ında kullanılabilir ve Google Workspace Eklentileriyle 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
Birlik alanı source Google Chat veri kaynağı. source aşağıdakilerden yalnızca 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ünün seçim öğeleri olarak dolduran bir veri kaynağı. Yalnızca kullanıcının üyesi olduğu alanları doldurur.

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

JSON gösterimi
{ "defaultToCurrentSpace": boolean }

Alanlar
defaultToCurrentSpace	boolean Ayarlandığı takdirde true, ç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 girmesini sağlar. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Kullanıcıların tarih ve saat seçmesine izin verin.

Kullanıcılar metin girebilir veya tarih ve saati seçmek için seçiciyi kullanabilir. Kullanıcılar geçersiz bir tarih veya saat girerse seçici, kullanıcılardan 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 Verinin DateTimePicker bir form giriş etkinliğinde tanımlanır. Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma.
label	string Kullanıcılardan tarih, saat veya tarih ve saat girmelerini isteyen metin. Örneğin, kullanıcılar bir randevu planlıyorsa şunun gibi bir etiket kullanın: Appointment date veya Appointment date and time.
type	enum (DateTimePickerType) Widget'ın tarih, saat veya tarih ve saat girmeyi destekleyip desteklemediği.
valueMsEpoch	string (int64 format) Widget'ta görüntülenen varsayılan değer (milisaniye cinsinden) Unix epoch zamanı. Seçicinin türüne göre değeri belirtin ( DateTimePickerType): DATE_AND_TIME : UTC zaman diliminde takvim tarihi ve saati. Örneğin, 1 Ocak 2023 saat 12:00 (UTC) tarihini temsil etmek için 1672574400000 DATE_ONLY : 00:00:00 UTC'deki bir takvim tarihi. Örneğin, 1 Ocak 2023 tarihini temsil etmek için 1672531200000 TIME_ONLY : UTC saat diliminde. Örneğin, 12:00 değerini göstermek için 43200000 (veya 12 * 60 * 60 * 1000) tıklayın.
timezoneOffsetDate	integer Saat diliminin UTC ile farkını dakika cinsinden temsil eden sayı. Ayarlandığında valueMsEpoch belirtilen saat diliminde gösterilir. Ayarlanmadan bırakılırsa değer varsayılan olarak kullanıcının saat dilimi ayarına döner.
onChangeAction	object (Action) Kullanıcı tıkladığında tetiklenir Kaydet veya Temizle şuradan DateTimePicker kullanır.
validation	object (Validation) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. İsteğe bağlıdır. Bu tarih zamanlayıcı seçici için gerekli doğrulamayı belirtin. Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.

DateTimePickerType

Şuradaki tarih ve saatin biçimi: DateTimePicker widget'ını tıklayın. Kullanıcıların tarih, saat veya hem tarih ve saat girebileceğ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 saat 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ıyla ilgili bir örnek için şuraya bakın: Widget'lar arasına yatay ayırıcı ekleyin.

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

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

"divider": {}

Izgara

Öğe koleksiyonu içeren bir tablo görüntüler. Öğeler yalnızca metin veya resim içerebilir. Duyarlı sütunlar için veya metin ya da resimden daha fazlasını eklemek istiyorsanız Columns Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Öğe koleksiyonu içeren bir Izgara görüntüleyin.

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

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örüntülenen metin.
items[]	object (GridItem) Izgarada görüntülenecek öğeler.
borderStyle	object (BorderStyle) Her bir ızgara öğesine uygulanacak kenarlık stili.
columnCount	integer Izgarada görüntülenecek sütun sayısı. Bu alan belirtilmezse varsayılan değer kullanılır ve bu varsayılan değer, ızgaranın gösterildiği yere (iletişim kutusu veya tamamlayıcı) bağlı olarak farklılık gösterir.
onClick	object (OnClick) Bu geri çağırma, her bir ızgara öğesi tarafından yeniden kullanılır ancak geri çağırmanın parametrelerine eklenen öğe listesindeki öğenin tanımlayıcısı ve dizini 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 tablo öğesi için kullanıcı tarafından belirtilen tanımlayıcı. Bu tanımlayıcı üst ızgaranın onClick geri çağırma parametreleridir.
image	object (ImageComponent) Izgara öğesinde gösterilen 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

Resme uygulanan kırpma stilini gösterir.

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

Ö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
}

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

Alanlar
type	enum (ImageCropType) Kırpma türü.
aspectRatio	number Kırpma türü şu ise kullanılacak en boy oranı: RECTANGLE_CUSTOM Ö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

Resme uygulanan kırpma stilini gösterir.

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 kırpma uygular. Özel en boy oranını şununla ayarlayın: aspectRatio
RECTANGLE_4_3	4:3 en boy oranına sahip dikdörtgen kırpma uygular.

BorderStyle

Kenarlık türü ve rengi de dahil olmak üzere bir kartın veya widget'ın kenarlığına ilişkin 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 olduğunda kullanılacak renkler BORDER_TYPE_STROKE
cornerRadius	integer Kenarlığın köşe yarıçapı.

BorderType

Widget'lara uygulanan kenarlık türlerini gösterir.

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	Özet.

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 öğesi resminin üzerinde gösterilir.

Sütunlar

İlgili içeriği oluşturmak için kullanılan Columns widget, bir kartta veya iletişim kutusunda en fazla 2 sütun gösterir. Her bir sütuna widget ekleyebilirsiniz. widget'lar belirtildikleri sırada görünür. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Kartları ve iletişim kutularını sütunlarda görüntüleyin.

Her bir sütunun yüksekliği, uzun sütuna göre belirlenir. Örneğin, ilk sütun ikinci sütundan 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örüntülenir. Her sütunun genişliğini HorizontalSizeStyle girin. 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 bu değere eşitse ikinci sütun sarmalanı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.

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

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

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

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

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 soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir.
verticalAlignment	enum (VerticalAlignment) Widget'ların bir sütunun üstüne, altına veya ortasına hizalanıp hizalanmayacağını belirtir.
widgets[]	object (Widgets) Bir sütunda yer alan bir dizi widget. Widget'lar belirtildikleri sırayla görünür.

HorizontalSizeStyle

Bir sütunun, kartın genişliğini nasıl dolduracağını belirtir. Her bir sütunun genişliği hem HorizontalSizeStyle ve widget'ların sütundaki genişliği.

Google Workspace Eklentileri ve Chat uygulamaları

Sıralamalar
HORIZONTAL_SIZE_STYLE_UNSPECIFIED	Kullanmayın. Belirtilmedi.
FILL_AVAILABLE_SPACE	Varsayılan değer. Sütun, mevcut alanı (kart genişliğinin en fazla% 70'i kadar) doldurur. Her iki sütun da FILL_AVAILABLE_SPACE her sütun alanın% 50'sini kaplar.
FILL_MINIMUM_SPACE	Sütun, mümkün olan en az alanı ve kart genişliğinin% 30'unu aşmayacak şekilde dolduruyor.

HorizontalAlignment

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

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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üzenlerde sola hizalar. 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üzenlerde, widget'ları sağa hizalar. Sağdan sola düzenlerde, widget'ları sola hizalar.

VerticalAlignment

Widget'ların bir sütunun üstüne, altına 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ı bir sütunun üst kısmı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 aşağıdakilerden yalnızca biri olabilir:
textParagraph	object (TextParagraph) TextParagraph widget'ını tıklayın.
image	object (Image) Image widget'ını tıklayın.
decoratedText	object (DecoratedText) DecoratedText widget'ını tıklayın.
buttonList	object (ButtonList) ButtonList widget'ını tıklayın.
textInput	object (TextInput) TextInput widget'ını tıklayın.
selectionInput	object (SelectionInput) SelectionInput widget'ını tıklayın.
dateTimePicker	object (DateTimePicker) DateTimePicker widget'ını tıklayın.
chipList	object (ChipList) Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar. ChipList widget'ını tıklayın. Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

ChipList

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

Yatay olarak kaydırılabilen veya sonraki satıra kaydırılabilen çiplerin listesi.

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

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

Alanlar
layout	enum (Layout) Belirtilen çip listesi düzeni.
chips[]	object (Chip) Bir dizi çip.

Düzen

Çip listesi düzeni.

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

Çip

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

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

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle 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. Her ikisi de icon ve text ayarlandıktan sonra metinden önce simge görünür.
label	string Çipin içinde görüntülenen 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 öğe kullanımdan kaldırıldı. Çipin etkin durumda olup olmadığı ve kullanıcı işlemlerine yanıt verip vermediği. Varsayılan değer: true Kullanımdan kaldırıldı. Tekliflerinizi otomatikleştirmek ve optimize etmek için disabled .
disabled	boolean Çipin devre dışı durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp saymadığı. Varsayılan değer: false
altText	string Erişilebilirlik için kullanılan alternatif metin. Kullanıcılara çipin işlevini bildiren açıklayıcı bir metin belirleyin. Örneğin, bir çip bir köprü açarsa şunu yazın: "Yeni bir tarayıcı sekmesi açar ve şu adresteki Google Chat geliştirici dokümanlarına gider: https://developers.google.com/workspace/chat".

CollapseControl

Geliştirici Önizlemesi: Google Workspace Geliştirici Önizleme Programı, belirli özelliklere erken erişim sağlar.

Genişletme ve daraltma kontrolünü temsil eder. Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.

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

Alanlar
horizontalAlignment	enum (HorizontalAlignment) Genişlet ve daralt düğmesinin yatay hizalaması.
expandButton	object (Button) İsteğe bağlı. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. HemexpandButton hem expandButton 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. HemexpandButton hem expandButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmayacaktır. 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ında 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çenektir. Bölümler arasında sağlam bir ayırıcı oluşturun.
NO_DIVIDER	Ayarlanırsa bölümler arasında ayırıcı oluşturulmaz.

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şlemler içerebilir.

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

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

Alanlar
actionLabel	string İşlem menüsü öğesi olarak gösterilen etiket.
onClick	object (OnClick) İlgili içeriği oluşturmak için kullanılan onClick işlemi belirtin.

CardFixedFooter

Kartın en altında görünen kalıcı (yapışkan) alt bilgi.

Ayar fixedFooter bir primaryButton veya secondaryButton bir hataya neden olur.

Chat uygulamalarında, sabit altbilgileri iletişim kutuları gösterilir, ancak kart mesajları verebilirsiniz. Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın: Kalıcı bir altbilgi ekleyin.

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 renk ayarlanmış bir metin düğmesi olmalıdır.
secondaryButton	object (Button) Sabit altbilginin ikincil düğmesi. Düğme, metin ve renk ayarlanmış bir metin düğmesi olmalıdır. Eğer secondaryButton ayarlanıp ayarlanmadığını primaryButton.

DisplayStyle

Google Workspace Eklentileri'nde bir kartın nasıl gösterileceğini belirler.

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

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