Package google.apps.card.v1

string

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

Örnek kullanım için Form verilerini okuma konusuna bakın.

ActionParameter

İşlem parametrelerinin listesi.

LoadIndicator

Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.

bool

Form değerlerinin işlemden sonra 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 değerini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için de işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki card_id metnini 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 öğesini SPINNER olarak ayarlayın.

Interaction

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

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

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

Uygulama, bir interaction belirtildiğinde özel etkileşimli yöntemlerle yanıt verebilir. Örneğin, interaction değerini OPEN_DIALOG olarak ayarlayarak 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ı için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

string

Bu iş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.

bool

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

string

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

string

Parametrenin değeri.

BorderType

Kenarlık türü.

Color

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

Satır rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine bağlı olarak 0 ile 1 arasında bir kayan sayı olmalıdır. Burada 0 (0/255) renk yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıda renk, maksimum yoğunluğunda kırmızıya ayarlanır:

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

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

int32

Kenarlık için köşe yarıçapı.

string

Düğmenin içinde gösterilen metin.

Icon

Düğmenin içinde gösterilen simge. Hem icon hem de text ayarlanırsa simge metnin önünde görünür.

Color

İsteğe bağlı. Düğmenin rengi. Bu ayar etkinleştirilirse type düğmesi FILLED olarak ayarlanır ve text ile icon alanlarının rengi, okunabilirlik için zıt bir renge ayarlanır. Örneğin, düğme rengi mavi olarak ayarlanırsa düğmedeki 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. Bu değerde 0 (0/255), rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

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

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

alpha alanı, düğme rengi için kullanılamaz. Belirtilirse bu alan yok sayılır.

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

bool

true ise düğme etkin olmayan bir durumda gösterilir ve kullanıcı işlemlerine yanıt vermez.

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ü bağlantısı 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.

Type

İsteğe bağlı. Düğmenin türü. Ayarlanmazsa 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.

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

Button

Düğme dizisi.

CardHeader

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

Section

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

DividerStyle

Üstbilgi, bölümler ve altbilgi arasındaki ayırma stili.

CardAction

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

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

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

"card_actions": [
  {
    "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 gezinmesinde kart tanımlayıcısı olarak kullanılır.

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

CardFixedFooter

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

primaryButton veya secondaryButton belirtmeden fixedFooter ayarlamak hataya neden olur. Chat uygulamalarında iletişim kutularında sabit altbilgi kullanabilirsiniz ancak kart mesajlarında kullanamazsınız.

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

DisplayStyle

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

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

CardHeader

İçeriğe dayalı içerikler gösterilirken göz atma kartı başlığı, kullanıcının ana sayfa kartları ile içeriğe dayalı kartlar arasında ileri geri gezinebilmesi için yer tutucu görevi görür.

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

string

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

OnClick

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

Button

Sabit altbilginin birincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır.

Button

Sabit altbilginin ikincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır. secondaryButton ayarlandıysa primaryButton'u da ayarlamanız gerekir.

string

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

string

Kart başlığının alt başlığı. Belirtilirse title öğesinin altında kendi satırında görünür.

ImageType

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

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

string

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

string

Bu resmin erişilebilirlik için kullanılan alternatif metni.

string

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

Widget

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

bool

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

Daraltılabilir bölümler, widget'ların bir kısmını veya tamamını gizler. Ancak kullanıcılar, Daha fazla göster'i tıklayarak gizli widget'ları görmek için bölümü genişletebilir. Kullanıcılar Daha az göster'i tıklayarak widget'ları tekrar gizleyebilir.

Gizlenen widget'ları belirlemek için uncollapsibleWidgetsCount değerini belirtin.

int32

Bir bölüm daraltıldığında bile görünür kalan daraltılamaz widget'ların sayısı.

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

CollapseControl

İsteğe bağlı. Bölümün genişlet ve daralt düğmesini tanımlayın. Bu düğme yalnızca bölüm daraltılabilir durumdaysa gösterilir. Bu alan ayarlanmazsa varsayılan düğme kullanılır. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

Icon

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

string

Çipin içinde gösterilen metin.

OnClick

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

bool

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

bool

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

string

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

Kullanıcıların çipin ne işe yaradığını bilmesini sağlayan açıklayıcı bir metin ayarlayın. Örneğin, bir çip bir köprü açarsa şunu yazın: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici dokümanlarına gider."

Layout

Belirtilen çip listesi düzeni.

Chip

Bir dizi çip.

HorizontalAlignment

Genişlet ve daralt düğmesinin yatay hizalaması.

Button

İsteğe bağlı. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. Hem genişlet_düğmesi hem de daraltma_düğmesi alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Button

İsteğe bağlı. Bölümü daraltmak için özelleştirilebilir bir düğme tanımlayın. Hem expand_button hem de collapse_button alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Column

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

HorizontalSizeStyle

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

HorizontalAlignment

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

VerticalAlignment

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

Widgets

Bir sütunda yer alan bir dizi widget. Widget'lar, belirtildikleri sırada görünür.

TextParagraph

TextParagraph widget'ı.

Image

Image widget'ı.

DecoratedText

DecoratedText widget'ı.

ButtonList

ButtonList widget'ı.

TextInput

TextInput widget'ı.

SelectionInput

SelectionInput widget'ı.

DateTimePicker

DateTimePicker widget'ı.

ChipList

ChipList widget'ı. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

string

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

Form girişleriyle çalışma hakkında ayrıntılar için Form verilerini alma başlıklı makaleye göz atın.

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.

DateTimePickerType

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

int64

Unix sıfır zamanı'ndan itibaren widget'ta gösterilen varsayılan değer (milisaniye cinsinden).

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

• DATE_AND_TIME: UTC'de bir takvim tarihi ve saati. Örneğin, 1 Ocak 2023, saat 12:00 (UTC) değerini temsil etmek için 1672574400000 değerini kullanın.
• DATE_ONLY: UTC'de 00:00:00 olan 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'yi temsil etmek için 43200000 (veya 12 * 60 * 60 * 1000) kullanın.

int32

Saat diliminin UTC ile farkını dakika cinsinden temsil eden sayı. Ayarlanırsa value_ms_epoch, belirtilen saat diliminde gösterilir. Ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.

Action

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

Validation

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

Icon

startIcon için kullanımdan kaldırıldı.

Icon

Metnin önünde gösterilen simge.

string

text öğesinin üzerinde görünen metin. Her zaman kısaltılır.

string

Zorunlu. Birincil metin.

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

bool

Metin kaydırma ayarı. 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 öğesinin altında görünen metin. Her zaman sarar.

OnClick

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

Button

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

SwitchControl

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

Icon

Metinden sonra görüntülenen bir simge.

Yerleşik ve özel simgeleri destekler.

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

bool

true olduğunda anahtar seçilir.

Action

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

ControlType

Anahtar, kullanıcı arayüzünde nasıl görünür?

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

string

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

GridItem

Izgarada gösterilecek öğeler.

BorderStyle

Her ızgara öğesine uygulanacak kenar stili.

int32

Izgarada gösterilecek 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 (iletişim kutusu veya tamamlayıcı) bağlı olarak farklılık gösterir.

OnClick

Bu geri çağırma, her bir tablo öğesi tarafından yeniden kullanılır ancak öğenin, geri çağırma parametrelerine eklenen öğeler listesindeki tanımlayıcı ve dizini ile birlikte kullanılır.

string

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

ImageComponent

Izgara öğesinde gösterilen resim.

string

Izgara öğesinin başlığı.

string

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

GridItemLayout

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

string

İsteğe bağlı. Erişilebilirlik için kullanılan simgeye dair açıklama. Belirtilmemişse varsayılan değer Button sağlanır. En iyi uygulama olarak, simgenin neyi gösterdiği ve varsa ne işe yaradığına dair yararlı bir açıklama ayarlamanız gerekir. Ö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 Button içinde ayarlanırsa kullanıcı imlecini düğmenin üzerine getirdiğ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.

ImageType

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

string

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

Örneğin, 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 .png ve .jpg'dur.

MaterialIcon

Google Material simgelerinden birini gösterin.

Örneğin, bir onay kutusu simgesi görüntülemek için

"material_icon": {
  "name": "check_box"
}

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

string

Resmi barındıran HTTPS URL'si.

Örneğin:

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

OnClick

Kullanıcı resmi tıkladığında bu işlem tetiklenir.

string

Bu resmin erişilebilirlik için kullanılan alternatif metni.

string

Resim URL'si.

string

Resmin erişilebilirlik etiketi.

ImageCropStyle

Resme uygulanacak kırpma stili.

BorderStyle

Resme uygulanacak kenarlık stili.

ImageCropType

Kırpma türü.

double

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

Örneğin, 16:9 en boy oranının nasıl uygulanacağı aşağıda açıklanmıştır:

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

string

Google Materyal Simgesi'nde tanımlanan simge adı (ör. check_box). Geçersiz adlar atlanır ve boş dizeyle değiştirilir. Bu da simgenin oluşturulamamasına neden olur.

bool

Simgenin dolu olarak oluşturulup oluşturulmayacağı. Varsayılan değer yanlıştır.

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.

int32

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

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgeleri'ne gidin ve Özelleştir altındaki ayarları yapın.

int32

Ağırlık ve sınıf, sembolün kalınlığını etkiler. Eğim ayarlamaları, ağırlıkta yapılan ayarlamalardan daha ayrıntılıdır ve simgenin boyutu üzerinde küçük bir etkisi vardır. {-25, 0, 200} arasından seçim yapın. 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 Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.

Action

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

OpenLink

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

Action

İşlemin bir bağlantıyı açması gerektiğinde eklenti bu işlemi tetikler. Bu, bağlantıyı almak için sunucuyla iletişim kurması gerektiğinden yukarıdaki open_link ile farklıdır. 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 ve Google Chat uygulamalarında kullanılamaz.

Card

Belirtilmişse yeni bir kart tıklandıktan sonra kart grubuna aktarılır.

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

OverflowMenu

Belirtilirse bu onClick, bir taşma menüsü açar. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

string

Açılacak URL.

OpenAs

Bağlantı nasıl açılır?

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

OnClose

İstemcinin, bağlantıyı açtıktan sonra bağlantıyı unutup unutmayacağını veya pencere kapanana kadar bağlantıyı gözlemleyip gözlemleyemeyeceğini belirtir.

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

OverflowMenuItem

Zorunlu. Menü seçeneklerinin listesi.

Icon

Metnin önünde gösterilen simge.

string

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

OnClick

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

bool

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

string

Zorunlu. Form girişi etkinliğindeki 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ündeki 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 açılır menüden bir iş biletinin aciliyetini seçiyorsa etiket "Aciliyet" veya "Aciliyeti seçin" olabilir.

SelectionType

SelectionInput widget'ında kullanıcılara 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 kutusunu seçebilir ancak açılır menüden yalnızca bir değer seçebilir.

SelectionItem

Seçilebilir öğe dizisi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. En fazla 100 öğeyi destekler.

Action

Belirtilen durumlarda, 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.

int32

Çoklu seçim menüleri için, bir kullanıcının seçebileceği maksimum öğe sayısı. Minimum değer 1 öğedir. Belirtilmemişse varsayılan olarak 3 öğe olur.

int32

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

Politika ayarlanmadan bırakılırsa çoklu seçim menüsü aşağıdaki varsayılan değerleri kullanır:

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

Validation

Açılır menüler için bu seçim giriş alanının doğrulaması.

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

Action

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

PlatformDataSource

Google Workspace'teki bir veri kaynağı.

CommonDataSource

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

HostAppDataSourceMarkup

Google Workspace barındıran uygulamasına (ör. Google Chat'teki alanlar) özgü bir veri kaynağı.

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

string

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

string

Bu öğeyle ilişkilendirilen değer. Müşteri bunu form giriş 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.

bool

Öğenin varsayılan olarak seçili olup olmadığı. 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üleri için öğenin text alanının yanında görüntülenen simgenin URL'si. PNG ve JPEG dosyalarını destekler. HTTPS URL'si olmalıdır. Örneğin, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

Çoklu seçim menüleri için öğenin text alanının altında görüntülenen bir metin açıklaması veya etiket.

SuggestionItem

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

string

Metin giriş alanı için önerilen bir girişin değeri. Bu, kullanıcıların kendileri girdikleri değere eşdeğerdir.

string

Metin girişinin form giriş etkinliğinde tanımlanmasını sağlayan 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 metin belirtin. Örneğin, bir kişinin adını soruyorsanız ancak özellikle soyadını öğrenmek istiyorsanız name yerine surname yazın.

hintText belirtilmediyse gereklidir. Aksi takdirde isteğe bağlıdır.

string

Metin giriş alanının altında görünen ve kullanıcılara belirli bir değer girmelerini isteyerek yardımcı olmayı amaçlayan metin. Bu metin her zaman görünür durumdadır.

label belirtilmediyse gereklidir. Aksi takdirde isteğe bağlıdır.

string

Bir kullanıcı tarafından girilen ve form girişi etkinliği kapsamında döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılar için Form verilerini alma başlıklı makaleye göz atın.

Type

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

Action

Metin giriş alanında bir değişiklik olduğunda yapılacak işlem. Örneğin, kullanıcının alana metin eklemesi veya metinleri silme işlemi.

Yapılacak işlemlere örnek olarak Google Chat'te özel işlev çalıştırma veya iletişim kutusu açma verilebilir.

Suggestions

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

Örneğin, programlama dili için bir metin giriş alanında Java, JavaScript, Python ve C++ kodu önerilebilir. Kullanıcılar Jav yazmaya başladığında, öneri filtreleri listesinde yalnızca Java ve JavaScript gösterilir.

Ö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ıları ise java script yazabilir. JavaScript önermek, kullanıcıların uygulamanızla etkileşim ş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 eklentileri için kullanılabilir.

Action

İsteğe bağlı. 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.

Belirtilen durumda uygulama, burada belirtilen işlemi (ör. özel işlev çalıştırma) gerçekleştirir.

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

Validation

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

string

Alan boşken metin giriş alanında görünen metin. Kullanıcılardan değer girmelerini istemek için bu metni kullanın. Örneğin, Enter a number from 0 to 100.

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

string

Widget'ta gösterilen metin.

int32

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

Varsayılan değer 0'dır. Bu durumda tüm bağlam gösterilir. Negatif değerler yoksayılır. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

int32

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

InputType

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

HorizontalAlignment

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

TextParagraph

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

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

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

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"
}

DecoratedText

Süslenmiş bir metin öğesi 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"
  }
}

ButtonList

Düğme listesi.

Örneğin, aşağıdaki JSON iki düğme oluşturur. Birincisi mavi metin düğmesi, ikincisi ise bağlantı açan 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"
        }
      }
    }
  ]
}

TextInput

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

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

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

Başka bir örnek olarak aşağıdaki JSON, statik önerilerle 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"
      }
    ]
  }
}

SelectionInput

Kullanıcıların öğe seçmesine olanak tanıyan bir seçim denetimi 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 beden 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
    }
  ]
}

DateTimePicker

Kullanıcıların tarih, saat veya tarih ve saat girmesine olanak tanıyan bir widget görüntüler.

Ö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"
}

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": {
}

Grid

Öğe koleksiyonu içeren bir tablo görüntüler.

Izgara, istediğiniz sayıda sütun 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 vardır. 11 öğe ve 2 sütun içeren bir tabloda 6 satır bulunur.

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

Örneğin, aşağıdaki JSON tek bir öğe içeren 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"
    }
  }
}

Columns

En fazla 2 sütun görüntülenir.

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"
          }
        }
      ]
    }
  ]
}

ChipList

Çiplerin listesi.

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

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

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