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ığı. Başlıklar genellikle bir başlık ve resim içerir.

sections[]

object (Section)

Bölümler bir satır ayırıcıyla ayrılır.

cardActions[]

object (CardAction)

Bu kartın işlemleri.

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. 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 başlığı kaplar.

subtitle

string

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

imageStyle

enum (ImageStyle)

Resmin türü (ör. kare kenarlıklı veya dairesel kenarlıklı).

imageUrl

string

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

ImageStyle

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

Bölüm

Bir bölüm, belirtildikleri sırada oluşturulan (dikey olarak) bir widget koleksiyonu içerir. Kartlar tüm platformlarda dar ve sabit bir genişliğe sahiptir. Bu nedenle, şu anda düzen özelliklerine (ör. yüzer) gerek yoktur.

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

string

Bölümün başlığı. Biçimlendirilmiş metin desteklenir. 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 (WidgetMarkup)

Bir bölüm en az bir widget içermelidir.

WidgetMarkup

Widget, metin ve resim 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 de oneof data olduğundan bu alanlardan yalnızca biri ayarlanmalıdır.

Birlik alanı data. Bir WidgetMarkup yalnızca aşağıdaki öğelerden birine sahip olabilir. Daha fazla öğe görüntülemek için birden fazla WidgetMarkup alanı kullanabilirsiniz. data yalnızca aşağıdakilerden biri olabilir:
textParagraph

object (TextParagraph)

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

image

object (Image)

Bu widget'ta bir resim gösterin.

keyValue

object (KeyValue)

Bu widget'ta bir anahtar/değer öğesi gösterin.

TextParagraph

Bir paragraf metin. Biçimlendirilmiş metin desteklenir. 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.

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

string

Resim

URL ile belirtilen ve onclick işlemi içerebilen bir resim.

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

string

Resmin URL'si.

onClick

object (OnClick)

onclick işlemi.

aspectRatio

number

Bu resmin en boy oranı (genişlik ve yükseklik). Bu alan, resmin yüklenmesini beklerken resim için doğru yüksekliği ayırmanıza olanak tanır. Bu, resmin yerleşik en boy oranını geçersiz kılmak için kullanılmamalıdır. Ayarlanmamışsa sunucu, resmi önceden alarak doldurur.

OnClick

Bir onclick hareketi (ör. bağlantı açma).

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 yalnızca aşağıdakilerden biri olabilir:

action

object (FormAction)

Belirtilirse bu onclick işlemi tarafından bir form işlemi tetiklenir.

FormAction

Form işlemi, form gönderildiğindeki 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ı, form gönderimini tetikleyen formun hangi bölümünü tanımlamak için kullanılır. Bu bilgiler, kart tıklama etkinliğinin bir parçası olarak Chat uygulamasına geri gönderilir. Ortak bir davranışı tetikleyen birden fazla öğe 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, üç erteleme düğmesi düşünelim: şimdi erteleyin, bir gün erteleyin, önümüzdeki hafta erteleyin. action method = snooze() işlevini kullanarak, ertele türünü ve ertele süresini dize parametreleri listesine iletebilirsiniz.

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

string

İşlem komut dosyası için parametrenin adı.

value

string

Parametrenin değeri.

KeyValue

Kullanıcı arayüzü öğeleri bir anahtar (etiket) ve bir değer (içerik) içerir. Bu öğe, onclick düğmesi gibi bazı işlemleri de içerebilir.

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

content

string

İç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 metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

contentMultiline

boolean

İçeriğin çok satırlık olup olmayacağı.

bottomLabel

string

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

onClick

object (OnClick)

onclick işlemi. 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 yalnızca aşağıdakilerden biri olabilir:
icon

enum (Icon)

Chat API tarafından ilgili simge resmiyle değiştirilen bir enum değeri.

iconUrl

string

URL ile belirtilen simge.

Birlik alanı control. Kontrol widget'ı. button veya switch_widget'i ayarlayabilirsiniz ancak ikisini birden ayarlayamazsınız. control yalnızca aşağıdakilerden biri olabilir:
button

object (Button)

Bir iş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. 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 yalnızca aşağıdakilerden biri olabilir:

textButton

object (TextButton)

Metin ve işlem içeren bir düğme onclick

imageButton

object (ImageButton)

Resim ve işlem içeren bir düğme. onclick

TextButton

Metin ve işlem içeren bir düğme. onclick

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

string

Düğmenin metni.

onClick

object (OnClick)

Düğmenin işlemi.onclick

ImageButton

Bir işleme sahip resim düğmesi onclick

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)

onclick işlemi.

name

string

Erişilebilirlik için kullanılan bu imageButton öğesinin adı. Bu ad belirtilmezse varsayılan değer sağlanır.

Birlik alanı icons. Simge, bir Icon enum veya URL ile belirtilebilir. icons yalnızca aşağıdakilerden biri olabilir:
icon

enum (Icon)

Chat API tarafından sağlanan bir simgeyi dizine ekleyen enum tarafından belirtilen simge.

iconUrl

string

URL ile belirtilen simge.

CardAction

Kart işlemi, kartla ilişkili işlemdir. Fatura kartında tipik işlemler şunlardır: 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 (OnClick)
  }
}
Alanlar
actionLabel

string

Etiket, işlem menüsü öğesinde gösteriliyordu.

onClick

object (OnClick)

Bu işlem öğesinin tıklama işlemi.