Card

Google Chat sohbet 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 resimler gibi rich media'yı destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma yönlendirmek için kartları kullanın.

Kart Oluşturucu ile kart tasarlama ve önizleme

Kart Oluşturucu'yu açma

Kart oluşturmayı öğrenmek için aşağıdaki belgelere bakın:

Not: Kart başına en fazla 100 widget ekleyebilirsiniz. Bir bölümün widget'ları toplam sayıyı 100'ün üzerine çıkarırsa ilgili bölümün tamamı ve sonraki tüm bölümler yok sayılır. Bu sınır, Google Chat uygulamalarındaki kart mesajları ve iletişim kutularının yanı sıra Google Workspace eklentilerindeki kartlar için de geçerlidir.

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

Örnek kişi kartı

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

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
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)
  },
  "expressionData": [
    {
      object (ExpressionData)
    }
  ]
}
Alanlar
header

object (CardHeader)

Kartın başlığı. Üstbilgide genellikle bir başlık resmi ve başlık bulunur. Başlıklar her zaman kartın en üstünde görünür.
sections[]

object (Section)

Widget koleksiyonu içerir. Her bölümün kendi isteğe bağlı başlığı vardır. Bölümler, görsel olarak bir çizgiyle ayrılır. Google Chat uygulamalarındaki bir örnek için Kartın bir bölümünü tanımlama başlıklı makaleyi inceleyin.
sectionDividerStyle

enum (DividerStyle)

Üstbilgi, bölümler ve altbilgi arasındaki ayırıcı stili.
cardActions[]

object (CardAction)

Kartın işlemleri. İşlemler, kartın araç çubuğu menüsüne eklenir. En fazla 10 CardAction öğe desteklenir.

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

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

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

string

Kartın adı. Kart gezinme bölümünde kart tanımlayıcısı olarak kullanılır.

Google Workspace eklentileri için kullanılabilir, Google Chat uygulamaları için kullanılamaz.
displayStyle

enum (DisplayStyle)

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

Google Workspace eklentileri için kullanılabilir, Google Chat uygulamaları için kullanılamaz.
peekCardHeader

object (CardHeader)

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

Google Workspace eklentileri için kullanılabilir, Google Chat uygulamaları için kullanılamaz.
expressionData[]

object (ExpressionData)

Kartın ifade verileri.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

CardHeader

Kart başlığını temsil eder. Google Chat uygulamalarındaki bir örnek için Başlık ekleme başlıklı makaleyi inceleyin.

Google Chat uygulamaları ve Google Workspace eklentileri için 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 kaplar.
subtitle

string

Kart başlığının alt başlığı. Belirtilirse title 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.

Bölüm

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

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

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

string

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

object (Widget)

Bölümdeki tüm widget'lar. En az bir widget içermelidir. Bir kart, tüm bölümlerde en fazla 100 widget'ı destekler.
collapsible

boolean

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

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

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

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 varsa ve uncollapsibleWidgetsCount, 2 olarak ayarlanmışsa ilk iki widget her zaman gösterilir ve son üç widget varsayılan olarak daraltılır. uncollapsibleWidgetsCount, yalnızca collapsible true olduğunda dikkate alınır.
id

string

Değiştirilecek bölümü tanımlamak için kullanılan, bölüme atanmış benzersiz bir kimlik. Kimlik, 64 karakter sınırlamasına sahiptir ve [a-zA-Z0-9-]+ biçiminde olmalıdır.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
collapseControl

object (CollapseControl)

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

Widget

Her kart widget'lardan oluşur.

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

JSON gösterimi 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "id": string,
  "visibility": enum (Visibility),
  "eventActions": [
    {
      object (EventAction)
    }
  ],

  "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)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
}
Alanlar
horizontalAlignment

enum (HorizontalAlignment)

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

string

Değiştirilecek widget'ı tanımlamak için kullanılan, widget'a atanmış benzersiz bir kimlik. Kimlik, 64 karakter sınırlamasına sahiptir ve [a-zA-Z0-9-]+ biçiminde olmalıdır.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
visibility

enum (Visibility)

Widget'ın görünür mü yoksa gizli mi olduğunu belirtir. Varsayılan değer: VISIBLE.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
eventActions[]

object (EventAction)

Widget'ta gerçekleştirilebilecek etkinlik işlemlerini belirtir.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
Bir widget'ta yalnızca aşağıdaki öğelerden biri bulunabilir. Daha fazla öğe göstermek için birden fazla widget alanı kullanabilirsiniz. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
textParagraph

object (TextParagraph)

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

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

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

object (Image)

Bir resim 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üslü bir metin öğesi gösterir.

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

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

object (ButtonList)

Düğme listesi.

Örneğin, aşağıdaki JSON iki düğme oluşturur. İlk düğme mavi renkli bir metin düğmesi, ikinci düğme ise bir bağlantıyı 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 girebileceği bir metin kutusu gösterir.

Örneğin, aşağıdaki JSON, e-posta adresi için bir 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 kontrolü 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 boyut 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 girmesine 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 çizgi şeklinde bir ayırıcı gösterir.

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

"divider": {
}
grid

object (Grid)

Öğe koleksiyonu içeren bir tablo gösterir.

Izgaralar, dilediğiniz sayıda sütun ve öğe içerebilir. Satır sayısı, öğe sayısının üst sınırının sütun sayısına bölünmesiyle belirlenir. 10 öğe ve 2 sütun içeren bir ızgarada 5 satır bulunur. 11 öğe ve 2 sütundan oluşan bir ızgarada 6 satır vardır.

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

Örneğin, aşağıdaki JSON tek bir öğe içeren 2 sütunlu bir tablo 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"
          }
        }
      ]
    }
  ]
}
carousel

object (Carousel)

Her biri iç içe yerleştirilmiş widget'lar içeren CarouselCard öğeden oluşan bir koleksiyon içerir. Örneğin, her birinde bir metin paragrafı bulunan iki bant kartı içeren bir bandın JSON gösterimi aşağıda verilmiştir:

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

object (ChipList)

Çip listesi.

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

"chipList": {
  "chips": [
    {
      "label": "Edit",
      "disabled": true
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
Birbirini hariç tutan alanların sonu.

TextParagraph

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

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

JSON gösterimi 
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
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ına gizlenir. Metin, belirtilen maksimum satır sayısına eşit veya daha kısaysa daha fazla göster düğmesi gösterilmez.

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

enum (TextSyntax)

Metnin söz dizimi. Ayarlanmazsa metin HTML olarak oluşturulur.

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

TextSyntax

Metni biçimlendirmek için kullanılacak söz dizimi.

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

Sıralamalar
TEXT_SYNTAX_UNSPECIFIED Belirtilmezse metin HTML olarak oluşturulur.
HTML Metin, HTML olarak oluşturulur. Bu, varsayılan değerdir.
MARKDOWN Metin, Markdown olarak oluşturulur.

Resim

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

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

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.

DecoratedText

Metnin üstünde veya altında etiket, metnin önünde simge, seçim widget'ı veya metinden sonra düğme gibi isteğe bağlı süslemelerle metin gösteren bir widget. Google Chat uygulamalarındaki bir örnek için Metni dekoratif metinle görüntüleme başlıklı makaleyi inceleyin.

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

JSON gösterimi 
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "onClick": {
    object (OnClick)
  },

  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
}
Alanlar
icon
(deprecated)

object (Icon)

startIcon lehine kullanımdan kaldırıldı.
startIcon

object (Icon)

Metnin önünde gösterilen simge.
startIconVerticalAlignment

enum (VerticalAlignment)

İsteğe bağlı. Başlangıç simgesinin dikey hizalaması. Ayarlanmazsa simge dikey olarak ortalanır.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
topLabel

string

text üzerinde görünen metin. Her zaman kısaltır.
topLabelText

object (TextParagraph)

topLabel için TextParagraph eşdeğeri. Her zaman kısaltır. topLabel biçiminden daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
text

string

Zorunlu. Birincil metin.

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

object (TextParagraph)

text için TextParagraph eşdeğeri. text biçiminden daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
wrapText

boolean

Metni kaydır ayarı. true ise metin kaydırılır ve birden fazla satırda gösterilir. Aksi takdirde metin kesilir.

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 kaydırılır.
bottomLabelText

object (TextParagraph)

bottomLabel için TextParagraph eşdeğeri. Her zaman kaydırılır. bottomLabel biçiminden daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
onClick

object (OnClick)

Bu işlem, kullanıcılar DecoratedText widget'ında herhangi bir yeri (text, topLabel, bottomLabel ve simgeler dahil) tıkladığında tetiklenir. Ancak ayrı bir etkileşimli kontrolün (button veya switchControl) tıklanması bu işlemi tetiklemez.
decoratedText widget'ında metnin sağ tarafında görünen bir düğme, anahtar, onay kutusu veya resim. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
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 simge.

Yerleşik ve özel simgeleri destekler.
Birbirini hariç tutan alanların sonu.

VerticalAlignment

Dikey hizalama özelliğini temsil eder.

Sıralamalar
VERTICAL_ALIGNMENT_UNSPECIFIED Belirtilmemiş tür. Kullanmayın.
TOP Üst konuma hizalama.
MIDDLE Orta konuma hizalama.
BOTTOM Alt konuma hizalama.

Anahtar Kontrolü

decoratedText widget'ı içindeki açma/kapatma anahtarı veya onay kutusu.

Google Chat uygulamaları ve Google Workspace eklentileri için 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 form girişi etkinliğinde tanımlandığı ad (CommonEventObject.form_inputs içindeki anahtar olarak).

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

string

Anahtar seçildiğinde (selected, true olduğunda) CommonEventObject.form_inputs[name].string_inputs içinde döndürülen değer. selected, true ise ve value ayarlanmamışsa stringInputs.value içinde boş bir dize ("") döndürülür. selected, false olduğunda bu değer stringInputs.value öğesinden çıkarılır.

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

boolean

true olduğunda anahtar seçilir ve value, CommonEventObject.form_inputs[name].string_inputs.value içine dahil edilir.
onChangeAction

object (Action)

Anahtar durumu değiştiğinde gerçekleştirilecek işlem (ör. çalıştırılacak işlev).
controlType

enum (ControlType)

Anahtarın kullanıcı arayüzündeki görünümü.

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

ControlType

Anahtarın kullanıcı arayüzündeki görünümü.

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

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

TextInput

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

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

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

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

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,

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Alanlar
name

string

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

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

string

Kullanıcı arayüzü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 bir metin belirtin. Örneğin, birinin adını soruyorsanız ancak özellikle soyadına ihtiyacınız varsa name yerine surname yazın.

hintText belirtilmediyse zorunludur. Diğer durumlarda isteğe bağlıdır.
hintText

string

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

label belirtilmediyse zorunludur. Diğer durumlarda isteğe bağlıdır.
value

string

Kullanıcı tarafından girilen ve form girişi etkinliğinin bir parçası olarak döndürülen değer.

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

enum (Type)

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

object (Action)

Metin giriş alanında değişiklik olduğunda ne yapılacağı. Örneğin, kullanıcının alana metin eklemesi veya alandaki metni silmesi.

Gerçekleştirilecek işlemlere örnek olarak özel bir işlev çalıştırma veya Google Chat'te iletişim kutusu 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 yazdıkça önerilen değerler, kullanıcıların yazdıklarıyla eşleşecek şekilde dinamik olarak filtrelenir.

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

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

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

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

object (Action)

İsteğe bağlı. Metin giriş alanı, etkileşimde bulunan kullanıcılara öneriler sunduğunda yapılacak işlemi belirtin.

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

Belirtilirse uygulama, burada belirtilen işlemi (ör. özel bir işlevi çalıştırma) gerçekleştirir.

Google Workspace eklentileri için kullanılabilir, Google Chat uygulamaları için kullanılamaz.
validation

object (Validation)

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

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

string

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

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.
Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
hostAppDataSource

object (HostAppDataSourceMarkup)

Gmail e-postaları, Google Takvim etkinlikleri veya Google Chat sohbet mesajları gibi Google Workspace barındırılan uygulamasına özgü bir veri kaynağı.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
Birbirini hariç tutan alanların sonu.

Tür

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

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

Sıralamalar
SINGLE_LINE Metin giriş alanının yüksekliği bir satırla sınırlıdır.
MULTIPLE_LINE Metin giriş alanı, birden fazla satırdan oluşan sabit bir yüksekliğe sahiptir.

RenderActions

Bir karta işlem yapmasını söyleyen veya eklenti ana 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

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

Google Chat'teki eklentiler.

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

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

navigations: {
  pushCard: CARD
}

En ü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
}

Ö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ıklarıyla eşleşecek şekilde dinamik olarak filtrelenir.

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

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

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

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

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

object (SuggestionItem)

Metin girişi alanlarında 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 eklentileri için kullanılabilir.

JSON gösterimi 
{

  "text": string
}
Alanlar
Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
text

string

Metin giriş alanına önerilen girişin değeri. Bu, kullanıcıların kendilerinin girdiği bilgilerle eşdeğerdir.
Birbirini hariç tutan alanların sonu.

Doğrulama

Ekli olduğu widget'ı doğrulamak için gereken verileri temsil eder.

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

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

integer

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

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

enum (InputType)

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

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

InputType

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

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

HostAppDataSourceMarkup

Google Workspace uygulamasından bir veri kaynağı. Veri kaynağı, widget'ta kullanılabilir öğeleri doldurur.

JSON gösterimi 
{

  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  },
  "workflowDataSource": {
    object (WorkflowDataSourceMarkup)
  }
}
Alanlar
Bir widget için kullanılabilir öğeleri dolduran Google Workspace uygulaması. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
chatDataSource

object (ChatClientDataSourceMarkup)

Google Chat'ten bir veri kaynağı.
workflowDataSource

object (WorkflowDataSourceMarkup)

Google Workflow'dan bir veri kaynağı.
Birbirini hariç tutan alanların sonu.

ChatClientDataSourceMarkup

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

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

JSON gösterimi 
{

  "spaceDataSource": {
    object (SpaceDataSource)
  }
}
Alanlar
Google Chat veri kaynağı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
spaceDataSource

object (SpaceDataSource)

Kullanıcının üyesi olduğu Google Chat alanları.
Birbirini hariç tutan alanların sonu.

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, Google Workspace eklentileri için kullanılamaz.

JSON gösterimi 
{
  "defaultToCurrentSpace": boolean
}
Alanlar
defaultToCurrentSpace

boolean

true olarak ayarlanırsa çoklu seçim menüsü, mevcut Google Chat alanını varsayılan olarak bir öğe şeklinde seçer.

WorkflowDataSourceMarkup

* Yalnızca Google Workspace iş akışı tarafından desteklenir. Google Chat uygulamaları veya Google Workspace eklentileri tarafından desteklenmez.

MULTI_SELECT türünde bir TextInput veya SelectionInput widget'ında ya da DateTimePicker widget'ında Google'dan veri kaynağı sağlayın.

JSON gösterimi 
{
  "includeVariables": boolean,
  "type": enum (Type)
}
Alanlar
includeVariables

boolean

Önceki adımdaki değişkenlerin veri kaynağına dahil edilip edilmeyeceği.
type

enum (Type)

Veri kaynağının türü.

Tür

İş akışı veri kaynağının türünü temsil eden bir enum.

Sıralamalar
UNKNOWN Varsayılan değer. Kullanmayın.
USER Google Workspace kullanıcıları. Kullanıcı yalnızca kendi Google Workspace kuruluşundaki kullanıcıları görüntüleyebilir ve seçebilir.
SPACE Kullanıcının üyesi olduğu Google Chat alanları.
USER_WITH_FREE_FORM Kullanıcılar, Google Workspace kuruluşlarındaki mevcut üyeleri görüntüleyip seçebilir veya manuel olarak bir e-posta adresi ya da geçerli bir alan adı girebilir.

SelectionInput

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

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

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

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

JSON gösterimi 
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMinQueryLength": integer,
  "dataSourceConfigs": [
    {
      object (DataSourceConfig)
    }
  ],
  "multiSelectMaxSelectedItems": integer,
  "hintText": string,

  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
}
Alanlar
name

string

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

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

string

Kullanıcı arayüzü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 bir metin belirtin. Örneğin, kullanıcılar bir iş biletinin aciliyetini açılır menüden seçiyorsa etiket "Aciliyet" veya "Aciliyet seçin" olabilir.
type

enum (SelectionType)

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

object (SelectionItem)

Seçilebilir öğeler dizisi. Örneğin, radyo düğmeleri veya onay kutuları dizisi. En fazla 100 öğe desteklenir.
onChangeAction

object (Action)

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

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

integer

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

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

  • Menüde SelectionInput öğeden oluşan statik bir dizi kullanılıyorsa varsayılan olarak 0 karakter kullanılır ve dizideki öğeler hemen doldurulur.
  • Menüde dinamik bir veri kaynağı (multi_select_data_source) kullanılıyorsa önerilen öğeleri döndürmek için veri kaynağı sorgulanmadan önce varsayılan olarak 3 karakter kullanılır.
dataSourceConfigs[]

object (DataSourceConfig)

İsteğe bağlı. Seçim kontrolü için veri kaynağı yapılandırmaları. Bu alan, veri kaynağı üzerinde daha ayrıntılı kontrol sağlar.

Belirtilirse multiSelectMaxSelectedItems alanı, multiSelectMinQueryLength alanı, externalDataSource alanı ve platformDataSource alanı yoksayılır.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir.

Google Chat uygulamalarında Dropdown widget için kullanılabilir. Google Chat uygulamalarındaki Dropdown widget'ı için yalnızca bir DataSourceConfig desteklenir. Birden fazla DataSourceConfig ayarlanırsa yalnızca ilki kullanılır.
multiSelectMaxSelectedItems

integer

Çoklu seçim menülerinde, kullanıcının seçebileceği maksimum öğe sayısı. Minimum değer 1 öğedir. Belirtilmezse varsayılan olarak 3 öğe gösterilir.
hintText

string

İsteğe bağlı. Seçim giriş alanının altında görünen ve kullanıcılardan belirli bir değer girmelerini isteyerek onlara yardımcı olmayı amaçlayan metin. Bu metin her zaman görünür.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

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

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
externalDataSource

object (Action)

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

object (PlatformDataSource)

Google Workspace'ten bir veri kaynağı.
Birbirini hariç tutan alanların sonu.

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 kutusu seçebilir ancak açılır menüden yalnızca bir öğe seçebilir.

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

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

Sıralamalar
CHECK_BOX Bir dizi onay kutusu. Kullanıcılar bir veya daha fazla onay kutusu seçebilir.
RADIO_BUTTON Radyo düğmeleri grubu. Kullanıcılar bir radyo düğmesi seçebilir.
SWITCH Bir dizi anahtar. Kullanıcılar bir veya daha fazla anahtarı etkinleştirebilir.
DROPDOWN

Açılır menü. Kullanıcılar menüden bir öğe seçebilir.

Google Chat uygulamalarında, 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şladığında widget, alanı otomatik olarak önerir. Açılır menüdeki öğeleri dinamik olarak doldurmak için aşağıdaki veri kaynağı türlerinden birini kullanın:

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

Chat uygulamaları için açılır menülerin nasıl uygulanacağına dair örnekleri Açılır menü ekleme ve Açılır menüleri dinamik olarak doldurma başlıklı makalelerde bulabilirsiniz.

Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
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ında, 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şladığında 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 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.

Chat uygulamaları için çoklu seçim menülerinin nasıl uygulanacağına dair örnekleri Çoklu seçim menüsü ekleme başlıklı makalede bulabilirsiniz.

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

PlatformDataSource

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

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

JSON gösterimi 
{

  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Alanlar
Veri kaynağı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
commonDataSource

enum (CommonDataSource)

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

object (HostAppDataSourceMarkup)

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

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.
Birbirini hariç tutan alanların sonu.

CommonDataSource

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

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

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

DataSourceConfig

Bir widget'ın veri kaynaklarını yapılandırmaya yardımcı olan bir yapılandırma nesnesi.

Google Workspace Studio'yu genişleten Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

JSON gösterimi 
{

  "remoteDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  "minCharactersTrigger": integer
}
Alanlar
Veri kaynağı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
remoteDataSource

object (Action)

Veriler, uzak bir veri sağlayıcıdan alınır.
platformDataSource

object (PlatformDataSource)

Veriler bir Google Workspace uygulamasından alınmıştır.
Birbirini hariç tutan alanların sonu.
minCharactersTrigger

integer

Bu veri sağlayıcı tetiklenmeden (yani sonuç döndürmeye başlamadan) önce kullanıcının girmesi gereken minimum karakter sayısı.

DateTimePicker

Kullanıcıların tarih, saat veya hem tarih hem de saat girmesine olanak tanır. Form gönderimi doğrulamasını destekler. Action.all_widgets_are_required, true olarak ayarlandığında veya bu widget Action.required_widgets içinde belirtildiğinde, bir değer seçilmediği sürece gönderme işlemi engellenir. Google Chat uygulamalarındaki bir örnek için Kullanıcıları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 girmesini isteyen bir hata gösterir.

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

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

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Alanlar
name

string

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

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

string

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

enum (DateTimePickerType)

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

string (int64 format)

Unix epoch zamanından bu yana milisaniye cinsinden widget'ta gösterilen varsayılan değer.

Seçici türüne (DateTimePickerType) göre değeri belirtin:

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

integer

UTC'den saat dilimi farkını temsil eden sayı (dakika cinsinden). Ayarlanırsa valueMsEpoch, belirtilen saat diliminde gösterilir. Ayarlanmazsa değer, varsayılan olarak kullanıcının saat dilimi ayarına göre belirlenir.

Not: Bu alan dakika cinsindendir ancak kullanıcı etkileşimi etkinlik yükleri genellikle milisaniye cinsinden saat dilimi farkları sağlar (dönüştürmek için 60000 değerine bölün).
onChangeAction

object (Action)

Kullanıcı, DateTimePicker arayüzünde Kaydet veya Temizle'yi tıkladığında tetiklenir.
Tarih ve saati temsil etmek için belirtilen veri kaynağı. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
hostAppDataSource

object (HostAppDataSourceMarkup)

Gmail e-postaları, Google Takvim etkinlikleri veya Google Chat sohbet mesajları gibi Google Workspace barındırılan uygulamasına özgü bir veri kaynağı.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.
Birbirini hariç tutan alanların sonu.

DateTimePickerType

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

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

Sıralamalar
DATE_AND_TIME Kullanıcılar 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 yatay çizgi şeklinde bir ayırıcı gösterir. Google Chat uygulamalarındaki bir örnek için Widget'lar arasına yatay ayırıcı ekleme başlıklı makaleyi inceleyin.

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

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

"divider": {}

Izgara

Öğe koleksiyonu içeren bir tablo gösterir. Öğeler yalnızca metin veya resim içerebilir. Duyarlı sütunlar için veya metin ya da resimden daha fazlasını eklemek için Columns kullanın. Google Chat uygulamalarındaki bir örnek için Öğe koleksiyonu içeren bir tablo görüntüleme başlıklı makaleyi inceleyin.

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 ızgarada 5 satır bulunur. 11 öğe ve 2 sütundan oluşan bir ızgarada 6 satır vardır.

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

Örneğin, aşağıdaki JSON tek bir öğe içeren 2 sütunlu bir tablo 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 bir ızgara öğesine uygulanacak kenarlık stili.
columnCount

integer

Izgarada gösterilecek sütun sayısı. Bu alan belirtilmezse varsayılan bir değer kullanılır ve bu varsayılan değer, ızgaranın nerede gösterildiğine (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 öğenin tanımlayıcısı, geri çağırmanın parametrelerine ("grid_item_identifier" anahtarının altına) eklenir.

GridItem

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

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

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 tanımlayıcı. Bu tanımlayıcı, üst kılavuzun onClick geri çağırma parametrelerinde döndürülür.
image

object (ImageComponent)

Izgara öğesinde gösterilen resim.
title

string

Tablo öğesinin başlığı.
subtitle

string

Tablo öğ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 eklentileri için 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 eklentileri için kullanılabilir.

Örneğin, 16:9 en boy oranını şu şekilde uygulayabilirsiniz:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
JSON gösterimi 
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
Alanlar
type

enum (ImageCropType)

Mahsul türü.
aspectRatio

number

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

Örneğin, 16:9 en boy oranını şu şekilde uygulayabilirsiniz:

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

ImageCropType

Bir resme uygulanan kırpma stilini temsil eder.

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

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

BorderStyle

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

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

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.

Kontur rengini ayarlamak için red, green ve blue alanlarına bir değer girin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan sayı olmalıdır. Burada 0 (0/255) rengin olmadığını, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

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

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

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

integer

Kenarlığın köşe yarıçapı.

BorderType

Widget'lara uygulanan kenarlık türlerini temsil eder.

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

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

GridItemLayout

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

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

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

Sütunlar

Columns widget'ı, bir kartta veya iletişim kutusunda en fazla 2 sütun gösterir. Her sütuna widget ekleyebilirsiniz. Widget'lar, belirtildikleri sırayla görünür. Google Chat uygulamalarındaki bir örnek için Kartları ve iletişim kutularını sütunlar halinde gösterme başlıklı makaleyi inceleyin.

Her sütunun yüksekliği, daha uzun olan 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ırları tanımlayamaz veya widget'ları sütunlar arasında 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, birincinin altına kaydırılır:

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

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

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

  • Kullanıcılar e-posta taslağından eklentiyi açtığında gösterilen iletişim kutusu.
  • Kullanıcılar eklentiyi bir Google Takvim etkinliğindeki Ek ekle menüsünden açtığında gösterilen iletişim kutusu.
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ütuna dahil edilen widget'lar dizisi. Widget'lar belirtildikleri sırayla görünür.

HorizontalSizeStyle

Bir sütunun kartın genişliğini nasıl dolduracağını belirtir. Her sütunun genişliği hem HorizontalSizeStyle 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 genişliğinin %70'ine kadar kullanılabilir alanı doldurur. Her iki sütun da FILL_AVAILABLE_SPACE olarak ayarlanırsa her sütun alanın %50'sini doldurur.
FILL_MINIMUM_SPACE Sütun, mümkün olan en az alanı doldurur ve kart genişliğinin %30'unu aşmaz.

HorizontalAlignment

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

Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için 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üzenlerde 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 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
}
Alanlar
Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
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'ı.
Birbirini hariç tutan alanların sonu.

ChipList

Yatay olarak yerleştirilmiş, yatay olarak kaydırılabilen veya bir sonraki satıra kaydırılabilen çiplerin listesi.

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

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

enum (Layout)

Belirtilen çip listesi düzeni.
chips[]

object (Chip)

Ç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 Çipler, mevcut alana sığmazsa 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ı ve Google Workspace eklentileri için kullanılabilir.

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 label ayarlanırsa simge, etiketten önce görünür.
label

string

Çipte 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 işlev çalıştırma).
enabled
(deprecated)

boolean

Desteği sonlandırıldı: Bunun yerine disabled kullanın.

Çipin etkin durumda olup olmadığı ve kullanıcı işlemlerine yanıt verip vermediği.
disabled

boolean

Çipin etkin olmayan bir durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp yoksaymadığı. Varsayılan değer false'dir.
altText

string

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

Kullanıcılara çipin ne işe yaradığını bildiren 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.

CarouselCard

Bant öğesi olarak gösterilebilen bir kart. Google Chat uygulamaları için kullanılabilir, Google Workspace eklentileri için kullanılamaz.

JSON gösterimi 
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
Alanlar
widgets[]

object (NestedWidget)

Bant kartında gösterilen widget'ların listesi. Widget'lar, belirtildikleri sırayla gösterilir.
footerWidgets[]

object (NestedWidget)

Rulo kartın alt kısmında gösterilen widget'ların listesi. Widget'lar, belirtildikleri sırayla gösterilir.

NestedWidget

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

JSON gösterimi 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
}
Alanlar
Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
textParagraph

object (TextParagraph)

Metin paragrafı widget'ı.
buttonList

object (ButtonList)

Düğme listesi widget'ı.
image

object (Image)

Resim widget'ı.
Birbirini hariç tutan alanların sonu.

Görünürlük

Bir kullanıcı arayüzü öğesinin görünür mü yoksa gizli mi olduğunu belirtir.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

Sıralamalar
VISIBILITY_UNSPECIFIED Belirtilmemiş görünürlük. Kullanmayın.
VISIBLE Kullanıcı arayüzü öğesi görünür.
HIDDEN Kullanıcı arayüzü öğesi gizlenir.

EventAction

Bir kullanıcı arayüzü öğesinde gerçekleştirilebilecek bir işlemi temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "actionRuleId": string,
  "postEventTriggers": [
    {
      object (Trigger)
    }
  ],

  "commonWidgetAction": {
    object (CommonWidgetAction)
  }
}
Alanlar
actionRuleId

string

ActionRule'un benzersiz tanımlayıcısı.
postEventTriggers[]

object (Trigger)

EventAction yürütüldükten sonra tetiklenecek tetikleyicilerin listesi.
Gerçekleştirilecek işlem. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
commonWidgetAction

object (CommonWidgetAction)

Sık kullanılan widget işlemi.
Birbirini hariç tutan alanların sonu.

Tetikleyici

Tetikleyiciyi temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "actionRuleId": string
}
Alanlar
actionRuleId

string

ActionRule'un benzersiz tanımlayıcısı.

CommonWidgetAction

Bir widget'a özgü olmayan bir işlemi temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{

  "updateVisibilityAction": {
    object (UpdateVisibilityAction)
  }
}
Alanlar
Gerçekleştirilecek işlem. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
updateVisibilityAction

object (UpdateVisibilityAction)

Widget'ın görünürlüğünü güncelleme işlemi.
Birbirini hariç tutan alanların sonu.

UpdateVisibilityAction

Bir widget'ın görünürlüğünü güncelleyen bir işlemi temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "visibility": enum (Visibility)
}
Alanlar
visibility

enum (Visibility)

Yeni görünürlük.

CollapseControl

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

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

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

enum (HorizontalAlignment)

Genişletme ve daraltma 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. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.
collapseButton

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 eklentileri için kullanılabilir.

Sıralamalar
DIVIDER_STYLE_UNSPECIFIED Kullanmayın. Belirtilmedi.
SOLID_DIVIDER Varsayılan seçenektir. Düz bir ayırıcı oluşturun.
NO_DIVIDER Ayarlanırsa ayırıcı oluşturulmaz. Bu stil, ayırıcıyı düzenden tamamen kaldırır. Sonuç, hiç ayırıcı eklememekle aynıdır.

CardAction

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

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

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

string

İşlem menüsü öğesi olarak gösterilen 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ı (sabit) bir altbilgi.

primaryButton veya secondaryButton belirtmeden fixedFooter ayarlanması hataya neden olur.

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

Google Chat uygulamaları ve Google Workspace eklentileri için 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 ayarı olan 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. secondaryButton ayarlanırsa primaryButton özelliğini de ayarlamanız gerekir.

DisplayStyle

Google Workspace eklentilerinde, bir kartın nasıl gösterileceğini belirler.

Google Workspace eklentileri için kullanılabilir, Google Chat uygulamaları için 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 yığının mevcut üst kartını kısmen kaplar. Başlığı tıkladığınızda kart, kart yığınına eklenir. Kartın başlığı yoksa bunun yerine oluşturulan bir başlık kullanılır.
REPLACE Varsayılan değer. Kart, kart yığınındaki en üstteki kartın görünümü değiştirilerek gösterilir.

ExpressionData

Bir ifadeyi değerlendirmek için kullanılan verileri temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "id": string,
  "expression": string,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "eventActions": [
    {
      object (EventAction)
    }
  ]
}
Alanlar
id

string

ExpressionData'nın benzersiz tanımlayıcısı.
expression

string

Derlenmemiş ifade.
conditions[]

object (Condition)

İfade değerlendirme sonucuyla belirlenen koşulların listesi.
eventActions[]

object (EventAction)

ExpressionData'nın kullanılabileceği işlemlerin listesi.

Koşul

Bir işlemi tetiklemek için kullanılabilecek bir koşulu temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "actionRuleId": string,

  "expressionDataCondition": {
    object (ExpressionDataCondition)
  }
}
Alanlar
actionRuleId

string

ActionRule'un benzersiz tanımlayıcısı.
Koşul. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
expressionDataCondition

object (ExpressionDataCondition)

İfade verileri tarafından belirlenen koşul.
Birbirini hariç tutan alanların sonu.

ExpressionDataCondition

CEL kullanılarak değerlendirilen bir koşulu temsil eder.

Google Workspace Studio'yu genişleten Google Workspace eklentileri için kullanılabilir. Google Chat uygulamalarında kullanılamaz.

JSON gösterimi 
{
  "conditionType": enum (ConditionType)
}
Alanlar
conditionType

enum (ConditionType)

Koşulun türü.

ConditionType

Koşulun türü.

Sıralamalar
CONDITION_TYPE_UNSPECIFIED Belirtilmemiş koşul türü.
EXPRESSION_EVALUATION_SUCCESS İfade değerlendirmesi başarılı oldu.
EXPRESSION_EVALUATION_FAILURE İfade değerlendirmesi başarısız oldu.