Kart
Kartlar, metin ve resim gibi kullanıcı arayüzü widget'ları içerebilen bir kullanıcı arayüzü öğesidir.
JSON gösterimi |
---|
{ "header": { object ( |
Alanlar | |
---|---|
header
|
Kartın başlığı. Üstbilgi genellikle bir başlık ve bir resim içerir. |
sections[]
|
Bölümler, çizgi ayırıcıyla ayrılır. |
cardActions[]
|
Bu karttaki işlemler. |
name
|
Kartın adı. |
CardHeader
JSON gösterimi |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Alanlar | |
---|---|
title
|
Başlık belirtilmelidir. Başlığın yüksekliği sabittir: Hem başlık hem de alt başlık belirtilirse her biri bir satır yer alır. Yalnızca başlık belirtilirse başlık her iki satırı da kullanır. |
subtitle
|
Kart başlığının alt başlığı. |
imageStyle
|
Resmin türü (örneğin, kare kenarlık veya dairesel kenarlık). |
imageUrl
|
Kart başlığındaki resmin URL'si. |
ImageStyle
Sıralamalar | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Kare kenarlık. |
AVATAR
|
Dairesel kenarlık. |
Bölüm
Bölüm, belirtildikleri sırada (dikey olarak) oluşturulan bir widget koleksiyonunu içerir. Tüm platformlarda, kartların sabit genişliği dar olduğu için düzen özelliklerine (ör. kayan) gerek yoktur.
JSON gösterimi |
---|
{
"header": string,
"widgets": [
{
object (
|
Alanlar | |
---|---|
header
|
Bölümün başlığı. Biçimlendirilmiş metin desteklenir. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin. |
widgets[]
|
Bir bölümde en az bir widget bulunmalıdır. |
WidgetMarkup
Widget, metin ve resimler sunan bir kullanıcı arayüzü öğesidir.
JSON gösterimi |
---|
{ "buttons": [ { object ( |
Alanlar | |
---|---|
buttons[]
|
Düğme listesi. Düğmeler de |
Birleşim alanı data . Bir
WidgetMarkup
aşağıdaki öğelerden yalnızca birine sahip olabilir. Daha fazla öğe görüntülemek için birden fazla WidgetMarkup alanı kullanabilirsiniz.
data aşağıdakilerden yalnızca biri olabilir:
|
|
textParagraph
|
Bu widget'ta bir metin paragrafı görüntüleyin. |
image
|
Bu widget'ta bir resim görüntüle. |
keyValue
|
Bu widget'ta bir anahtar/değer öğesi görüntüleyin. |
TextParagraph
Bir paragraf metin. Biçimlendirilmiş metin destekleniyor. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin.
JSON gösterimi |
---|
{ "text": string } |
Alanlar | |
---|---|
text
|
|
Resim
URL ile belirtilen ve
onclick
işlemi olabilen bir resim.
JSON gösterimi |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Alanlar | |
---|---|
imageUrl
|
Resmin URL'si. |
onClick
|
|
aspectRatio
|
Bu resmin en boy oranı (genişlik ve yükseklik). Bu alan, yüklenmesini beklerken resim için doğru yüksekliği ayırmanıza olanak tanır. Bu özelliğin, resmin yerleşik en boy oranını geçersiz kılması amaçlanmamıştır. Ayarlanmadan bırakılırsa sunucu resmi önceden alarak resmi doldurur. |
OnClick
onclick
işlemi (örneğin, bir bağlantıyı açma).
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleşim alanı
|
|
action
|
Belirtilirse bu |
openLink
|
Bu |
FormAction
Form işlemi, form gönderildiğinde ortaya çıkacak davranışı tanımlar. Örneğin, formu işlemek için Apps Komut Dosyası'nı çağırabilirsiniz.
JSON gösterimi |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Alanlar | |
---|---|
actionMethodName
|
Yöntem adı, formun hangi bölümünün form gönderilmesini tetiklediğini tanımlamak için kullanılır. Bu bilgi, kart tıklama etkinliği kapsamında Chat uygulamasına geri gönderilir. Ortak bir davranışı tetikleyen birkaç öğe için aynı yöntem adını kullanabilirsiniz. |
parameters[]
|
İşlem parametrelerinin listesi. |
ActionParameter
İşlem yöntemi çağrıldığında sağlanacak dize parametrelerinin listesi. Örneğin, üç ertele düğmesini ele alalım: şimdi ertele, bir gün ertele, sonraki hafta ertele. Dize parametreleri listesinde erteleme türünü ve erteleme süresini ileten action method = snooze()
parametresini kullanabilirsiniz.
JSON gösterimi |
---|
{ "key": string, "value": string } |
Alanlar | |
---|---|
key
|
İşlem komut dosyasına ait parametrenin adı. |
value
|
Parametrenin değeri. |
OpenLink
Yeni pencerede açılan bir bağlantı.
JSON gösterimi |
---|
{ "url": string } |
Alanlar | |
---|---|
url
|
Açılacak URL. |
KeyValue
Kullanıcı arayüzü öğesi, bir anahtar (etiket) ve bir değer (içerik) içerir. Bu öğe, onclick
düğmesi gibi bazı işlemler de içerebilir.
JSON gösterimi |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Alanlar | |
---|---|
topLabel
|
Üst etiketin metni. Biçimlendirilmiş metin destekleniyor. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin. |
content
|
İçeriğin metni. Biçimlendirilmiş metin desteklenir ve her zaman gereklidir. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin. |
contentMultiline
|
İçeriğin çok satırlı olup olmadığı |
bottomLabel
|
Alt etiketin metni. Biçimlendirilmiş metin destekleniyor. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin. |
onClick
|
|
Birleşim alanı icons . Simgelerden en az biri,
top_label
ve
bottom_label
tanımlanmalıdır.
icons aşağıdakilerden yalnızca biri olabilir:
|
|
icon
|
Chat API tarafından karşılık gelen simge resmiyle değiştirilen bir enum değeri. |
iconUrl
|
Bir URL tarafından belirtilen simge. |
Birleşim alanı control . Kontrol widget'ı. button veya switch_widget seçeneklerinden birini belirleyebilirsiniz, ancak ikisini birden ayarlayamazsınız.
control aşağıdakilerden yalnızca biri olabilir:
|
|
button
|
Bir işlemi tetiklemek için tıklanabilen bir düğmedir. |
Simge
Desteklenen simgeler grubu.
Sıralamalar | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
Düğme
Bir düğme. Metin düğmesi veya resim düğmesi olabilir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleşim alanı
|
|
textButton
|
Metin ve
|
imageButton
|
Resim ve
|
TextButton
Metin ve
onclick
işlemi içeren bir düğme.
JSON gösterimi |
---|
{
"text": string,
"onClick": {
object (
|
Alanlar | |
---|---|
text
|
Düğmenin metni. |
onClick
|
Düğmenin |
ImageButton
onclick
işlemi olan bir resim düğmesi.
JSON gösterimi |
---|
{ "onClick": { object ( |
Alanlar | |
---|---|
onClick
|
|
name
|
Erişilebilirlik için kullanılan bu |
Birleşim alanı icons . Simge,
Icon
enum
veya bir URL ile belirtilebilir.
icons aşağıdakilerden yalnızca biri olabilir:
|
|
icon
|
Chat API tarafından sağlanan bir simgeye işaret eden |
iconUrl
|
Bir URL tarafından belirtilen simge. |
CardAction
Kart işlemi, kartla ilişkilendirilmiş işlemdir. Fatura kartları için tipik işlemler şu şekildedir: faturayı silme, faturayı e-postayla gönderme veya faturayı tarayıcıda açma.
Google Chat uygulamaları tarafından desteklenmez.
JSON gösterimi |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Alanlar | |
---|---|
actionLabel
|
Etiket eskiden işlem menüsü öğesinde gösteriliyordu. |
onClick
|
Bu işlem öğesi için tıklama işlemi. |