Package google.apps.card.v1

string

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

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

ActionParameter

İşlem parametrelerinin listesi.

LoadIndicator

Eylem çağrısı yapılırken işlemin gösterildiği yükleme göstergesini belirtir.

bool

İşlemden sonra form değerlerinin kalıcı olup olmadığını gösterir. 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şlemin bulunduğu karttaki card_id metnini kullanmanız gerekir.

false ise form değerleri işlem tetiklendiğinde 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çılırken gereklidir.

Bir kullanıcıyla kurulan etkileşimlere (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak ne yapılması gerekir?

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 politikası OPEN_DIALOG değerine ayarlanırsa 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ında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

string

Bu İşlem çağrıldığında burada listelenen widget'ların bir değeri yoksa form gönderme işlemi iptal edilir.

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

bool

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

string

İşlem komut dosyası parametresinin adı.

string

Parametrenin değeri.

BorderType

Kenarlık türü.

Color

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

int32

Kenarlığın köşe yarıçapı.

string

Düğmenin içinde görüntülenen metin.

Icon

Simge resmi. Hem icon hem de text ayarlanmışsa simge metinden önce görünür.

Color

Ayarlandığında düğme düz bir arka plan rengiyle doldurulur ve arka plan rengiyle kontrastı korumak için yazı tipi rengi değişir. Örneğin, mavi bir arka plan ayarlamak muhtemelen beyaz metinle sonuçlanır.

Ayarlanmadan bırakılırsa resmin arka planı beyaz, yazı tipi rengi ise mavi olur.

Kırmızı, yeşil ve mavi için her alanın değeri, şu iki yöntemden biriyle ifade edebileceğiniz bir float sayısıdır: 0 ila 255'e bölünen bir sayı (153/255) veya 0 ile 1 (0,6) arasında bir değer. 0, renk olmadığını, 1 veya 255/255 değeri ise RGB ölçeğindeki rengin tamamını temsil eder.

İsteğe bağlı olarak, şu denklemi kullanarak bir şeffaflık düzeyi ayarlayan alpha değerini ayarlayın:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

alpha için, 1 değeri düz bir renge, 0 değeri ise tamamen şeffaf bir renge karşılık gelir.

Örneğin, aşağıdaki renk yarı şeffaf kırmızıyı temsil eder:

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

OnClick

Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel bir işlev çalıştırma).

bool

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

string

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

Kullanıcılara düğmenin ne yaptığını açıklayan açıklayıcı bir metin ayarlayın. Örneğin, bir düğme bir köprü açarsa şöyle yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici dokümanlarına gider."

Type

Düğmenin türünü belirler.

Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle 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

Widget koleksiyonu içerir. Her bölümün isteğe bağlı kendi başlığı vardır. Bölümler, çizgi ayırıcıyla görsel olarak ayrılır. Google Chat uygulamalarındaki bir örneği görmek için Kartın bir bölümünü tanımlama başlıklı makaleyi inceleyin.

DividerStyle

Bölümler 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, 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ı olarak kullanılır.

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

CardFixedFooter

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

primaryButton veya secondaryButton belirtilmeden fixedFooter politikasının ayarlanması hataya neden oluyor. Chat uygulamalarında, iletişim kutularında sabit altbilgileri kullanabilir ancak kart mesajlarını kullanamazsınız.

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

DisplayStyle

Google Workspace Eklentileri'nde, peekCardHeader öğesinin görüntüleme özelliklerini ayarlar.

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

CardHeader

Bağlamsal içerik görüntülenirken, göz atma kartı başlığı bir yer tutucu görevi görür. Böylece, kullanıcı ana sayfa kartları ile içerik kartları arasında ileri gidebilir.

Google Workspace eklentilerinde kullanılabilir, 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 renk ayarlanmış bir metin düğmesi olmalıdır.

Button

Sabit altbilginin ikincil düğmesi. Düğme, metin ve renk ayarlanmış bir metin düğmesi olmalıdır. secondaryButton ayarlanmışsa primaryButton değerini de ayarlamanız gerekir.

string

Zorunlu. Kart başlığının başlığı. Üstbilginin sabit yüksekliği vardır: Hem başlık hem de alt başlık belirtilmişse her biri bir satır kaplar. Yalnızca başlık belirtilirse her iki satırı da 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 eklentilerinde 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 üst kısmında görünen metin. Basit HTML biçimlendirilmiş metni destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni 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 bazılarını veya tümünü gizler. Ancak kullanıcılar Daha fazla göster'i tıklayarak bölümü genişleterek gizli widget'ların gösterilmesini sağlayabilir. 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ılamayan widget'ların sayısı.

Örneğin, bir bölümde beş widget varsa ve uncollapsibleWidgetsCount öğesi 2 olarak ayarlanırsa 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 ayarlanmışsa simge metinden önce görünür.

string

Çipin içinde görüntülenen metin.

OnClick

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

bool

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

bool

Çipin devre dışı durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp saymadığı. Varsayılan olarak false değerine ayarlanır.

string

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

Kullanıcılara çipin işlevini bildiren açıklayıcı bir metin belirleyin. Ö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 olmayacaktır. 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 genişlet_düğmesi hem de daraltma_düğmesi alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmayacaktır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Column

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ırayla 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 girmeyi 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 zaman diliminde takvim tarihi ve saati. Örneğin, 1 Ocak 2023 saat 12:00 (UTC) için 1672574400000 değerini kullanın.
• DATE_ONLY: 00:00:00 UTC'deki bir takvim tarihi. Örneğin, 1 Ocak 2023'ü temsil etmek için 1672531200000 değerini kullanın.
• TIME_ONLY: UTC saat diliminde. Örneğin, 12:00 değerini göstermek için 43200000 (veya 12 * 60 * 60 * 1000) değerini kullanın.

int32

Saat diliminin UTC ile farkını dakika cinsinden temsil eden sayı. Ayarlanırsa value_ms_epoch, belirtilen saat diliminde gösterilir. Ayarlanmadan bırakılırsa değer varsayılan olarak kullanıcının saat dilimi ayarına döner.

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

Kullanımdan kaldırıldı ve yerini startIcon aldı.

Icon

Metnin önünde gösterilen simge.

string

text ü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 metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

bool

Metni kaydırma ayarı. true değerine ayarlanırsa metin kaydırılır ve birden fazla satırda görüntülenir. 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 altında görünen metin. Her zaman sarmalar.

OnClick

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

Button

Kullanıcının bir işlemi tetiklemek için tıklayabileceği 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österilen bir simge.

Yerleşik ve özel simgeleri destekler.

string

Anahtar widget'ının 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ı 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ılar için Form verilerini alma başlıklı makaleye göz atın.

bool

true olduğunda anahtar seçilir.

Action

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

ControlType

Anahtarın kullanıcı arayüzünde nasıl görüneceği.

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

string

Izgara başlığında görüntülenen metin.

GridItem

Izgarada görüntülenecek öğeler.

BorderStyle

Her bir ızgara öğesine uygulanacak kenarlık stili.

int32

Izgarada görüntülenecek 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 ızgara öğesi tarafından yeniden kullanılır ancak geri çağırmanın parametrelerine eklenen öğe listesindeki öğenin tanımlayıcısı ve dizini kullanılır.

string

Bu tablo öğesi için kullanıcı tarafından belirtilen tanımlayıcı. Bu tanımlayıcı, üst ızgaranın onClick geri çağırma parametresinde 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 simgenin açıklaması. Belirtilmemişse varsayılan değer Button sağlanır. En iyi uygulama olarak, simgenin ne gösterdiği ve varsa ne yaptığı konusunda faydalı bir açıklama belirlemeniz 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 bir Button içinde ayarlanmışsa kullanıcı düğmenin üzerine geldiğinde yardımcı metin olarak altText görünür. Ancak düğme aynı zamanda text değerini de ayarlarsa simgenin altText değeri yoksayılır.

ImageType

Resme uygulanan kırpma stili. Bazı durumlarda, CIRCLE kırpma uygulamak resmin yerleşik simgeden daha büyük çizilmesine neden olur.

string

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

Örneğin, bir uçak simgesi görüntülemek için AIRPLANE değerini belirtin. Otobüs için BUS değerini belirtin.

Desteklenen simgelerin tam listesi için yerleşik simgeler konusuna bakın.

string

HTTPS URL'sinde barındırılan bir özel simge görüntüleyin.

Örneğin:

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

Desteklenen dosya türleri şunları içerir: .png ve .jpg.

MaterialIcon

Google Materyal Simgelerinden birini görüntüleyin.

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

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

Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle 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, tıklama bu işlemi tetikler.

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 terk edilir ve boş dizeyle değiştirilir. Bu da, simgenin görüntülenememesine neden olur.

bool

Simgenin doldurulmuş olarak oluşturulup oluşturulmayacağı. Varsayılan değer false'tur.

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

int32

Simgenin fırça kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Yoksa varsayılan değer 400 olur. 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 eğim, bir simgenin 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 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.

Action

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

OpenLink

Belirtilirse bu onClick açık bağlantı 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 değerinden 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, 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ında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

string

Açılacak URL.

OpenAs

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

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

OnClose

İstemcinin bir bağlantıyı açtıktan sonra unutup unutmadığı veya pencere kapanana kadar bağlantıyı gözlemleyip gözlemlemediğini belirtir.

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

OverflowMenuItem

Zorunlu. Menü seçenekleri 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 bir OverflowMenu içeremez, belirtilen herhangi bir OverflowMenu atlanır ve menü öğesi devre dışı bırakılır.

bool

Menü seçeneğinin devre dışı bırakılıp bırakılmayacağı. Varsayılan olarak yanlış değerine ayarlanır.

string

Zorunlu. Form giriş etkinliğinde seçim girişini tanımlayan 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ı arayüzünde 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" olabilir. veya "Aciliyeti seçin".

SelectionType

Bir 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 işaretleyebilir, ancak açılır menüden yalnızca bir değer seçebilir.

SelectionItem

Seçilebilir öğelerden oluşan bir dizi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. 100 adede kadar öğeyi destekler.

Action

Belirtilirse form seçim değiştiğinde gönderilir. Belirtilmemişse, formu gönderen ayrı bir düğme belirtmeniz gerekir.

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

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 uygulama sorguları otomatik olarak tamamlamadan önce girdiği metin karakteri sayısı ve menüde önerilen öğeleri gösterir.

Belirtilmemişse varsayılan olarak statik veri kaynakları için 0 karakter, harici veri kaynakları için ise 3 karakter olur.

Validation

Açılır menülerde, bu seçim giriş alanı için doğrulama.

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

Action

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

PlatformDataSource

Google Workspace'ten bir veri kaynağı.

CommonDataSource

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

HostAppDataSourceMarkup

Google Chat'teki alanlar gibi Google Workspace barındırma uygulamasına özgü bir veri kaynağıdır.

Bu alan, Google API İstemci Kitaplıklarını destekler ancak Cloud İstemci 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. İstemci bunu bir form giriş değeri olarak kullanmalıdır.

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

bool

Öğenin varsayılan olarak seçili olup olmadığı. Seçim girişi yalnızca tek bir değer kabul ediyorsa (radyo düğmeleri veya açılır menü gibi) bu alanı yalnızca bir öğe için ayarlayın.

string

Çoklu seçim menülerinde, simgenin URL'si öğenin text alanının yanında görüntülenir. 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 kendi girişleriyle 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ılar için Form verilerini alma başlıklı makaleye göz atın.

string

Kullanıcı arayüzünde 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 metni belirtin. Örneğin, bir kişinin adını soruyorsanız ancak özellikle soyadına ihtiyacınız varsa 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 metin, kullanıcılardan belirli bir değer girmelerini isteyerek onlara yardımcı olmayı amaçlar. Bu metin her zaman görünür.

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

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ılar için Form verilerini alma başlıklı makaleye göz atın.

Type

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

Action

Metin giriş alanında bir değişiklik olduğunda ne yapmak gerekir? Örneğin, bir kullanıcının alana eklemesi veya metin silmesi.

Yapmanız gereken işlemlere örnek olarak özel işlev çalıştırmak veya Google Chat'te iletişim kutusu açmak verilebilir.

Suggestions

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

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

Önerilen değerler, kullanıcıların, uygulamanızın anlamlandırabileceği değerleri girmelerine yardımcı olur. Bazı kullanıcılar JavaScript'ten bahsederken javascript ve diğerleri java script girebilir. JavaScript önererek kullanıcıların uygulamanızla etkileşim kurma biçimini standartlaştırabilirsiniz.

Bu parametre belirtildiğinde TextInput.type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

Google Chat uygulamaları ve Google Workspace eklentilerinde 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.

Belirtilirse uygulama, burada belirtilen işlemi (ör. özel bir işlev çalıştırmak) gerçekleştirir.

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

Validation

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

string

Alan boş olduğunda 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örüntülenen maksimum metin satırı sayısı. Metin belirtilen maksimum satır sayısını aşarsa fazla içerik bir daha fazla göster düğmesinin arkasına gizlenir. Metin, belirtilen maksimum satır sayısına eşit veya bundan 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 eklentilerinde kullanılabilir.

InputType

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

HorizontalAlignment

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

TextParagraph

Bir metin paragrafını görüntüler. Basit HTML biçimlendirilmiş metni destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

Örneğin, aşağıdaki JSON'de kalın bir metin oluşturulur:

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

Image

Bir görsel gösterir.

Ö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 öğesini 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 dosyası iki düğme oluşturur. İlki mavi metin düğmesi, ikincisi ise bağlantıyı açan bir resim düğmesidir:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
        "alpha": 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örüntüler.

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

"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 öğeleri seçebilmesini sağlayan bir seçim kontrolü görüntüler. 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 boyut seçmesini sağlayan 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ısı görüntüler.

Ö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, istenilen sayıda sütun ve öğe destekler. Satır sayısı, öğe sayısının üst sınırları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 ızgarada 6 satır vardır.

Google Chat uygulamaları ve Google Workspace eklentilerinde 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österir.

2'den fazla sütun eklemek veya satırları kullanmak için Grid widget'ını kullanın.

Örneğin, aşağıdaki JSON'de her biri metin paragrafları içeren 2 sütun oluşturulur:

"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

Çip listesi.

Örneğin, aşağıdaki JSON iki çip oluşturur. İlki metin çipi, ikincisi ise bağlantıyı 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ında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.