actions

Bununla ilgili ne yapılacağı. actions, yanıtın konusu olan ögenin yanında yer alan bir veya iki butondur: “Sepete ekle”, “Beden seç”, “Siteyi aç”. İlki, en önemli olanıdır.

Bir detay sayfasında ilki, başparmağın zaten bulunduğu mikrofonun yanında belirgin şekilde çizilir ve sayfadaki butonlar sade kalır. Bir yanıt sayfasında ise ilki birincil buton, ikincisi ise sade bir butondur.

Flutter SDK ile 0.35.0 ve Web SDK ile 0.12.0 sürümünden itibaren yerel olarak render edilir. Bunu bildirmeyen bir derlemeye asla sunulmaz.

Ne zaman kullanılmamalı

Devam edilecek sorular için kullanılmaz; bunlar quick_replies bloğudur: bir aksiyon bu ögeyle ilgili bir şey yapar, hızlı yanıt ise bir sonraki adımla ilgili bir soru sorar.

Bir onayın etrafından dolaşma yolu olarak kullanılamaz. Bir yanıt aksiyonu, kullanıcının ağzından bir şeyin yapılmasını talep eder (“Sepetime 43 numara ekle”); bu bir yazma işlemiyse Rendel bunu yine de kullanıcının kabul etmesi gereken bir confirm_card ile yanıtlar.

Props

Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.

Ağ üzerinde

{
  "id": "blk_40",
  "type": "actions",
  "fallback_text": "Add Aero Glide 2 to the cart, or choose a size.",
  "props": {
    "items": [
      { "label": "Add to cart", "icon": "bag", "action": { "kind": "reply", "text": "Add size 43 to my cart" } },
      { "label": "Choose a size", "action": { "kind": "reply", "text": "Which sizes are in stock?" } }
    ]
  }
}

Etkileşim

Bir reply, metnini kullanıcının bir sonraki mesajı olarak gönderir: bir detay sayfasında detay kapanır ve yanıt yeni bir sayfa olarak açılır. open_url ise bağlantıyı açar ve her şeyi olduğu yerde bırakır.

Bir öge, derlemenin bildirdiği herhangi bir türü taşıyabilir: navigate kaydettiğiniz bir ekranı açar (asıl amaç bir ekran açmak olduğunda screens bloğunu tercih edin), call arama ekranını açar, copy bir değeri panoya kopyalar ve add_to_calendar cihazın etkinlik düzenleyicisini açar. Sunucu, blok çıkmadan önce rotayı, numarayı, kopyalanan değeri ve takvim zamanlarını kontrol eder; başarısız olan bir blok fallback_text değeri olarak gösterilir.

Erişilebilirlik

Her buton etiketiyle seslendirilir. Simge süslemedir; etiket ne olacağını söyler.