Cards v1

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 (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Alanlar
header

object (CardHeader)

Kartın başlığı. Üstbilgi 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 karttaki 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. 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

string

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

imageStyle

enum (ImageStyle)

Resmin türü (örneğin, kare kenarlık veya dairesel 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

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 (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 metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin.

widgets[]

object (WidgetMarkup)

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 (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 değerine sahiptir ve bu alanlardan yalnızca biri ayarlanmalıdır.

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

object (TextParagraph)

Bu widget'ta bir metin paragrafı görüntüleyin.

image

object (Image)

Bu widget'ta bir resim görüntüle.

keyValue

object (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

string

Resim

URL ile belirtilen ve onclick işlemi olabilen 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, 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 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

Birleşim alanı data.

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

action

object (FormAction)

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

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 (ActionParameter)
    }
  ]
}
Alanlar
actionMethodName

string

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[]

object (ActionParameter)

İş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

string

İşlem komut dosyasına ait parametrenin adı.

value

string

Parametrenin değeri.

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 (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 Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni 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 metni biçimlendirme ve Google Workspace Eklentilerinde metni biçimlendirme başlıklı makaleleri inceleyin.

contentMultiline

boolean

İçeriğin çok satırlı olup olmadığı

bottomLabel

string

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

object (OnClick)

onclick işlemi. Yalnızca üst etiket, alt etiket ve içerik bölgesi tıklanabilir.

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

enum (Icon)

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

iconUrl

string

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

object (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 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

Birleşim alanı type.

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

textButton

object (TextButton)

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

imageButton

object (ImageButton)

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

TextButton

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

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

string

Düğmenin metni.

onClick

object (OnClick)

Düğmenin onclick işlemi.

ImageButton

onclick işlemi olan bir resim düğmesi.

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.

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

enum (Icon)

Chat API tarafından sağlanan bir simgeye işaret eden enum ile belirtilen simge.

iconUrl

string

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 (OnClick)
  }
}
Alanlar
actionLabel

string

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

onClick

object (OnClick)

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