Önceden tanımlanmış seçenekler arasından seçim yapmanıza olanak tanıyan bir giriş alanı.
Google Workspace eklentileri ve Google Chat uygulamaları için kullanılabilir.
const checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setTitle('A group of checkboxes. Multiple selections are allowed.') .setFieldName('checkbox_field') .addItem('checkbox one title', 'checkbox_one_value', false) .addItem('checkbox two title', 'checkbox_two_value', true) .addItem('checkbox three title', 'checkbox_three_value', true) .setOnChangeAction( CardService.newAction().setFunctionName('handleCheckboxChange'), ); const radioGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.RADIO_BUTTON) .setTitle( 'A group of radio buttons. Only a single selection is allowed.') .setFieldName('checkbox_field') .addItem('radio button one title', 'radio_one_value', true) .addItem('radio button two title', 'radio_two_value', false) .addItem('radio button three title', 'radio_three_value', false); const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('multiselect') .setTitle('A multi select input example.') .addMultiSelectItem( 'Contact 1', 'contact-1', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact one description', ) .addMultiSelectItem( 'Contact 2', 'contact-2', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact two description', ) .addMultiSelectItem( 'Contact 3', 'contact-3', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact three description', ) .addMultiSelectItem( 'Contact 4', 'contact-4', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact four description', ) .addMultiSelectItem( 'Contact 5', 'contact-5', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact five description', ) .setMultiSelectMaxSelectedItems(3) .setMultiSelectMinQueryLength(1);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
add | Selection | Seçilebilen yeni bir öğe ekler. |
add | Selection | Birden fazla seçim yapılabilen menüler için seçilebilecek yeni bir öğe ekler. |
set | Selection | İlişkisel veritabanı gibi harici veri kaynağını ayarlar. |
set | Selection | Kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçim girişini tanımlayan anahtarı ayarlar. |
set | Selection | Kullanıcının seçebileceği maksimum öğe sayısını ayarlar. |
set | Selection | Uygulamanın otomatik tamamlama sorgusu gönderip kartta önerilen öğeleri göstermeden önce kullanıcının gireceği metin karakterlerinin sayısını ayarlar. |
set | Selection | Seçim girişi her değiştiğinde gerçekleştirilecek bir Action ayarlar. |
set | Selection | Google Workspace'ten bir veri kaynağı ayarlar. |
set | Selection | Giriş alanının önünde gösterilecek başlığı ayarlar. |
set | Selection | Bu girişin türünü ayarlar. |
Ayrıntılı dokümanlar
add Item(text, value, selected)
Seçilebilen yeni bir öğe ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | Object | Bu öğe için gösterilecek metin. Dize olmayan ilkel bağımsız değişkenler otomatik olarak dizeye dönüştürülür. |
value | Object | Geri çağırma işlevi aracılığıyla gönderilen form giriş değeri. Dize olmayan ilkel bağımsız değişkenler otomatik olarak dizelere dönüştürülür. |
selected | Boolean | Öğ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. |
Return
Selection
: Zincirleme için bu nesne.
add Multi Select Item(text, value, selected, startIconUri, bottomText)
Birden fazla seçim yapılabilen menüler için seçilebilecek yeni bir öğe ekler.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('multiselect') .setTitle('A multi select input example.') .addMultiSelectItem( 'Contact 1', 'contact-1', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact one description', ) .addMultiSelectItem( 'Contact 2', 'contact-2', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact two description', ) .addMultiSelectItem( 'Contact 3', 'contact-3', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact three description', ) .addMultiSelectItem( 'Contact 4', 'contact-4', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact four description', ) .addMultiSelectItem( 'Contact 5', 'contact-5', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact five description', );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | Object | Bu öğe için gösterilecek metin. Dize olmayan ilkel bağımsız değişkenler otomatik olarak dizeye dönüştürülür. |
value | Object | Geri çağırma işlevi aracılığıyla gönderilen form giriş değeri. Dize olmayan ilkel bağımsız değişkenler otomatik olarak dizelere dönüştürülür. |
selected | Boolean | Öğ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. |
start | Object | Çoklu seçim menüleri için öğenin metin alanının yanında görüntülenen simgeye ait URL. PNG ve JPEG dosyalarını destekler. |
bottom | Object | Çoklu seçim menüleri için öğenin metin alanının altında görüntülenen metin açıklaması veya etiket. |
Return
Selection
: Zincirleme için bu nesne.
set External Data Source(action)
İlişkisel veritabanı gibi harici veri kaynağını ayarlar.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('contacts') .setTitle('Selected contacts') .addMultiSelectItem( 'Contact 3', 'contact-3', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact three description', ) .setMultiSelectMaxSelectedItems(5) .setMultiSelectMinQueryLength(2) .setExternalDataSource( CardService.newAction().setFunctionName('getContacts'), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Harici veri kaynağı. |
Return
Selection
: Zincirleme için bu nesne.
set Field Name(fieldName)
Kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçim girişini tanımlayan anahtarı ayarlar. Kullanıcı tarafından görülemez. Zorunlu, benzersiz olmalıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
field | String | Bu girişe atanacak ad. |
Return
Selection
: Zincirleme için bu nesne.
set Multi Select Max Selected Items(maxSelectedItems)
Kullanıcının seçebileceği maksimum öğe sayısını ayarlar.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('multiselect') .setTitle('A multi select input example.') .setMultiSelectMaxSelectedItems(3) .addMultiSelectItem( 'Contact 1', 'contact-1', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact one description', ) .addMultiSelectItem( 'Contact 2', 'contact-2', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact two description', ) .addMultiSelectItem( 'Contact 3', 'contact-3', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact three description', ) .addMultiSelectItem( 'Contact 4', 'contact-4', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact four description', ) .addMultiSelectItem( 'Contact 5', 'contact-5', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact five description', );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
max | Integer | Maksimum öğe sayısı. |
Return
Selection
: Zincirleme için bu nesne.
set Multi Select Min Query Length(queryLength)
Uygulamanın otomatik tamamlama sorgusu gönderip kartta önerilen öğeleri göstermeden önce kullanıcının gireceği metin karakterlerinin sayısını ayarlar.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('multiselect') .setTitle('A multi select input example.') .setMultiSelectMinQueryLength(1) .addMultiSelectItem( 'Contact 1', 'contact-1', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact one description', ) .addMultiSelectItem( 'Contact 2', 'contact-2', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact two description', ) .addMultiSelectItem( 'Contact 3', 'contact-3', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact three description', ) .addMultiSelectItem( 'Contact 4', 'contact-4', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact four description', ) .addMultiSelectItem( 'Contact 5', 'contact-5', false, 'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png', 'Contact five description', );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
query | Integer | Metin karakterlerinin sayısı. |
Return
Selection
: Zincirleme için bu nesne.
set On Change Action(action)
Seçim girişi her değiştiğinde gerçekleştirilecek bir Action
ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
action | Action | Yapılacak işlem. |
Return
Selection
: Zincirleme için bu nesne.
set Platform Data Source(platformDataSource)
Google Workspace'ten bir veri kaynağı ayarlar. Çoklu seçim menüsündeki öğeleri doldurmak için kullanılır.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('contacts') .setTitle('Selected contacts') .setPlatformDataSource( CardService.newPlatformDataSource().setCommonDataSource( CardService.CommonDataSource.USER, ), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
platform | Platform | Veri kaynağı. |
Return
Selection
: Zincirleme için bu nesne.
set Title(title)
Giriş alanının önünde gösterilecek başlığı ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Giriş alanı başlığı. |
Return
Selection
: Zincirleme için bu nesne.
set Type(type)
Bu girişin türünü ayarlar. Varsayılan olarak CHECKBOX
değerine ayarlanır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
type | Selection | Seçim türü. |
Return
Selection
: Zincirleme için bu nesne.