Cards v2

object (CardHeader)

Kartın başlığı. Başlık genellikle bir ön resim ve bir başlık içerir. Başlıklar her zaman kartın üst kısmında görünür.

object (Section)

Bir widget koleksiyonu içerir. Her bölümün kendi isteğe bağlı başlığı vardır. Bölümler, görsel olarak bir çizgiyle ayrılır. Google Chat uygulamalarındaki bir örnek için Kartın bir bölümünü tanımlama başlıklı makaleyi inceleyin.

enum (DividerStyle)

Başlık, bölümler ve altbilgi arasındaki ayırıcı stili.

object (CardAction)

Kartın işlemleri. Kartın araç çubuğu menüsüne işlemler eklenir.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

Örneğin, aşağıdaki JSON, Settings ve Send Feedback seçenekleriyle bir kart işlemi menüsü oluşturur:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

Kartın adı. Kart gezinmede kart tanımlayıcı olarak kullanılır.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (CardFixedFooter)

Bu kartın en altında gösterilen sabit altbilgi.

Bir fixedFooter değerini primaryButton veya secondaryButton belirtmeden ayarlamak hataya neden olur. Chat uygulamalarında, iletişim kutularında sabit altbilgiler kullanabilirsiniz ancak kart mesajlarında kullanamazsınız.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

enum (DisplayStyle)

Google Workspace eklentilerinde, peekCardHeader öğesinin görüntüleme özelliklerini ayarlar.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (CardHeader)

İçeriğe dayalı içerik gösterilirken, kullanıcının ana sayfa kartları ile içeriğe dayalı kartlar arasında ileriye doğru gezinmesini sağlamak için göz atma kartı başlığı yer tutucu görevi görür.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

string

Zorunlu. Kart başlığının adı. 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 belirtilirse her iki satırı da kaplar.

string

Kart başlığının alt başlığı. Belirtilmişse title'nın altında ayrı bir satırda görünür.

enum (ImageType)

Resmi kırpmak için kullanılan şekil.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

string

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

string

Erişilebilirlik için kullanılan bu resmin alternatif metni.

string

Bir bölümün en üstünde görünen metin. Basit HTML biçimli metinleri destekler. 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.

object (Widget)

Bölümdeki tüm widget'lar. En az bir widget içermelidir.

boolean

Bu bölümün daraltılabilir olup olmadığını gösterir.

Daraltılabilir bölümler, bazı widget'ları veya tüm widget'ları gizler. Ancak kullanıcılar, Daha fazla göster'i tıklayarak bölümü genişletip gizli widget'ları gösterebilir. Kullanıcılar Daha az göster'i tıklayarak widget'ları tekrar gizleyebilir.

Hangi widget'ların gizlendiğini belirlemek için uncollapsibleWidgetsCount öğesini belirtin.

integer

Bir bölüm daraltıldığında bile görünür kalmaya devam eden daraltılamayan widget'ların sayısı.

Örneğin, bir bölümde beş widget varsa ve uncollapsibleWidgetsCount 2 olarak ayarlanmışsa ilk iki widget her zaman gösterilir ve son üç widget varsayılan olarak daraltılır. uncollapsibleWidgetsCount yalnızca collapsible true olduğunda dikkate alınır.

object (CollapseControl)

İsteğe bağlıdır. Bölümün genişletme ve daraltma düğmesini tanımlayın. Bu düğme yalnızca bölüm daraltılabilirse gösterilir. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

enum (HorizontalAlignment)

Widget'ların bir sütunun soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir.

object (TextParagraph)

Metin paragrafını gösterir. Basit HTML biçimli metinleri destekler. 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.

Örneğin, aşağıdaki JSON, kalın metin oluşturur:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

object (Image)

Bir resim görüntüler.

Örneğin, aşağıdaki JSON, alternatif metin içeren bir resim oluşturur:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

object (DecoratedText)

Biçimlendirilmiş bir metin öğesini gösterir.

Örneğin, aşağıdaki JSON, e-posta adresini gösteren süslenmiş bir metin widget'ı oluşturur:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object (ButtonList)

Düğme listesi.

Örneğin, aşağıdaki JSON iki düğme oluşturur. Birincisi mavi bir metin düğmesi, ikincisi ise bir bağlantıyı açan bir resim düğmesidir:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

object (TextInput)

Kullanıcıların içine yazabileceği bir metin kutusu gösterir.

Örneğin, aşağıdaki JSON, e-posta adresi için bir metin girişi oluşturur:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Başka bir örnek olarak, aşağıdaki JSON, statik öneriler içeren bir programlama dili için metin girişi oluşturur:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

object (SelectionInput)

Kullanıcıların öğe seçmesine olanak tanıyan bir seçim kontrolü gösterir. Seçim kontrolleri onay kutuları, radyo düğmeleri, anahtarlar veya açılır menüler olabilir.

Örneğin, aşağıdaki JSON, kullanıcıların boyut seçmesine olanak tanıyan bir açılır menü oluşturur:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

object (DateTimePicker)

Kullanıcıların tarih, saat veya tarih ve saat girmesine olanak tanıyan bir widget gösterir.

Örneğin, aşağıdaki JSON, randevu planlamak için bir tarih ve saat seçici oluşturur:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}

object (Divider)

Widget'lar arasında yatay bir çizgi ayırıcı gösterir.

Örneğin, aşağıdaki JSON bir ayırıcı oluşturur:

"divider": {
}

object (Grid)

Öğe koleksiyonunun bulunduğu bir ızgara gösterir.

Bir ızgara, herhangi bir sayıda sütunu ve öğeyi destekler. Satır sayısı, öğe sayısının üst sınırının sütun sayısına bölünmesiyle belirlenir. 10 öğe ve 2 sütun içeren bir ızgarada 5 satır bulunur. 11 öğe ve 2 sütun içeren bir ızgarada 6 satır bulunur.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

Örneğin, aşağıdaki JSON tek öğeli 2 sütunlu bir ızgara oluşturur:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

object (Columns)

En fazla 2 sütun gösterir.

2'den fazla sütun eklemek veya satır kullanmak için Grid widget'ını kullanın.

Örneğin, aşağıdaki JSON, her biri metin paragrafları içeren 2 sütun oluşturur:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

object (Carousel)

Bant, iç içe yerleştirilmiş widget'lardan oluşan bir koleksiyon içerir. Örneğin, bu, iki metin paragrafı içeren bir bandın JSON gösterimidir.

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}

object (ChipList)

Çiplerin listesi.

Örneğin, aşağıdaki JSON iki çip oluşturur. Birincisi metin çipi, ikincisi ise bağlantı açan simge çipidir:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

string

Widget'ta gösterilen metin.

integer

Widget'ta gösterilen maksimum metin satırı sayısı. Metin, belirtilen maksimum satır sayısını aşıyorsa fazla içerik daha fazla göster düğmesinin arkasında gizlenir. Metin, belirtilen maksimum satır sayısına eşit veya daha kısaysa daha fazla göster düğmesi gösterilmez.

Varsayılan değer 0'dır. Bu durumda tüm bağlam görüntülenir. Negatif değerler yoksayılır.

enum (TextSyntax)

Metnin söz dizimi. Ayarlanmazsa metin HTML olarak oluşturulur.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

string

Resmin barındırıldığı HTTPS URL'si.

Örneğin:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

object (OnClick)

Kullanıcı resmi tıkladığında tıklama bu işlemi tetikler.

string

Erişilebilirlik için kullanılan bu resmin alternatif metni.

object (Action)

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

object (OpenLink)

Belirtilirse bu onClick, bağlantı açma işlemini tetikler.

object (Action)

Bir eklenti, bağlantı açması gerektiğinde bu işlemi tetikler. Bu, yukarıdaki openLink işleminden farklıdır. Bağlantıyı almak için sunucuyla iletişim kurması gerekir. Bu nedenle, açık bağlantı işlemi yanıtı geri gelmeden önce web istemcisinin bazı hazırlık çalışmaları yapması gerekir.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (Card)

Belirtilmişse tıklama işleminden sonra kart yığınına yeni bir kart gönderilir.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (OverflowMenu)

Belirtilmişse bu onClick taşma menüsünü açar.

string

Kapsayan öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel bir işlev.

Kullanım örneği için Form verilerini okuma başlıklı makaleye bakın.

object (ActionParameter)

İşlem parametrelerinin listesi.

enum (LoadIndicator)

İşleme çağrı yapılırken işlemin gösterdiği yükleme göstergesini belirtir.

boolean

Form değerlerinin işlemden sonra kalıcı olup olmadığını gösterir. Varsayılan değer: false.

true ise işlem tetiklendikten sonra form değerleri kalır. İşlem devam ederken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator<0x0x0A> değerini NONE olarak ayarlayın. Sohbet uygulamalarındaki kart mesajları için işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId değerini kullanmanız gerekir.

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

enum (Interaction)

İsteğe bağlıdır. İletişim kutusu açarken zorunludur.

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

Belirtilmemişse uygulama, normal şekilde action (ör. bağlantı açma veya işlev çalıştırma) işlemi yaparak yanıt verir.

interaction belirterek uygulama, özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction değerini OPEN_DIALOG olarak ayarlayarak uygulama bir iletişim kutusu açabilir. Belirtildiğinde yükleme göstergesi gösterilmez. Bir eklenti için belirtilmişse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

string

İsteğe bağlıdır. Bu listeyi, bu İşlemin geçerli bir gönderim için ihtiyaç duyduğu widget'ların adlarıyla doldurun.

Bu İşlem çağrıldığında burada listelenen widget'ların değeri yoksa form gönderimi iptal edilir.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

boolean

İsteğe bağlıdır. Bu doğruysa tüm widget'lar bu işlem için gerekli kabul edilir.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

string

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

string

Parametrenin değeri.

string

Açılacak URL.

enum (OpenAs)

Bağlantı açma

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

enum (OnClose)

Müşterinin, bağlantıyı açtıktan sonra unutması veya pencere kapanana kadar bağlantıyı gözlemlemesi

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (OverflowMenuItem)

Zorunlu. Menü seçeneklerinin listesi.

object (Icon)

Metnin önünde görüntülenen simge.

string

Zorunlu. Öğeyi kullanıcılara tanıtan veya açıklayan metin.

object (OnClick)

Zorunlu. Bir menü seçeneği belirlendiğinde çağrılan işlem. Bu OnClick bir OverflowMenu içeremez. Belirtilen OverflowMenu bırakılır ve menü öğesi devre dışı bırakılır.

boolean

Menü seçeneğinin devre dışı olup olmadığı. Varsayılan olarak false değerine ayarlanır.

string

İsteğe bağlıdır. Erişilebilirlik için kullanılan simgenin açıklaması. Belirtilmediği takdirde varsayılan değer Button sağlanır. En iyi uygulama olarak, simgenin neyi gösterdiğine ve geçerliyse ne işe yaradığına dair faydalı bir açıklama belirlemelisiniz. Örneğin, A user's account portrait veya Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

Simge bir Button içinde ayarlanırsa kullanıcı düğmenin üzerine geldiğinde altText yardım metni olarak görünür. Ancak düğme text değerini de ayarlarsa simgenin altText değeri yoksayılır.

enum (ImageType)

Resme uygulanan kırpma stili. Bazı durumlarda, kırpma işlemi uygulandığında resim, yerleşik bir simgeden daha büyük çizilir.CIRCLE

string

Google Workspace tarafından sağlanan yerleşik simgelerden birini gösterin.

Örneğin, bir uçak simgesi göstermek için AIRPLANE değerini belirtin. Otobüs için BUS değerini belirtin.

Desteklenen simgelerin tam listesi için yerleşik simgeler başlıklı makaleyi inceleyin.

string

HTTPS URL'sinde barındırılan özel bir simge görüntüleyin.

Örneğin:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

Desteklenen dosya türleri arasında .png ve .jpg yer alır.

object (MaterialIcon)

Google Material simgelerinden birini gösterin.

Örneğin, onay kutusu simgesi göstermek için

"materialIcon": {
  "name": "check_box"
}

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

string

Google Material Icon'da tanımlanan simge adı (örneğin, check_box). Geçersiz adlar bırakılır ve boş dizeyle değiştirilir. Bu durum, simgenin oluşturulamamasına neden olur.

boolean

Simgenin dolu olarak oluşturulup oluşturulmadığı. Varsayılan değer false'tur.

Farklı simge ayarlarını önizlemek için Google Font Icons'a gidin ve Özelleştir bölümündeki ayarları düzenleyin.

integer

Simgenin çizgi kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Yoksa varsayılan değer 400'dür. Başka bir değer belirtilirse varsayılan değer kullanılır.

Farklı simge ayarlarını önizlemek için Google Font Icons'a gidin ve Özelleştir bölümündeki ayarları düzenleyin.

integer

Ağırlık ve derece, bir sembolün kalınlığını etkiler. Not ayarlamaları, ağırlık ayarlamalarına göre daha ayrıntılıdır ve sembolün boyutu üzerinde küçük bir etkiye sahiptir. {-25, 0, 200} arasından seçim yapın. Bu özellik yoksa varsayılan değer 0 olur. Başka bir değer belirtilirse varsayılan değer kullanılır.

Farklı simge ayarlarını önizlemek için Google Font Icons'a gidin ve Özelleştir bölümündeki ayarları düzenleyin.

object (Icon)

startIcon lehine kullanımdan kaldırıldı.

object (Icon)

Metnin önünde görüntülenen simge.

enum (VerticalAlignment)

İsteğe bağlıdır. Başlangıç simgesinin dikey hizalaması. Ayarlanmazsa simge dikey olarak ortalanır.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

string

text öğesinin üzerinde görünen metin. Her zaman kesilir.

object (TextParagraph)

TextParagraph eşdeğeri topLabel. Her zaman kesilir. topLabel'dan daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

string

Zorunlu. Birincil metin.

Basit biçimlendirmeyi destekler. 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.

object (TextParagraph)

TextParagraph eşdeğeri text. text'dan daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

boolean

Metin kaydırma ayarı. Eğer true ise metin kaydırılır ve birden fazla satırda gösterilir. Aksi takdirde metin kısaltılır.

Yalnızca text için geçerlidir, topLabel ve bottomLabel için geçerli değildir.

string

text simgesinin altında görünen metin. Her zaman sarar.

object (TextParagraph)

TextParagraph eşdeğeri bottomLabel. Her zaman sarar. bottomLabel'dan daha karmaşık biçimlendirmeye olanak tanır.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

object (OnClick)

Bu işlem, kullanıcılar topLabel veya bottomLabel simgesini tıkladığında tetiklenir.

object (Button)

Kullanıcının bir işlemi tetiklemek için tıklayabileceği düğme.

object (SwitchControl)

Kullanıcının durumunu değiştirmek ve bir işlemi tetiklemek için tıklayabileceği bir anahtar widget'ı.

object (Icon)

Metinden sonra gösterilen simge.

Yerleşik ve özel simgeleri destekler.

string

Düğmede görüntülenen metin.

object (Icon)

Düğmede gösterilen bir simge. Hem icon hem de text ayarlanırsa simge metinden önce görünür.

object (Color)

İsteğe bağlıdır. Düğmenin rengi. Ayarlanırsa düğme type olarak ayarlanır FILLED ve okunabilirlik için text ve icon alanlarının rengi kontrast bir renge ayarlanır. Örneğin, düğme rengi mavi olarak ayarlanırsa düğmedeki tüm metinler veya simgeler beyaz olarak ayarlanır.

Düğme rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Burada: 0 (0/255) rengin olmadığını ve 1 (255/255) rengin maksimum yoğunluğunu gösterir.

Örneğin, aşağıdaki kod rengi maksimum yoğunlukta kırmızı olarak ayarlar:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

Düğme rengi için alpha alanı kullanılamaz. Belirtilirse bu alan yoksayılır.

object (OnClick)

Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel işlev çalıştırma).

boolean

If true, the button is displayed in an inactive state and doesn't respond to user actions.

string

Erişilebilirlik için kullanılan alternatif metin.

Kullanıcılara düğmenin ne işe yaradığını bildiren açıklayıcı bir metin ayarlayın. Örneğin, bir düğme köprüyü açıyorsa şunu yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider."

enum (Type)

İsteğe bağlıdır. Düğmenin türü. Ayarlanmamışsa düğme türü varsayılan olarak OUTLINED olur. color alanı ayarlanırsa düğme türü FILLED olarak zorlanır ve bu alan için ayarlanan tüm değerler yoksayılır.

number

Renk içindeki kırmızı miktarının [0, 1] aralığındaki değeri.

number

Renk içindeki yeşil miktarı [0, 1] aralığında bir değer olarak.

number

Rengin mavi bileşeninin [0, 1] aralığındaki değeri.

number

Bu rengin piksele uygulanması gereken oranı. Yani, nihai piksel rengi şu denklemle tanımlanır:

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

Bu nedenle, 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ış değer arasında ayrım yapabilmek için basit bir kayan nokta skaler yerine sarmalayıcı ileti kullanır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açıkça 1, 0 değeri verilmiş gibi).

string

Anahtar widget'ının bir form girişi etkinliğinde tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcı tarafından girilen ve bir form girişi etkinliğinin parçası olarak döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

boolean

true seçildiğinde

object (Action)

Anahtar durumu değiştiğinde gerçekleştirilecek işlem (ör. hangi işlevin çalıştırılacağı).

enum (ControlType)

Anahtarın kullanıcı arayüzünde nasıl göründüğü.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

object (Button)

Düğme dizisi.

string

Metin girişinin bir form girişi etkinliğinde tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcı arayüzündeki metin giriş alanının üzerinde görünen metin.

Kullanıcının, uygulamanızın ihtiyaç duyduğu bilgileri girmesine yardımcı olacak metni belirtin. Örneğin, birinin adını soruyorsanız ancak özellikle soyadını öğrenmek istiyorsanız surname yerine name yazın.

hintText belirtilmemişse gereklidir. Aksi takdirde isteğe bağlıdır.

string

Kullanıcıları belirli bir değer girmeye yönlendirerek yardımcı olmak için metin giriş alanının altında görünen metin. Bu metin her zaman görünür.

label belirtilmemişse gereklidir. Aksi takdirde isteğe bağlıdır.

string

Kullanıcı tarafından girilen ve bir form girişi etkinliğinin parçası olarak döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

enum (Type)

Metin girişi alanının kullanıcı arayüzünde nasıl göründüğü. Örneğin, alanın tek satırlı mı yoksa çok satırlı mı olduğu.

object (Action)

Metin giriş alanında değişiklik olduğunda ne yapılması gerektiği. Örneğin, kullanıcının alana ekleme yapması veya metin silmesi.

Özel bir işlevi çalıştırmak veya Google Chat'te bir iletişim kutusu açmak, yapılacak işlemlerden bazılarıdır.

object (Suggestions)

Kullanıcıların girebileceği önerilen değerler. Bu değerler, kullanıcılar metin girişi alanını tıkladığında görünür. Kullanıcılar yazarken önerilen değerler, yazdıklarıyla eşleşecek şekilde dinamik olarak filtrelenir.

Örneğin, programlama dili için bir metin giriş alanı Java, JavaScript, Python ve C++'ı önerebilir. Kullanıcılar yazmaya başladığında Jav, öneri listesi yalnızca Java ve JavaScript'ı gösterecek şekilde filtrelenir.

Önerilen değerler, kullanıcıların uygulamanızın anlayabileceği değerler girmesine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript bazı kullanıcılar ise java script girebilir. Öneriler JavaScript kullanıcıların uygulamanızla etkileşim kurma şeklini standartlaştırabilir.

Belirtildiğinde TextInput.type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

object (Action)

İsteğe bağlıdır. Metin giriş alanı, etkileşimde bulunan kullanıcılara öneriler sunduğunda hangi işlemin yapılacağını belirtin.

Belirtilmemişse öneriler initialSuggestions tarafından ayarlanır ve istemci tarafından işlenir.

Belirtilmişse uygulama, burada belirtilen işlemi (ör. özel bir işlevi çalıştırma) gerçekleştirir.

Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.

object (Validation)

Bu metin alanı için gerekli olan giriş biçimi doğrulamasını belirtin.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

string

Alan boş olduğunda metin giriş alanında görünen metin. Kullanıcıları değer girmeye yönlendirmek için bu metni kullanın. Örneğin, Enter a number from 0 to 100.

Google Chat uygulamalarında kullanılabilir, Google Workspace eklentilerinde kullanılamaz.

Action

Navigation

Kartı gönderir, gösterir veya günceller.

Google Chat'teki eklentiler.

Card

Kartı, kart yığınına iter.

Google Chat'teki iletişim kutuları için bir iletişim kutusunu açar veya günceller.

Card

En üstteki kartı yeni bir kartla günceller ve doldurulmuş form alanlarının değerlerini korur. Eşdeğer olmayan bir alan için değer bırakılır.

Google Chat'teki iletişim kutuları için bir iletişim kutusunu açar veya günceller.

object (SuggestionItem)

Metin girişi alanlarındaki otomatik tamamlama önerileri için kullanılan öneri listesi.

string

Bir metin girişi alanına önerilen girişin değeri. Bu, kullanıcıların kendilerinin girdiği bilgilere eşdeğerdir.

integer

Metin girişi widget'ları için karakter sınırını belirtin. Bu özelliğin yalnızca metin girişi için kullanıldığını ve diğer widget'lar için yoksayıldığını unutmayın.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

enum (InputType)

Giriş widget'larının türünü belirtin.

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

string

Zorunlu. Bir form girişi etkinliğinde seçim girişini tanımlayan ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcı arayüzünde seçim giriş alanının üzerinde görünen metin.

Kullanıcının, uygulamanızın ihtiyaç duyduğu bilgileri girmesine yardımcı olacak metni belirtin. Örneğin, kullanıcılar bir açılır menüden iş talebinin aciliyetini seçiyorsa etiket "Aciliyet" veya "Aciliyet seçin" olabilir.

enum (SelectionType)

Kullanıcılara bir SelectionInput widget'ında gösterilen öğelerin türü. Seçim türleri, farklı etkileşim türlerini destekler. Örneğin, kullanıcılar bir veya daha fazla onay kutusu seçebilir ancak açılır menüden yalnızca bir değer seçebilir.

object (SelectionItem)

Seçilebilir öğeler dizisi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. 100 öğeye kadar destekler.

object (Action)

Belirtilmişse seçim değiştiğinde form gönderilir. Belirtilmemişse formu gönderen ayrı bir düğme belirtmeniz gerekir.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

integer

Çoklu seçim menülerinde, kullanıcının seçebileceği maksimum öğe sayısı. Minimum değer 1 öğedir. Belirtilmezse varsayılan olarak 3 öğe kullanılır.

integer

Çoklu seçim menülerinde, menü önerilen seçim öğelerini döndürmeden önce kullanıcının girdiği metin karakterlerinin sayısı.

Ayarlanmamışsa çoklu seçim menüsünde aşağıdaki varsayılan değerler kullanılır:

• Menüde statik bir SelectionInput öğe dizisi kullanılıyorsa varsayılan olarak 0 karakter olur ve dizideki öğeler hemen doldurulur.
• Menüde dinamik bir veri kaynağı ( multi_select_data_source) kullanılıyorsa önerilen öğeleri döndürmek için veri kaynağı sorgulanmadan önce varsayılan olarak 3 karakter kullanılır.

object (Action)

İlişkisel veritabanı gibi bir harici veri kaynağı.

object (PlatformDataSource)

Google Workspace'ten bir veri kaynağı.

string

Öğeyi kullanıcılara tanıtan veya açıklayan metin.

string

Bu öğeyle ilişkili değer. Müşteri bunu form girişi değeri olarak kullanmalıdır.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

boolean

Öğenin varsayılan olarak seçilip seçilmediği. Seçim girişi yalnızca bir değer kabul ediyorsa (ör. radyo düğmeleri veya açılır menü), bu alanı yalnızca bir öğe için ayarlayın.

string

Çoklu seçim menülerinde, öğenin text alanının altında gösterilen bir metin açıklaması veya etiket.

string

enum (CommonDataSource)

Tüm Google Workspace uygulamaları tarafından paylaşılan bir veri kaynağı (ör. Google Workspace kuruluşundaki kullanıcılar).

object (HostAppDataSourceMarkup)

Google Chat'teki alanlar gibi bir Google Workspace ana makine uygulamasına özgü bir veri kaynağı.

Bu alan, Google API İstemci Kitaplıklarını destekler ancak Cloud İstemci Kitaplıklarında kullanılamaz. Daha fazla bilgi edinmek için İstemci kitaplıklarını yükleme başlıklı makaleyi inceleyin.

object (ChatClientDataSourceMarkup)

Google Chat'ten alınan bir veri kaynağı.

object (SpaceDataSource)

Kullanıcının üyesi olduğu Google Chat alanları.

boolean

true olarak ayarlanırsa çoklu seçim menüsünde mevcut Google Chat alanı varsayılan olarak öğe olarak seçilir.

string

DateTimePicker öğesinin bir form girişi etkinliğinde tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcılardan tarih, saat veya tarih ve saat girmelerini isteyen metin. Örneğin, kullanıcılar randevu planlıyorsa Appointment date veya Appointment date and time gibi bir etiket kullanın.

enum (DateTimePickerType)

Widget'ın tarih, saat veya tarih ve saat girişini destekleyip desteklemediği.

int64

Widget'ta gösterilen varsayılan değer, Unix epoch zamanından bu yana geçen milisaniye cinsinden süredir.

Değeri seçicinin türüne göre belirtin ( DateTimePickerType):

• DATE_AND_TIME : UTC'de bir takvim tarihi ve saati. Örneğin, 1 Ocak 2023 saat 12:00 (UTC) değerini göstermek için 1672574400000 biçimini kullanın.
• DATE_ONLY : 00:00:00 UTC'deki bir takvim tarihi. Örneğin, 1 Ocak 2023'ü temsil etmek için 1672531200000 kullanın.
• TIME_ONLY : UTC'de bir saat. Örneğin, 12:00'ı göstermek için 43200000 (veya 12 * 60 * 60 * 1000) kullanın.

integer

UTC'den saat dilimi farkını dakika cinsinden gösteren sayı. Ayarlanmışsa valueMsEpoch, belirtilen saat diliminde gösterilir. Ayarlanmamışsa değer, kullanıcının saat dilimi ayarına göre belirlenir.

object (Action)

Kullanıcı, DateTimePicker arayüzünde Kaydet veya Temizle'yi tıkladığında tetiklenir.

string

Izgara başlığında gösterilen metin.

object (GridItem)

Tabloda gösterilecek öğeler.

object (BorderStyle)

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

integer

Izgarada gösterilecek sütun sayısı. Bu alan belirtilmezse varsayılan bir değer kullanılır. Bu varsayılan değer, kılavuzun gösterildiği yere (iletişim kutusu ve eşlik eden reklam) bağlı olarak değişir.

object (OnClick)

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

string

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

object (ImageComponent)

Izgara öğesinde gösterilen resim.

string

Izgara öğesinin başlığı.

string

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

enum (GridItemLayout)

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

string

Resmin URL'si.

string

Resmin erişilebilirlik etiketi.

object (ImageCropStyle)

Resme uygulanacak kırpma stili.

object (BorderStyle)

Resme uygulanacak kenarlık stili.

enum (ImageCropType)

Kırpma türü.

number

Kırpma türü RECTANGLE_CUSTOM ise kullanılacak en boy oranı.

Örneğin, 16:9 en boy oranını şu şekilde uygulayabilirsiniz:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

enum (BorderType)

Kenarlık türü.

object (Color)

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

Kontur rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Burada: 0 (0/255) rengin olmadığını ve 1 (255/255) rengin maksimum yoğunluğunu gösterir.

Örneğin, aşağıdaki kod rengi maksimum yoğunlukta kırmızı olarak ayarlar:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

alpha alanı, kontur rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.

integer

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

object (Column)

Sütun dizisi. Bir karta veya iletişim kutusuna en fazla 2 sütun ekleyebilirsiniz.

enum (HorizontalSizeStyle)

Bir sütunun kartın genişliğini nasıl dolduracağını belirtir.

enum (HorizontalAlignment)

Widget'ların bir sütunun soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir.

enum (VerticalAlignment)

Widget'ların bir sütunun üst, alt veya merkez kısmına hizalanıp hizalanmayacağını belirtir.

object (Widgets)

Bir sütuna dahil edilen widget dizisi. Widget'lar, belirtildikleri sırada görünür.

object (TextParagraph)

TextParagraph widget'ı.

object (Image)

Image widget'ı.

object (DecoratedText)

DecoratedText widget'ı.

object (ButtonList)

ButtonList widget'ı.

object (TextInput)

TextInput widget'ı.

object (SelectionInput)

SelectionInput widget'ı.

object (DateTimePicker)

DateTimePicker widget'ı.

object (ChipList)

ChipList widget'ı.

enum (Layout)

Belirtilen çip listesi düzeni.

object (Chip)

Çipler dizisi.

object (Icon)

Simge resmi. Hem icon hem de text ayarlanırsa simge metinden önce görünür.

string

Çipin içinde görüntülenen metin.

object (OnClick)

İsteğe bağlıdır. Kullanıcı çipi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel işlev çalıştırma).

boolean

Çipin etkin durumda olup olmadığı ve kullanıcı işlemlerine yanıt verip vermediği. Varsayılan olarak true değerine ayarlanır. Kullanımdan kaldırıldı. Bunun yerine disabled kullanın.

boolean

Çipin etkin olmayan bir durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp yoksaymadığı. Varsayılan olarak false değerine ayarlanır.

string

Erişilebilirlik için kullanılan alternatif metin.

Kullanıcılara çipin ne işe yaradığını bildiren açıklayıcı bir metin ayarlayın. Örneğin, bir çip köprüyü açıyorsa şunu yazın: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider."

object (CarouselCard)

Ruloya dahil edilen kartların listesi.

object (NestedWidget)

Bant kartında gösterilen widget'ların listesi. Widget'lar belirtildikleri sırada gösterilir.

object (NestedWidget)

Bant kartının en altında gösterilen widget listesi. Widget'lar belirtildikleri sırada gösterilir.

object (TextParagraph)

Metin paragrafı widget'ı.

object (ButtonList)

Düğme listesi widget'ı.

object (Image)

Resim widget'ı.

enum (HorizontalAlignment)

Genişletme ve daraltma düğmesinin yatay hizalaması.

object (Button)

İsteğe bağlıdır. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan kümesi dikkate alınır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

object (Button)

İsteğe bağlıdır. Bölümü daraltmak için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan kümesi dikkate alınır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

string

İşlem menüsü öğesi olarak gösterilen etiket.

object (OnClick)

Bu işlem öğesi için onClick işlemi.

object (Button)

Sabit altbilginin birincil düğmesi. Düğme, metin ve renk ayarı yapılmış bir metin düğmesi olmalıdır.

object (Button)

Sabit altbilginin ikincil düğmesi. Düğme, metin ve renk ayarı yapılmış bir metin düğmesi olmalıdır. secondaryButton ayarlanırsa primaryButton da ayarlanmalıdır.