Tablo

Grid widget'ı, öğe koleksiyonunu içeren bir ızgara görüntüler.


Kart Oluşturucu ile kartları tasarlayın ve önizleyin.

Card Builder'ı açın

Widget, kullanıcıların tek tip veri girmelerine yardımcı olan önerileri ve değişiklik sırasında işlemleri (ör. metin giriş alanında bir kullanıcının metin eklemesi veya silmesi gibi) bir değişiklik gerçekleştiğinde çalışan Actions işlemleridir.

Izgara, herhangi bir sayıda sütun ve öğeyi destekler. Satır sayısı, öğelerin sütunlara bölünmesiyle belirlenir. 10 öğeli ve 2 sütunlu bir ızgarada 5 satır vardır. 11 öğe ve 2 sütunlu bir ızgarada 6 satır bulunur.

Örnek: tek bir öğe içeren iki sütunlu tablo

Aşağıda, grid widget'ından oluşan bir iletişim kutusu gösterilmektedir. Tek bir öğe içeren 2 sütunlu bir tablo oluşturur.

JSON gösterimi ve alanları

JSON gösterimi
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
Alanlar
title

string

Izgara başlığında görüntülenen metin.

items[]

object (GridItem)

Izgarada görüntülenecek öğeler.

borderStyle

object (BorderStyle)

Her bir ızgara öğesine uygulanacak kenarlık stili.

columnCount

integer

Izgarada görüntülenecek sütun sayısı. Bu alan belirtilmezse varsayılan değer kullanılır ve bu varsayılan değer, ızgaranın gösterildiği yere göre farklılık gösterir (iletişim kutusu veya tamamlayıcı).

onClick

object (OnClick)

Bu geri çağırma, her bir ızgara öğesi tarafından yeniden kullanılır ancak geri çağırmanın parametrelerine öğe listesindeki öğenin tanımlayıcısı ve dizini eklenir.

GridItem

JSON gösterimi
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
Alanlar
id

string

Bu ızgara öğesi için kullanıcı tarafından belirtilen tanımlayıcı. Bu tanımlayıcı, üst tablonun onClick geri çağırma parametrelerinde döndürülür.

image

object (ImageComponent)

Izgara öğesinde görüntülenen resim.

title

string

Izgara öğesinin başlığı.

subtitle

string

Tablo öğesinin alt başlığı.

layout

enum (GridItemLayout)

Izgara öğesi için kullanılacak düzen.

BorderStyle

JSON gösterimi
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
Alanlar
type

enum (BorderType)

Kenarlık türü.

strokeColor

object (Color)

Tür BORDER_TYPE_STROKE olduğunda kullanılacak renkler.

cornerRadius

integer

Kenarlığın köşe yarıçapı.

BorderType

Sıralamalar
BORDER_TYPE_UNSPECIFIED Kullanmayın. Belirtilmedi.
NO_BORDER Varsayılan değer. Kenarlık yok.
STROKE Outline'a dokunun.

Renk

JSON gösterimi
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Alanlar
red

number

[0, 1] aralığındaki bir değer olarak rengin kırmızı miktarı.

green

number

[0, 1] aralığındaki bir değer olarak renkteki yeşil miktarı.

blue

number

[0, 1] aralığındaki bir değer olarak rengin mavi miktarı.

alpha

number

Bu rengin piksele uygulanması gereken oranı. Yani, pikselin son rengi aşağıdaki denklemle tanımlanır:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Diğer bir deyişle, 1,0 değeri düz bir renge, 0,0 değeri ise tamamen şeffaf bir renge karşılık gelir. Bu, varsayılan değer ile ayarlanmamış olan değer arasında ayrım yapılabilmesi için basit bir kayan skaler yerine sarmalayıcı mesajı kullanır. Atlanırsa, bu renk nesnesi düz bir renk olarak oluşturulur (alfa değerine açıkça 1,0 değeri verilmiş gibi).

OnClick

Kullanıcılar karttaki düğme gibi etkileşimli bir öğeyi tıkladığında nasıl yanıt verileceğini temsil eder.

Google Chat uygulamaları ve Google Workspace Eklentileri için kullanılabilir.

JSON gösterimi
{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  }
  // 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 (Action)

Belirtilirse bu onClick tarafından bir işlem tetiklenir.

card

object (Card)

Belirtilmişse, tıklandığında kart yığınına yeni bir kart aktarılır.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

İşlem

Form gönderildiğinde ortaya çıkan davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası'nı çağırabilirsiniz. İşlem tetiklenirse form değerleri sunucuya gönderilir.

Google Chat uygulamaları ve Google Workspace Eklentileri için kullanılabilir.

JSON gösterimi
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Alanlar
function

string

Kapsayıcı öğe tıklandığında veya etkinleştirildiğinde çağrılacak özel bir işlev.

Örneğin kullanımı Etkileşimli kartlar oluşturma konusuna bakın.

parameters[]

object (ActionParameter)

İşlem parametrelerinin listesi.

loadIndicator

enum (LoadIndicator)

Harekete geçirici mesaj yapılırken görüntülenen yükleme göstergesini belirtir.

persistValues

boolean

İşlemden sonra form değerlerinin kullanılmaya devam edip etmediğini belirtir. Varsayılan değer: false.

true ise form değerleri işlem tetiklendikten sonra kalır. İşlem işlenirken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator özelliğini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId işaretini kullanmanız gerekir.

false ise işlem tetiklendiğinde form değerleri temizlenir. İşlem işlenirken kullanıcının değişiklik yapmasını önlemek için LoadIndicator özelliğini SPINNER olarak ayarlayın.

interaction

enum (Interaction)

İsteğe bağlı. İletişim kutusu açılırken gereklidir.

Bir kullanıcıyla etkileşime (ör. bir kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılması gerekenler.

Belirtilmemişse uygulama, normal şekilde bir action çalıştırarak (ör. bir bağlantı açarak veya bir işlev çalıştırarak) yanıt verir.

interaction belirtildiğinde, uygulama özel etkileşimli yollarla yanıt verebilir. Örneğin, interaction OPEN_DIALOG olarak ayarlandığında uygulama bir iletişim kutusu açabilir. Belirtildiğinde, bir yükleme göstergesi gösterilmez. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileri için kullanılamaz.

Sorun giderme

Bir Google Chat uygulaması veya kart hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu." veya "İsteğiniz işleme alınamıyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmese de, Chat uygulamaları için hata günlük kaydı etkinken hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri mevcuttur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.