Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class SelectionInput

Önceden tanımlanmış bir dizi seçenek arasından seçim yapmaya olanak tanıyan bir giriş alanı.

Yalnızca SelectionInputType.DROP_DOWN ve SelectionInputType.MULTI_SELECT menüleri için form gönderimi doğrulaması desteklenir. Action.setAllWidgetsAreRequired(allWidgetsAreRequired), true olarak ayarlandığında veya bu widget Action.addRequiredWidget(requiredWidget) aracılığıyla belirtildiğinde bir değer seçilmediği sürece gönderme işlemi engellenir.

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
`addDataSourceConfig(dataSourceConfig)`	`SelectionInput`	Seçim kontrolü için veri kaynağı yapılandırmalarını ayarlar.
`addEventAction(eventAction)`	`Widget`	Widget'ta gerçekleştirilebilecek etkinlik işlemini ekler.
`addItem(text, value, selected)`	`SelectionInput`	Seçilebilecek yeni bir öğe ekler.
`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`	`SelectionInput`	Çoklu seçim menüleri için seçilebilecek yeni bir öğe ekler.
`setExternalDataSource(action)`	`SelectionInput`	İlişkisel veritabanı gibi harici veri kaynağını ayarlar.
`setFieldName(fieldName)`	`SelectionInput`	Bir kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu seçim girişini tanımlayan anahtarı ayarlar.
`setId(id)`	`Widget`	Değiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Kullanıcının seçebileceği maksimum öğe sayısını ayarlar.
`setMultiSelectMinQueryLength(queryLength)`	`SelectionInput`	Uygulamanın otomatik tamamlamayı sorgulamadan ve kartta önerilen öğeleri göstermeden önce kullanıcının girdiği metin karakteri sayısını ayarlar.
`setOnChangeAction(action)`	`SelectionInput`	Seçim girişi her değiştiğinde gerçekleştirilecek bir `Action` ayarlar.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Google Workspace'ten bir veri kaynağı ayarlar.
`setTitle(title)`	`SelectionInput`	Başlığı, giriş alanının önünde gösterilecek şekilde ayarlar.
`setType(type)`	`SelectionInput`	Bu girişin türünü ayarlar.
`setVisibility(visibility)`	`Widget`	Widget'ın görünürlüğünü ayarlar.

Ayrıntılı belgeler

`addDataSourceConfig(dataSourceConfig)`

Seçim kontrolü için veri kaynağı yapılandırmalarını ayarlar. Bu alan, veri kaynağı üzerinde daha ayrıntılı kontrol sağlar. Bu alan isteğe bağlıdır.

const multiSelect =
    CardService.newSelectionInput()
        .setType(CardService.SelectionInputType.MULTI_SELECT)
        .setFieldName('contacts')
        .setTitle('Selected contacts')
        .setDataSourceConfig(
            CardService.newDataSourceConfig().setPlatformDataSource(
                CardService.newPlatformDataSource().setCommonDataSource(
                    CardService.CommonDataSource.USER,
                )
            )
        );

Parametreler

Ad	Tür	Açıklama
`dataSourceConfig`	`DataSourceConfig`	Seçim girişine uygulanacak veri kaynağı yapılandırması.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`addEventAction(eventAction)`

Widget'ta gerçekleştirilebilecek etkinlik işlemini ekler.

Parametreler

Ad	Tür	Açıklama
`eventAction`	`EventAction`	Eklenecek `EventAction`.

Return

Widget: Zincirleme için kullanılan Nesne.

`addItem(text, value, selected)`

Seçilebilecek yeni bir öğe ekler.

Parametreler

Ad	Tür	Açıklama
`text`	`Object`	Bu öğe için gösterilecek metin. Dize olmayan temel bağımsız değişkenler otomatik olarak dizelere dönüştürülür.
`value`	`Object`	Geri çağırma işlevi aracılığıyla gönderilen form giriş değeri. Dize olmayan temel bağımsız değişkenler otomatik olarak dizelere dönüştürülür.
`selected`	`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.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`

Çoklu seçim menüleri 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 temel bağımsız değişkenler otomatik olarak dizelere dönüştürülür.
`value`	`Object`	Geri çağırma işlevi aracılığıyla gönderilen form giriş değeri. Dize olmayan temel bağımsız değişkenler otomatik olarak dizelere dönüştürülür.
`selected`	`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.
`startIconUri`	`Object`	Çoklu seçim menülerinde, öğenin metin alanının yanında gösterilen simgenin URL'si. PNG ve JPEG dosyalarını destekler.
`bottomText`	`Object`	Çoklu seçim menülerinde, öğenin metin alanının altında gösterilen bir metin açıklaması veya etiket.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setExternalDataSource(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

SelectionInput: Zincirleme için kullanılan bu nesne.

`setFieldName(fieldName)`

Bir 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ülmez. Zorunludur ve benzersiz olmalıdır.

Parametreler

Ad	Tür	Açıklama
`fieldName`	`String`	Bu girişe atanacak ad.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setId(id)`

Değiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar. Widget mutasyonu yalnızca eklentilerde desteklenir.

Parametreler

Ad	Tür	Açıklama
`id`	`String`	64 karakterle sınırlı ve `[a-zA-Z0-9-]+` biçiminde olan widget'ın kimliği.

Return

Widget: Zincirleme için kullanılan bu nesne.

`setMultiSelectMaxSelectedItems(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
`maxSelectedItems`	`Integer`	Maksimum öğe sayısı.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setMultiSelectMinQueryLength(queryLength)`

Uygulamanın otomatik tamamlamayı sorgulamadan ve kartta önerilen öğeleri göstermeden önce kullanıcının girdiği metin karakteri 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
`queryLength`	`Integer`	Metin karakterlerinin sayısı.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setOnChangeAction(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

SelectionInput: Zincirleme için kullanılan bu nesne.

`setPlatformDataSource(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,
                ),
        );

Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileri için kullanılamaz.

Parametreler

Ad	Tür	Açıklama
`platformDataSource`	`PlatformDataSource`	Veri kaynağı.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setTitle(title)`

Başlığı, giriş alanının önünde gösterilecek şekilde ayarlar.

Parametreler

Ad	Tür	Açıklama
`title`	`String`	Giriş alanı başlığı.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setType(type)`

Bu girişin türünü ayarlar. Varsayılan olarak CHECKBOX değerine ayarlanır.

Parametreler

Ad	Tür	Açıklama
`type`	`SelectionInputType`	Seçim türü.

Return

SelectionInput: Zincirleme için kullanılan bu nesne.

`setVisibility(visibility)`

Widget'ın görünürlüğünü ayarlar. Varsayılan değer "VISIBLE"dır.

Parametreler

Ad	Tür	Açıklama
`visibility`	`Visibility`	Widget'ın `Visibility`.

Return

Widget: Zincirleme için kullanılan Nesne.

Class SelectionInput Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yöntemler

Ayrıntılı belgeler

addDataSourceConfig(dataSourceConfig)

Parametreler

Return

addEventAction(eventAction)

Parametreler

Return

addItem(text, value, selected)

Parametreler

Return

addMultiSelectItem(text, value, selected, startIconUri, bottomText)

Parametreler

Return

setExternalDataSource(action)

Parametreler

Return

setFieldName(fieldName)

Parametreler

Return

setId(id)

Parametreler

Return

setMultiSelectMaxSelectedItems(maxSelectedItems)

Parametreler

Return

setMultiSelectMinQueryLength(queryLength)

Parametreler

Return

setOnChangeAction(action)

Parametreler

Return

setPlatformDataSource(platformDataSource)

Parametreler

Return

setTitle(title)

Parametreler

Return

setType(type)

Parametreler

Return

setVisibility(visibility)

Parametreler

Return

Class SelectionInput

`addDataSourceConfig(dataSourceConfig)`

`addEventAction(eventAction)`

`addItem(text, value, selected)`

`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`

`setExternalDataSource(action)`

`setFieldName(fieldName)`

`setId(id)`

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

`setMultiSelectMinQueryLength(queryLength)`

`setOnChangeAction(action)`

`setPlatformDataSource(platformDataSource)`

`setTitle(title)`

`setType(type)`

`setVisibility(visibility)`