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 rich media öğelerini (ör. resim) 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": "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 ( |
Alanlar | |
---|---|
header
|
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[]
|
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
|
Bölümler arasındaki ayırma stili. |
cardActions[]
|
Kartın işlemleri. İşlemler, kartın araç çubuğu menüsüne eklenir.
Örneğin, aşağıdaki JSON dosyasında
|
name
|
Kartın adı. Kart gezinmesinde kart tanımlayıcı olarak kullanılır.
|
fixedFooter
|
Bu kartın alt kısmında gösterilen sabit altbilgi.
Ayar
|
displayStyle
|
Google Workspace eklentilerinde,
|
peekCardHeader
|
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.
|
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 (
|
Alanlar | |
---|---|
title
|
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
|
Kart başlığının alt başlığı. Belirtilirse
|
imageType
|
Resmi kırpmak için kullanılan şekil.
|
imageUrl
|
Kart başlığındaki resmin HTTPS URL'si. |
imageAltText
|
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 ( |
Alanlar | |
---|---|
header
|
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[]
|
Bölümdeki tüm widget'lar. En az bir widget içermelidir. |
collapsible
|
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
|
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
|
collapseControl
|
İsteğe bağlı. Bölümün genişlet ve daralt düğmesini tanımlayın. Bu düğme yalnızca bölüm daraltılabilir durumdaysa gösterilir. Bu alan ayarlanmazsa varsayılan düğme kullanılır.
|
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 ( |
Alanlar | |
---|---|
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
|
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:
|
image
|
Bir görsel gösterir. Örneğin, aşağıdaki JSON, alternatif metin içeren bir resim oluşturur:
|
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:
|
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:
|
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:
Başka bir örnek olarak aşağıdaki JSON, statik önerilerle bir programlama dili için metin girişi oluşturur:
|
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:
|
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:
|
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:
|
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.
Örneğin, aşağıdaki JSON, tek bir öğe içeren 2 sütunlu bir ızgara oluşturur:
|
columns
|
En fazla 2 sütun gösterir.
2'den fazla sütun eklemek veya satır kullanmak için
Örneğin, aşağıdaki JSON'de her biri metin paragrafları içeren 2 sütun oluşturulur:
|
chipList
|
Ç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.
|
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
|
Widget'ta gösterilen metin. |
maxLines
|
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.
|
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 (
|
Alanlar | |
---|---|
imageUrl
|
Resmi barındıran HTTPS URL'si. Örneğin:
|
onClick
|
Kullanıcı resmi tıkladığında, tıklama bu işlemi tetikler. |
altText
|
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 |
Alanlar | |
---|---|
Birlik alanı
|
|
action
|
Belirtilirse bu komut tarafından bir işlem tetiklenir
|
openLink
|
Belirtilmişse
|
openDynamicLinkAction
|
İşlemin bir bağlantıyı açması gerektiğinde eklenti bu işlemi tetikler. Bu,
|
card
|
Belirtilmişse yeni bir kart tıklandıktan sonra kart grubuna aktarılır.
|
overflowMenu
|
Belirtilmişse
|
İş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 ( |
Alanlar | |
---|---|
function
|
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[]
|
İşlem parametrelerinin listesi. |
loadIndicator
|
Eylem çağrısı yapılırken işlemin gösterildiği yükleme göstergesini belirtir. |
persistValues
|
İşlemden sonra form değerlerinin kalıcı olup olmadığını gösterir. Varsayılan değer:
Eğer
Eğer
|
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,
Bir
|
requiredWidgets[]
|
ziyaret edin. İ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.
|
allWidgetsAreRequired
|
ziyaret edin. İsteğe bağlıdır. Bu durumda, bu işlemin tüm widget'ları gerektirdiği kabul edilir.
|
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
|
İşlem komut dosyası parametresinin adı. |
value
|
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.
|
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 ( |
Alanlar | |
---|---|
url
|
Açılacak URL. |
openAs
|
Bağlantı nasıl açılır?
|
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.
|
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:
|
OverflowMenu
Kullanıcıların çağırabileceği bir veya daha fazla işlem içeren bir pop-up menü sunan widget. Örneğin, bir kartta birincil olmayan işlemleri gösterme. İşlemler mevcut alana sığ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 (
|
Alanlar | |
---|---|
items[]
|
Zorunlu. Menü seçenekleri listesi. |
OverflowMenuItem
ziyaret edin. 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 ( |
Alanlar | |
---|---|
startIcon
|
Metnin önünde gösterilen simge. |
text
|
Zorunlu. Öğeyi kullanıcılara tanımlayan veya açıklayan metin. |
onClick
|
Zorunlu. Bir menü seçeneği belirlendiğinde çağrılan işlem. Bu
|
disabled
|
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 ( |
Alanlar | |
---|---|
altText
|
İsteğe bağlı. Erişilebilirlik için kullanılan simgenin açıklaması. Belirtilmemişse varsayılan değer
Simge
|
imageType
|
Resme uygulanan kırpma stili. Bazı durumlarda,
|
Birlik alanı
icons Karttaki widget'ta gösterilen simge.
icons .
aşağıdakilerden yalnızca biri olabilir:
|
|
knownIcon
|
Google Workspace tarafından sağlanan yerleşik simgelerden birini gösterir.
Örneğin, bir uçak simgesi görüntülemek için
Desteklenen simgelerin tam listesi için bkz. yerleşik simgeler. |
iconUrl
|
HTTPS URL'sinde barındırılan bir özel simge görüntüleyin. Örneğin:
Desteklenen dosya türleri şunları içerir:
|
materialIcon
|
Aşağıdakilerden birini görüntüleyin: Google Material Simgeleri. Örneğin, bir onay kutusu simgesi varsa
|
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
|
Şurada tanımlanan simge adı:
Google Material Simgesi, örneğin,
|
fill
|
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
|
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
|
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 ( |
Alanlar | |
---|---|
icon
|
Kullanımdan kaldırıldı,
|
startIcon
|
Metnin önünde gösterilen simge. |
topLabel
|
Yukarıda görünen metin
|
text
|
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
|
Metni kaydırma ayarı. Eğer
Yalnızca şunlar için geçerlidir:
|
bottomLabel
|
Aşağıda gösterilen metin
|
onClick
|
Bu işlem, kullanıcılar
|
Birlik alanı
control Metnin sağ tarafında görünen bir düğme, anahtar, onay kutusu veya resim
decoratedText .
widget'ını tıklayın.
control .
aşağıdakilerden yalnızca biri olabilir:
|
|
button
|
Kullanıcının bir işlemi tetiklemek için tıklayabileceği düğme. |
switchControl
|
Kullanıcının durumunu değiştirmek ve bir işlemi tetiklemek için tıklayabileceği bir anahtar widget'ı. |
endIcon
|
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
) ve bir
ImageComponent
onClick
eyleme dökülebilir.
.
Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
JSON gösterimi |
---|
{ "text": string, "icon": { object ( |
Alanlar | |
---|---|
text
|
Düğmenin içinde görüntülenen metin. |
icon
|
Simge resmi. Her ikisi de
|
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
İsteğe bağlı olarak
Örneğin,
Örneğin, aşağıdaki renk yarı şeffaf kırmızıyı temsil eder:
|
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
|
Eğer
|
altText
|
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
|
Düğmenin türünü belirler.
|
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
|
[0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı. |
green
|
[0, 1] aralığındaki bir değer olarak renkteki yeşilin miktarı. |
blue
|
[0, 1] aralığındaki bir değer olarak renkteki mavi miktarı. |
alpha
|
Bu rengin piksele uygulanması gereken oranı. Yani son piksel rengi denklemle tanımlanır:
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
İ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 ( |
Alanlar | |
---|---|
name
|
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
|
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
|
Zaman
|
onChangeAction
|
Anahtar durumu değiştirildiğinde yapılacak işlem (ör. hangi işlevin çalıştırılacağı). |
controlType
|
Anahtarın kullanıcı arayüzünde nasıl görüneceği.
|
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 (
|
Alanlar | |
---|---|
buttons[]
|
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 ( |
Alanlar | |
---|---|
name
|
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
|
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
Şu durumda gereklidir:
|
hintText
|
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:
|
value
|
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
|
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
|
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
|
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?
Ö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,
Belirtildiğinde,
|
autoCompleteAction
|
İ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
Belirtilirse uygulama, burada belirtilen işlemi (ör. özel bir işlev çalıştırmak) gerçekleştirir.
|
validation
|
ziyaret edin. Bu metin giriş alanı için gerekli doğrulamayı belirtin.
|
placeholderText
|
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,
|
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 |
İşlem
Alanlar | |
---|---|
navigations[] |
Görüntülenen kartları aktarın veya güncelleyin. |
Ö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 (
|
Alanlar | |
---|---|
items[]
|
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 |
Alanlar | |
---|---|
Birlik alanı
|
|
text
|
Metin giriş alanı için önerilen bir girişin değeri. Bu, kullanıcıların kendi girişleriyle eşdeğerdir. |
Doğrulama
ziyaret edin. 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 (
|
Alanlar | |
---|---|
characterLimit
|
ziyaret edin. 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.
|
inputType
|
ziyaret edin. Giriş widget'larının türünü belirtin.
|
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 ( |
Alanlar | |
---|---|
name
|
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
|
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
|
Şurada kullanıcılara gösterilen öğelerin türü:
|
items[]
|
Seçilebilir öğelerden oluşan bir dizi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. 100 adede kadar öğeyi destekler. |
onChangeAction
|
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
|
Ç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
|
Ç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
|
Açılır menülerde, bu seçim giriş alanı için doğrulama.
|
Birlik alanı
|
|
externalDataSource
|
İlişkisel veri tabanı gibi harici bir veri kaynağı. |
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:
Çoklu seçim menülerinin nasıl uygulanacağına ilişkin örnekler için Çoklu seçim menüsü ekleme.
|
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
|
Öğeyi kullanıcılara tanımlayan veya açıklayan metin. |
value
|
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
|
Öğ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
|
Çoklu seçim menülerinde, öğenin yanındaki simgenin URL'si
|
bottomText
|
Çoklu seçim menüleri için öğenin altında görüntülenen bir metin açıklaması veya etiket
|
PlatformDataSource
Örneğin,
.
widget'ını keşfedin. Çoklu seçim menüsündeki öğeleri doldurmak için kullanılır.
SelectionInput
.
Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
data_source Veri kaynağı.
data_source .
aşağıdakilerden yalnızca biri olabilir:
|
|
commonDataSource
|
Tüm Google Workspace uygulamaları tarafından paylaşılan veri kaynağı (ör. Google Workspace kuruluşlarındaki kullanıcılar). |
hostAppDataSource
|
Google Chat'teki alanlar gibi Google Workspace barındırma uygulamasına özgü bir 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,
.
widget'ını keşfedin. Veri kaynağı, çoklu seçim menüsü için seçim öğelerini doldurur.
SelectionInput
.
Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.
JSON gösterimi |
---|
{ // Union field |
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
|
Google Chat'ten bir veri kaynağı. |
ChatClientDataSourceMarkup
Örneğin,
.
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.
SelectionInput
.
Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileriyle kullanılamaz.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
source Google Chat veri kaynağı.
source .
aşağıdakilerden yalnızca biri olabilir:
|
|
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
|
Ayarlandığı takdirde
|
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 ( |
Alanlar | |
---|---|
name
|
Verinin
Form girişleriyle çalışma hakkında ayrıntılar için bkz. Form verilerini alma. |
label
|
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:
|
type
|
Widget'ın tarih, saat veya tarih ve saat girmeyi destekleyip desteklemediği. |
valueMsEpoch
|
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 (
|
timezoneOffsetDate
|
Saat diliminin UTC ile farkını dakika cinsinden temsil eden sayı. Ayarlandığında
|
onChangeAction
|
Kullanıcı tıkladığında tetiklenir
Kaydet
veya
Temizle
şuradan
|
validation
|
ziyaret edin. İsteğe bağlıdır. Bu tarih zamanlayıcı seçici için gerekli doğrulamayı belirtin.
|
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
Google Chat uygulamalarıyla ilgili bir örnek için şuraya bakın:
Öğe koleksiyonu içeren bir Izgara görüntüleyin.
Columns
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 ( |
Alanlar | |
---|---|
title
|
Izgara başlığında görüntülenen metin. |
items[]
|
Izgarada görüntülenecek öğeler. |
borderStyle
|
Her bir ızgara öğesine uygulanacak kenarlık stili. |
columnCount
|
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
|
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 ( |
Alanlar | |
---|---|
id
|
Bu tablo öğesi için kullanıcı tarafından belirtilen tanımlayıcı. Bu tanımlayıcı üst ızgaranın
|
image
|
Izgara öğesinde gösterilen resim. |
title
|
Izgara öğesinin başlığı. |
subtitle
|
Izgara öğesinin alt başlığı. |
layout
|
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 ( |
Alanlar | |
---|---|
imageUri
|
Resim URL'si. |
altText
|
Resmin erişilebilirlik etiketi. |
cropStyle
|
Resme uygulanacak kırpma stili. |
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 (
|
Alanlar | |
---|---|
type
|
Kırpma türü. |
aspectRatio
|
Kırpma türü şu ise kullanılacak en boy oranı:
Örneğin, 16:9 en boy oranının nasıl uygulanacağı aşağıda açıklanmıştır:
|
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 ( |
Alanlar | |
---|---|
type
|
Kenarlık türü. |
strokeColor
|
Tür olduğunda kullanılacak renkler
|
cornerRadius
|
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
.
widget'ını tıklayın.
Grid
.
Google Chat uygulamaları ve Google Workspace Eklentilerinde kullanılabilir.
JSON gösterimi |
---|
{
"columnItems": [
{
object (
|
Alanlar | |
---|---|
columnItems[]
|
Sütun dizisi. Bir karta veya iletişim kutusuna en fazla 2 sütun ekleyebilirsiniz. |
Sütun
Bir sütun.
JSON gösterimi |
---|
{ "horizontalSizeStyle": enum ( |
Alanlar | |
---|---|
horizontalSizeStyle
|
Bir sütunun, kartın genişliğini nasıl dolduracağını belirtir. |
horizontalAlignment
|
Widget'ların bir sütunun soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir. |
verticalAlignment
|
Widget'ların bir sütunun üstüne, altına veya ortasına hizalanıp hizalanmayacağını belirtir. |
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.
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.
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.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
|
|
textParagraph
|
|
image
|
|
decoratedText
|
|
buttonList
|
|
textInput
|
|
selectionInput
|
|
dateTimePicker
|
|
chipList
|
|
ChipList
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 ( |
Alanlar | |
---|---|
layout
|
Belirtilen çip listesi düzeni. |
chips[]
|
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
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 ( |
Alanlar | |
---|---|
icon
|
Simge resmi. Her ikisi de
|
label
|
Çipin içinde görüntülenen metin. |
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
|
Çipin etkin durumda olup olmadığı ve kullanıcı işlemlerine yanıt verip vermediği. Varsayılan değer:
|
disabled
|
Çipin devre dışı durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp saymadığı. Varsayılan değer:
|
altText
|
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
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 ( |
Alanlar | |
---|---|
horizontalAlignment
|
Genişlet ve daralt düğmesinin yatay hizalaması. |
expandButton
|
İ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
|
İ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 (
|
Alanlar | |
---|---|
actionLabel
|
İşlem menüsü öğesi olarak gösterilen etiket. |
onClick
|
İlgili içeriği oluşturmak için kullanılan
|
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 geçerli ü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. |