Cards v1

Kart

Kart, metin ve resim gibi kullanıcı arayüzü widget'ları içerebilen bir kullanıcı arayüzü öğesidir.

JSON gösterimi 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Alanlar
header

object (CardHeader)

Kartın başlığı. Üstbilgiler genellikle bir başlık ve bir resim içerir.

sections[]

object (Section)

Bölümler çizgi ayırıcıyla ayrılır.

cardActions[]

object (CardAction)

Bu kartla ilgili işlemler.

name

string

Kartın adı.

CardHeader

JSON gösterimi 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
Alanlar
title

string

Başlık belirtilmelidir. Üstbilginin sabit yüksekliği vardır: Hem başlık hem de alt başlık belirtilmişse her biri bir satır kaplar. Yalnızca başlık belirtilirse her iki satırı da kaplar.

subtitle

string

Kart başlığının alt başlığı.

imageStyle

enum (ImageStyle)

Resmin türü (örneğin, kare kenarlık veya yuvarlak kenarlık).

imageUrl

string

Kart başlığındaki resmin URL'si.

ImageStyle

Sıralamalar
IMAGE_STYLE_UNSPECIFIED
IMAGE Kare kenarlık.
AVATAR Dairesel kenarlık.

Bölüm

Bir bölüm, belirtildikleri sıraya göre oluşturulan (dikey olarak) widget koleksiyonunu içerir. Tüm platformlarda, kartlar dar bir sabit genişliğe sahiptir. Bu nedenle, şu anda düzen özelliklerine (ör. kayan) ihtiyaç duyulmaz.

JSON gösterimi 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
Alanlar
header

string

Bölümün başlığı. Biçimlendirilmiş metin destekleniyor. Metin biçimlendirme hakkında daha fazla bilgi için bkz. Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme.

widgets[]

object (WidgetMarkup)

Bir bölümde en az bir widget bulunmalıdır.

WidgetMarkup

Widget, metin ve resimleri sunan bir kullanıcı arayüzü öğesidir.

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

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
Alanlar
buttons[]

object (Button)

Düğme listesi. Düğmeler ayrıca oneof data. ve bu alanlardan yalnızca biri ayarlanmalıdır.

Birlik alanı data CEVAP WidgetMarkup. aşağıdaki öğelerden yalnızca birine sahip olabilir. Birden çok WidgetMarkup. alanları kullanabilirsiniz. data. aşağıdakilerden yalnızca biri olabilir:
textParagraph

object (TextParagraph)

Bu widget'ta bir metin paragrafı gösterir.

image

object (Image)

Bu widget'ta bir resim gösterin.

keyValue

object (KeyValue)

Bu widget'ta bir anahtar/değer öğesi görüntüleyin.

TextParagraph

Bir paragraflık metin. Biçimlendirilmiş metin destekleniyor. 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.

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

string

Resim

URL ile belirtilen ve onclick. eyleme dökülebilir.

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

string

Resmin URL'si.

onClick

object (OnClick)

İlgili içeriği oluşturmak için kullanılan onclick. eyleme dökülebilir.

aspectRatio

number

Bu resmin en boy oranı (genişlik ve yükseklik). Bu alan, resmin yüklenmesini beklerken doğru yüksekliği ayırmanıza olanak tanır. Resmin yerleşik en boy oranını geçersiz kılmak amaçlanmamıştır. Politika ayarlanmazsa sunucu, resmi önceden getirerek resmi doldurur.

OnClick

onclick. işlemine (örneğin, bir bağlantıyı açma) olanak tanır.

JSON gösterimi 
{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
Alanlar

Birlik alanı data

data. aşağıdakilerden yalnızca biri olabilir:

action

object (FormAction)

Bu, bir form işlemini tetikler. onclick. eyleme geçmeniz gerekir.

FormAction

Form işlemi, form gönderilirken gerçekleştirilen davranışı tanımlar. Örneğin, formu işlemek için Apps Komut Dosyası'nı çağırabilirsiniz.

JSON gösterimi 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
Alanlar
actionMethodName

string

Yöntem adı, formun hangi bölümünün form gönderimini tetiklediğini tanımlamak için kullanılır. Bu bilgiler, kart tıklama etkinliğinin bir parçası olarak Chat uygulamasına yansıtılır. Yaygın bir davranışı tetikleyen çeşitli öğeler için aynı yöntem adını kullanabilirsiniz.

parameters[]

object (ActionParameter)

İşlem parametrelerinin listesi.

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, sonraki hafta ertele. Şunu kullanabilirsiniz: action method = snooze(), dize parametreleri listesinde erteleme türünü ve erteleme süresini geçirir.

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

string

İşlem komut dosyası parametresinin adı.

value

string

Parametrenin değeri.

KeyValue

Bir kullanıcı arayüzü öğesi, bir anahtar (etiket) ve değer (içerik) içerir. Bu öğe ayrıca, onclick. düğmesini tıklayın.

JSON gösterimi 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
Alanlar
topLabel

string

Üst etiketin metni. Biçimlendirilmiş metin destekleniyor. 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.

content

string

İçeriğin metni. Biçimlendirilmiş metin desteklenir ve her zaman zorunludur. 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.

contentMultiline

boolean

İçeriğin çok satırlı olup olmaması gerektiği.

bottomLabel

string

Alt etiketin metni. Biçimlendirilmiş metin destekleniyor. 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.

onClick

object (OnClick)

İlgili içeriği oluşturmak için kullanılan onclick. eyleme dökülebilir. Yalnızca üst etiket, alt etiket ve içerik bölgesi tıklanabilir.

Birlik alanı icons Simgelerden en az biri top_label. ve bottom_label tanımlanmalıdır. icons. aşağıdakilerden yalnızca biri olabilir:
icon

enum (Icon)

Chat API tarafından, karşılık gelen simge resmiyle değiştirilen bir sıralama değeri.

iconUrl

string

URL ile belirtilen simge.

Birlik alanı control Bir kontrol widget'ı. İki seçenekten birini button. veya switch_widget ancak her ikisi değil. control. aşağıdakilerden yalnızca biri olabilir:
button

object (Button)

İşlemi tetiklemek için tıklanabilen bir düğme.

Simge

Desteklenen simge 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. Bir metin düğmesi veya resim düğmesi olabilir.

JSON gösterimi 
{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
Alanlar

Birlik alanı type

type. aşağıdakilerden yalnızca biri olabilir:

textButton

object (TextButton)

Metin içeren ve onclick. eyleme dökülebilir.

imageButton

object (ImageButton)

İçinde resim ve onclick. eyleme dökülebilir.

TextButton

Metin içeren ve onclick. eyleme dökülebilir.

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

string

Düğmenin metni.

onClick

object (OnClick)

İlgili içeriği oluşturmak için kullanılan onclick. işlemini seçin.

ImageButton

İçinde bir onclick. eyleme dökülebilir.

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

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Alanlar
onClick

object (OnClick)

İlgili içeriği oluşturmak için kullanılan onclick. eyleme dökülebilir.

name

string

Bu cihazın adı imageButton. için de geçerlidir. Bu ad belirtilmezse varsayılan değer sağlanır.

Birlik alanı icons Simge, Icon. enum belirtir. icons. aşağıdakilerden yalnızca biri olabilir:
icon

enum (Icon)

Bir enum. Chat API tarafından sağlanan bir simgeye işaret eder.

iconUrl

string

URL ile belirtilen simge.

CardAction

Kart işlemi, kartla ilişkilendirilmiş işlemdir. Fatura kartları için tipik işlem şu şekildedir: faturayı silme veya faturayı e-posta ile silme ya da faturayı tarayıcıda açma.

Google Chat uygulamalarında desteklenmez.

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

string

Etiket, daha önce işlem menüsü öğesinde görüntüleniyordu.

onClick

object (OnClick)

Bu işlem öğesi için tıklama işlemi.