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

Class Action

Kullanıcı arayüzü öğeleri içinde etkileşim kurmayı sağlayan bir işlem. Bu işlem doğrudan Apps Komut Dosyası geri çağırma işlevini çağırır. parametresini kullanabilirsiniz.

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

var image = CardService.newImage()
    .setOnClickAction(CardService.newAction()
        .setFunctionName("handleImageClick")
        .setParameters({imageSrc: 'carImage'}));

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addRequiredWidget(requiredWidget)`	`Action`	Bu İşlemin geçerli bir gönderim için ihtiyaç duyduğu widget'ların adlarını ekler.
`setAllWidgetsAreRequired(allWidgetsAreRequired)`	`Action`	Bu İşlemin tüm widget'lardan giriş gerektirip gerektirmediğini belirtir.
`setFunctionName(functionName)`	`Action`	Çağrılacak geri çağırma işlevinin adını ayarlar.
`setInteraction(interaction)`	`Action`	Kullanıcıyla etkileşimi ayarlar. Yalnızca iletişim kutusu açılırken gereklidir.
`setLoadIndicator(loadIndicator)`	`Action`	İşlem devam ederken görüntülenen yükleme göstergesini ayarlar.
`setParameters(parameters)`	`Action`	Özel parametrelerin geri çağırma işlevine aktarılmasını sağlar.
`setPersistValues(persistValues)`	`Action`	Form değerlerinin istemcinin değerleriyle mi yoksa sunucunun değerleriyle mi belirlendiğini belirtir. yanıtından sonra formun `Card` özelliği güncellendi.

Desteği sonlandırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`setMethodName(functionName)`	`Action`

Ayrıntılı belgeler

`addRequiredWidget(requiredWidget)`

Bu İşlemin geçerli bir gönderim için ihtiyaç duyduğu widget'ların adlarını ekler. Widget'lar bu İşlem çağrıldığında bu listenin bir değeri yok, form gönderme işlemi iptal edildi.

Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileriyle kullanılamaz.

var textInput = CardService.newTextInput()
    .setFieldName("text_input_1")
    .setTitle("Text input title")

// Creates a footer button that requires an input from the above TextInput Widget.
var action = CardService.newAction()
    .setFunctionName("notificationCallback")
    .addRequiredWidget("text_input_1");
var fixedFooter =
      CardService
          .newFixedFooter()
          .setPrimaryButton(
              CardService
                  .newTextButton()
                  .setText("help")
                  .setOnClickAction(action));

Parametreler

Ad	Tür	Açıklama
`requiredWidget`	`String`	Bu İşlem için gereken widget'ın adı.

Return

Action: Zincirleme için bu nesne.

`setAllWidgetsAreRequired(allWidgetsAreRequired)`

Bu İşlemin tüm widget'lardan giriş gerektirip gerektirmediğini belirtir.

Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileriyle kullanılamaz.

// Creates a button with an action that requires inputs from all widgets.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setAllWidgetsAreRequired(true));

Parametreler

Ad	Tür	Açıklama
`allWidgetsAreRequired`	`Boolean`	İşlemin tüm widget'lardan giriş gerektirip gerektirmediği. Varsayılan değer: `false`

Return

Action: Zincirleme için bu nesne.

`setFunctionName(functionName)`

Çağrılacak geri çağırma işlevinin adını ayarlar. Zorunlu.

Parametreler

Ad	Tür	Açıklama
`functionName`	`String`	İşlevin adı. Dahil edilen kitaplıklardaki işlevleri, `Library.libFunction1` gibi.

Return

Action: Zincirleme için bu nesne.

`setInteraction(interaction)`

Kullanıcıyla etkileşimi ayarlar. Yalnızca iletişim kutusu açılırken gereklidir. Belirtilmemişse uygulama normal şekilde bağlantı açmak veya bir işlev çalıştırmak gibi bir Action yürüterek yanıt verir.

Yalnızca Google Chat uygulamalarında kullanılabilir. Google Workspace eklentileriyle kullanılamaz.

const action = CardService.newAction()
    .setFunctionName('handleDialog')
    .setInteraction(CardService.Interaction.OPEN_DIALOG);

Parametreler

Ad	Tür	Açıklama
`interaction`	`Interaction`	Belirtilecek etkileşim.

Return

Action: Zincirleme için bu nesne.

`setLoadIndicator(loadIndicator)`

İşlem devam ederken görüntülenen yükleme göstergesini ayarlar.

Parametreler

Ad	Tür	Açıklama
`loadIndicator`	`LoadIndicator`	Gösterilecek gösterge.

Return

Action: Zincirleme için bu nesne.

`setParameters(parameters)`

Özel parametrelerin geri çağırma işlevine aktarılmasını sağlar. İsteğe bağlı.

Parametreler

Ad	Tür	Açıklama
`parameters`	`Object`	Hem anahtarlar hem de değerler dize olmalıdır.

Return

Action: Zincirleme için bu nesne.

`setPersistValues(persistValues)`

Form değerlerinin istemcinin değerleriyle mi yoksa sunucunun değerleriyle mi belirlendiğini belirtir. yanıtından sonra formun Card özelliği güncellendi. true olarak ayarlandığında İstemcinin değerleri sunucu yanıtından sonra da korunur. false olarak ayarlandığında sunucunun değerleri, form değerlerinin üzerine yazar. Varsayılan olarak false değerine ayarlanır.

İstemci değerlerinin korunması, bir formun beklenmedik şekilde değiştiği durumları önlemeye yardımcı olur Kullanıcı düzenleme yaptıktan sonra. Örneğin, bir kullanıcı 24 saat sonra TextInput ancak sunucunun yanıt vermemesi gerekir. Değerler korunursa, sunucu yanıtı Card öğesini güncelledikten sonra kullanıcı tarafından yapılan değişiklikler; Aksi takdirde, form değeri kullanıcının forma ilk gönderdiği değere döner.

İstemci değerlerinin kalıcı olması, komut dosyanızın form alanlarını temizlemesini engelleyebilir veya Form değerlerini geçersiz kıldığınızdan bu tür işlevler için kalıcılığı etkinleştirmekten kaçının. Yok: sebat varsa etkinlikler için LoadIndicator.SPINNER kullanmanız önerilir. Çünkü bu işlem kullanıcı arayüzünü kilitler ve sunucu yanıt vermeden önce kullanıcıların düzenlemelerini engeller. Alternatif olarak: LoadIndicator.NONE kullanabilir ve formdaki her öğenin onChange öğesinin bulunduğundan emin olabilirsiniz eyleme dökülebilir.

// Creates a button with an action that persists the client's values as the on-click action.
const button = CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(
        CardService.newAction()
            .setPersistValues(true)
            .setFunctionName('functionName'));

Parametreler

Ad	Tür	Açıklama
`persistValues`	`Boolean`	Değerlerin sürdürülüp sürdürülmeyeceği. Varsayılan olarak `false` değerine ayarlanır.

Return

Action: Zincirleme için bu nesne.

Desteği sonlandırılan yöntemler

`setMethodName(functionName)`

Kullanımdan kaldırıldı. setFunctionName(functionName) için eski takma ad.

Parametreler

Ad	Tür	Açıklama
`functionName`	`String`	İşlevin adı. Dahil edilen kitaplıklardaki işlevleri, `Library.libFunction1` gibi.

Return

Action: Zincirleme için bu nesne.