Cards v1

Kart

Kart, metin ve resim gibi kullanıcı arayüzü widget'larını 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ık genellikle bir başlık ve bir resim içerir.

sections[]

object (Section)

Bölümler, çizgiyle 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 belirtilmişse her biri bir satır kaplar. Yalnızca başlık belirtilmişse 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 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

Bir bölüm, belirtildikleri sırayla (dikey olarak) oluşturulan bir widget koleksiyonu içerir. Kartlar tüm platformlarda dar ve sabit bir genişliğe sahip olduğundan şu anda düzen özelliklerine (ör. kaydırma) gerek yoktur.

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

string

Bölümün başlığı. Biçimlendirilmiş metin desteklenir. Metni 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üm en az bir widget içermelidir.

WidgetMarkup

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

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

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
Alanlar
buttons[]

object (Button)

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

Bir WidgetMarkup yalnızca aşağıdaki öğelerden birini içerebilir. Daha fazla öğe göstermek için birden fazla WidgetMarkup alanı kullanabilirsiniz. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
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.

Karşılıklı olarak hariç tutulan alanların sonu.

TextParagraph

Bir metin paragrafı. Biçimlendirilmiş metin desteklenir. Metni 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 içerebilen bir resim.

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

string

Resmin URL'si.

onClick

object (OnClick)

The onclick action.

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. Bu özellik, resmin yerleşik en boy oranını geçersiz kılmak için tasarlanmamıştır. Ayarlanmamışsa sunucu, resmi önceden getirerek bu alanı doldurur.

OnClick

Bir onclick işlemi (örneğin, bağlantı açma).

JSON gösterimi 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
Alanlar
Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
action

object (FormAction)

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

Karşılıklı olarak hariç tutulan alanların sonu.

FormAction

Form işlemi, form gönderildiğinde gerçekleşen davranışı açıklar. Ö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 belirlemek 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 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, üç erteleme düğmesi olduğunu düşünelim: şimdi ertele, bir gün ertele, gelecek hafta ertele. Dize parametreleri listesinde erteleme türünü ve erteleme süresini ileterek action method = snooze() kullanabilirsiniz.

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

string

İşlem komut dosyasının parametresinin adı.

value

string

Parametrenin değeri.

KeyValue

Bir kullanıcı arayüzü öğesi, anahtar (etiket) ve 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)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
Alanlar
topLabel

string

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

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

Simgelerden en az biri, top_label ve bottom_label tanımlanmalıdır. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
icon

enum (Icon)

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

iconUrl

string

URL ile belirtilen simge.

Karşılıklı olarak hariç tutulan alanların sonu.
Kontrol widget'ı. button veya switch_widget değerini ayarlayabilirsiniz ancak ikisini birden ayarlayamazsınız. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
button

object (Button)

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

Karşılıklı olarak hariç tutulan alanların sonu.

Simge

Desteklenen simgeler kümesi.

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

A düğmesi. Metin düğmesi veya resim düğmesi olabilir.

JSON gösterimi 
{

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
Alanlar
Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
textButton

object (TextButton)

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

imageButton

object (ImageButton)

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

Karşılıklı olarak hariç tutulan alanların sonu.

TextButton

Metin ve onclick işlem 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 içeren bir resim düğmesi.

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

  "icon": enum (Icon),
  "iconUrl": string
}
Alanlar
onClick

object (OnClick)

The onclick action.

name

string

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

Simge, Icon enum veya URL ile belirtilebilir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
icon

enum (Icon)

Chat API tarafından sağlanan bir simgeye indeks oluşturan enum tarafından belirtilen simge.

iconUrl

string

URL ile belirtilen simge.

Karşılıklı olarak hariç tutulan alanların sonu.

CardAction

Kart işlemi, kartla ilişkili işlemdir. Fatura kartı için tipik bir işlem şunlar olabilir: 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 öğesi için onclick işlemi.