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.

Örneğin kullanım, Form verilerini okuma konusuna bakın.

ActionParameter

İşlem parametrelerinin listesi.

LoadIndicator

Harekete geçirici mesaj yapılırken görüntülenen yükleme göstergesini belirtir.

bool

İşlemden sonra form değerlerinin kullanılmaya devam edip etmediğini belirtir. 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 özelliğini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki card_id simgesini kullanmanız gerekir.

false ise işlem tetiklendiğinde form değerleri temizlenir. İşlem işlenirken kullanıcının değişiklik yapmasını önlemek için LoadIndicator özelliğini SPINNER olarak ayarlayın.

Interaction

İsteğe bağlı. Bir iletişim kutusu açılırken gereklidir.

Bir kullanıcıyla etkileşime (ör. bir kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılması gerekenler.

Belirtilmemişse uygulama normal şekilde bir action çalıştırarak (ör. bir bağlantı açarak veya bir işlev çalıştırarak) yanıt verir.

interaction belirtildiğinde uygulama, özel etkileşimli yollarla yanıt verebilir. Örneğin, interaction uygulaması OPEN_DIALOG olarak ayarlandığında 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 ve Google Workspace Eklentileri için kullanılamaz.

string

İşlem komut dosyasına ait parametrenin 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 metnin önünde görünür.

Color

Ayarlanırsa düğme, düz bir arka plan rengiyle doldurulur ve yazı tipi rengi, arka plan rengiyle kontrastı korumak için değişir. Örneğin, mavi bir arka plan ayarlamak büyük olasılıkla beyaz metinle sonuçlanır.

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

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

İsteğe bağlı olarak, şu denklemi kullanarak şeffaflık düzeyini belirleyen alpha öğesini 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. Köprü açma veya özel bir işlev çalıştırma gibi, kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem.

bool

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

string

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

Kullanıcılara düğmenin işlevi hakkında bilgi veren açıklayıcı bir metin belirleyin. Örneğin, bir düğme köprü açıyorsa şöyle yazabilirsiniz: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat".

Button

Bir dizi düğme.

CardHeader

Kartın başlığı. Bir üstbilgi genellikle bir önde bir resim ve bir başlık içerir. Üstbilgiler her zaman kartın üst kısmında görünür.

Section

Bir widget koleksiyonu içerir. Her bölümün isteğe bağlı kendine ait bir başlığı vardır. Bölümler, çizgi ayırıcıyla görsel olarak ayrılır. Google Chat uygulamalarıyla ilgili bir örnek için Kartın bir bölümünü tanımlama başlıklı makaleyi inceleyin.

DividerStyle

Bölümler arasındaki ayırıcı stil.

CardAction

Kart işlemleri. İşlemler, kartın araç çubuğu menüsüne eklenir.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

Örneğin, aşağıdaki JSON'de Settings ve Send Feedback seçeneklerini içeren bir kart işlem menüsü oluşturulur:

"cardActions": [
  {
    "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 Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

CardFixedFooter

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

fixedFooter öğesinin bir primaryButton veya secondaryButton belirtilmeden ayarlanması hataya neden olur. Chat uygulamalarında, sabit altbilgileri iletişim kutularında kullanabilir, ancak kart mesajlarında kullanamazsınız.

Google Chat uygulamaları ve Google Workspace Eklentileri için kullanılabilir.

DisplayStyle

Google Workspace Eklentilerinde, peekCardHeader öğesinin görüntüleme özelliklerini ayarlar.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

CardHeader

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

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

string

İşlem menüsü öğesi olarak görüntülenen etiket.

OnClick

Bu işlem öğesi için onClick işlemi.

Button

Sabit altbilginin birincil düğmesi. Düğme, metni ve rengi ayarlanmış bir metin düğmesi olmalıdır.

Button

Sabit altbilginin ikincil düğmesi. Düğme, metni ve rengi ayarlanmış bir metin düğmesi olmalıdır. secondaryButton ayarlandıysa primaryButton ayarlarını da yapmanız gerekir.

string

Zorunlu. Kart başlığının başlığı. Başlığın yüksekliği sabittir: Hem başlık hem de alt başlık belirtilirse her biri bir satır yer alır. Yalnızca başlık belirtilirse başlık her iki satırı da kullanır.

string

Kart başlığının alt başlığı. Belirtilmişse title öğesinin altındaki kendi satırında görünür.

ImageType

Resmi kırpmak için kullanılan şekil.

Google Chat uygulamaları ve Google Workspace Eklentileri için 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çimindeki metinleri destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metni 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ı gösterir.

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örünmesini sağlayabilir. Kullanıcılar Daha az göster'i tıklayarak widget'ları tekrar gizleyebilir.

Hangi widget'ların gizli olduğunu belirlemek için uncollapsibleWidgetsCount değerini belirtin.

int32

Bir bölüm daraltıldığında bile görünür kalan daraltılamaz 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 üçü de varsayılan olarak daraltılır. uncollapsibleWidgetsCount, yalnızca collapsible true olduğunda dikkate alınır.

Column

Sütun dizisi. Bir karta veya iletişim kutusuna en fazla 2 sütun ekleyebilirsiniz.

HorizontalSizeStyle

Bir sütunun, kart 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 widget dizisi. Widget'lar belirtildikleri sırada 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'ı.

string

Bir form girişi etkinliğinde DateTimePicker öğesinin tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

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 bu yana milisaniye cinsinden widget'ta gösterilen varsayılan değer.

Seçici türüne (DateTimePickerType) göre değeri belirtin:

• DATE_AND_TIME: UTC saat 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: Bir saat (UTC). Örneğin, 12:00'yi temsil etmek için 43200000 (veya 12 * 60 * 60 * 1000) değerini kullanın.

int32

Saat diliminin, UTC saat dilimine dakika cinsinden uzaklığını gösteren sayı. Ayarlanırsa value_ms_epoch, belirtilen saat diliminde görüntülenir. Ayarlanmadan bırakılırsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.

Action

Kullanıcı DateTimePicker arayüzünden Kaydet veya Temizle'yi tıkladığında tetiklenir.

Icon

startIcon kullanıma yönelik olarak kullanımdan kaldırıldı.

Icon

Metnin önünde gösterilen simge.

string

text öğesinin üzerinde görünen metin. Her zaman kısaltı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 metni biçimlendirme başlıklı makaleleri inceleyin.

bool

Metni kaydırma ayarı. true ise metin kaydırılır ve birden fazla satırda gösterilir. 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 öğesinin altında görünen metin. Her zaman sarmalar.

OnClick

Bu işlem, kullanıcılar topLabel veya bottomLabel seçeneğini 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 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ılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Bir kullanıcı tarafından girilen ve form girişi etkinliğinin bir parçası olarak döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

bool

true olduğunda anahtar seçilir.

Action

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

ControlType

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

Google Chat uygulamaları ve Google Workspace Eklentileri için kullanılabilir.

Action

İstemcinin iletişim kutusu akışını sonlandırması için yapılan oluşturma işlemi.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileri için kullanılamaz.

Suggestions

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlemsiz bir şema alanıdır.

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 göre farklılık gösterir (iletişim kutusu veya tamamlayıcı).

OnClick

Bu geri çağırma, her bir ızgara öğesi tarafından yeniden kullanılır ancak geri çağırmanın parametrelerine öğe listesindeki öğenin tanımlayıcısı ve dizini eklenir.

string

Bu ızgara öğesi için kullanıcı tarafından belirtilen tanımlayıcı. Bu tanımlayıcı, üst tablonun onClick geri çağırma parametrelerinde döndürülür.

ImageComponent

Izgara öğesinde görüntülenen resim.

string

Izgara öğesinin başlığı.

string

Tablo öğ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ı. Belirtilmezse varsayılan değer olarak Button sağlanır. En iyi uygulama olarak, simgenin neyi gösterdiğine ve varsa ne yaptığına dair yararlı bir açıklama ayarlamanız 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 ayarlanırsa 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 oranında kırpma uygulamak resmin yerleşik bir simgeden daha büyük çizilmesine neden olur.

string

Google Workspace tarafından sağlanan yerleşik simgelerden birini görüntüleyin.

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

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

string

HTTPS URL'sinde barındırılan bir özel simge gösterme.

Örneğin:

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

Desteklenen dosya türleri arasında .png ve .jpg yer alır.

MaterialIcon

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

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

"materialIcon": {
  "name": "check_box"
}

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileri için kullanılamaz.

string

Görüntüyü 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

Eklentiye dönülecek bağlantının URL'si.

string

Eklentiye dönülecek bağlantının başlığı.

Card

Üçüncü taraf hizmetlerinden alınan bir bağlantıyla ilgili bilgileri gösteren kart.

string

Bağlantı önizlemesinin akıllı çipinde gösterilen başlık. Ayarlanmadan bırakılırsa akıllı çip, preview_card öğesinin üstbilgisini gösterir.

string

Bağlantı önizlemesinde gösterilen başlık. Ayarlanmadan bırakılırsa bağlantı önizlemesi, preview_card öğesinin üstbilgisini görüntüler.

string

Google Materyal Simgesi'nde tanımlanan simge adı, örneğin check_box. Geçersiz adlar belirtilmez ve boş dizeyle değiştirilir ve simgenin oluşturulamamasıyla sonuçlanır.

bool

Simgenin doldurulmuş olarak oluşturulup oluşturulmayacağı. Varsayılan değer, false (yanlış) değeridir.

Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgeleri'ne gidin ve Özelleştir bölümünden ayarları düzenleyin.

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'dür. Başka 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 bölümünden ayarları düzenleyin.

int32

Ağırlık ve derece bir simgenin kalınlığını etkiler. Notta yapılan düzenlemeler, 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'dır. Başka 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 bölümünden ayarları düzenleyin.

bool

Kart yığını, kök kart dışındaki tüm kartları çıkarır.

bool

Kart yığınında bir kart kapalı çıkar.

string

Kart yığını, belirtilen kart adına sahip tüm kartları belirtilen kartın üzerinde açar.

Card

Kart yığını, kart yığınına bir kart iter.

Card

Kart yığını, en üstteki kartı yeni bir kartla günceller ve doldurulmuş form alanları değerlerini korur. Eşdeğer olmayan bir alanda değer atlanır.

EndNavigation

İletişim kutusu akışı sonu gezinme işlemi. Daha fazla bilgi için Uygulama ana kartı mesajlarına ilişkin iletişim kutusunu yanıtlama konusuna bakın.

Google Chat uygulamalarında kullanılabilir ve Google Workspace Eklentileri için kullanılamaz.

string

Bildirimde görüntülenecek düz metin, HTML etiketleri olmadan.

Action

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

OpenLink

Belirtilirse bu onClick, bir açık bağlantı işlemini tetikler.

Action

Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde bu işlemi tetikler. Bu, yukarıdaki open_link öğesinden farklıdır. Bağlantıyı almak için sunucuyla görüşmesi gerekir. Dolayısıyla, açık bağlantı işlemi yanıtı geri gelmeden önce web istemcisinin yapması gereken bazı hazırlık çalışmaları gerekir.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

Card

Belirtilmişse, tıklandığında kart yığınına yeni bir kart aktarılır.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

string

Açılacak URL.

OpenAs

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

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

OnClose

Müşterinin bir bağlantıyı açtıktan sonra unuttuğu mu yoksa pencere kapanana kadar bağlantıyı mı gözlemlediği.

Google Workspace Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

Action

HostAppActionMarkup

Bağımsız barındırma uygulamaları tarafından gerçekleştirilen işlemler.

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlemsiz bir şema alanıdır.

Navigation

Görüntülenen kartları aktarın, açın veya güncelleyin.

OpenLink

Hedef bağlantıyı hemen yeni bir sekmede veya pop-up'ta açın.

Notification

Son kullanıcıya bildirim gösterin.

LinkPreview

Son kullanıcıya bağlantı önizlemesi gösterin.

Link

Bir Google Workspace uygulamasından oluşturulan üçüncü taraf kaynağının bağlantısı. Bir öğeye sahip nesne dizisi olarak biçimlendirilir. Daha fazla bilgi için @ menüsünden üçüncü taraf kaynakları oluşturma başlıklı makaleye bakın.

string

Bir form giriş etkinliğindeki seçim girişini tanımlayan ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcı arayüzünde seçim giriş alanının üstünde görünen metin.

Kullanıcının, uygulamanızın ihtiyacı olan bilgileri girmesine yardımcı olacak bir metin belirtin. Örneğin, kullanıcılar bir açılır menüden iş biletinin aciliyetini seçiyorsa bu etiket "Aciliyet" veya "Aciliyet seçin" olabilir.

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 bir açılır menüden yalnızca bir değer seçebilirler.

SelectionItem

Seçilebilir öğeler dizisi. Ö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. Belirtilmezse formu gönderen ayrı bir düğme belirtmeniz gerekir.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

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. Bir değer belirtilmezse varsayılan olarak 3 öğe kullanılır.

int32

Çoklu seçim menülerinde, kullanıcının uygulama sorgusundan önce girdiği metin karakteri sayısı otomatik olarak tamamlanır ve menüde önerilen öğeleri gösterir.

Belirtilmemesi halinde varsayılan olarak statik veri kaynakları için 0 karakter, harici veri kaynakları içinse 3 karakter varsayılan olur.

Action

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

PlatformDataSource

Google Workspace'ten bir veri kaynağı.

CommonDataSource

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

HostAppDataSourceMarkup

Google Chat'teki alanlar gibi Google Workspace ana makine uygulamalarına özgü veri kaynağı.

string

Öğeyi tanımlayan veya kullanıcılara açıklayan metin.

string

Bu öğeyle ilişkilendirilen değer. İstemci bunu bir form girişi değeri olarak kullanmalıdır.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

bool

Öğenin varsayılan olarak seçili olup olmadığı. Seçim girişi yalnızca 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, öğenin text alanının yanında görüntülenen simgenin URL'si. PNG ve JPEG dosyalarını destekler. Bir 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.

RenderActions

Karta bir işlem yapmasını söyleyen ve/veya eklenti ana makine uygulamasına uygulamaya özel bir işlem yapmasını söyleyen bir dizi oluşturma talimatı.

bool

Kartların durumunun değişip değişmediği ve mevcut kartlardaki verilerin eski olup olmadığı.

string

Bu, söz dizimi kontrolü için işaretlemede bulunabilecek, işlemsiz bir şema alanıdır.

SuggestionItem

Metin giriş alanlarında otomatik tamamlama önerileri için kullanılan önerilerin listesi.

string

Bir metin giriş alanı için önerilen girişin değeri. Bu, kullanıcıların kendi girişleriyle eşdeğerdir.

string

Bir form girişi etkinliğinde metin girişinin tanımlandığı ad.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

string

Kullanıcı arayüzünde, metin giriş alanının üstünde görünen metin.

Kullanıcının, uygulamanızın ihtiyacı olan bilgileri girmesine yardımcı olacak bir metin belirtin. Örneğin, birinin adını öğrenmek istiyorsanı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 ve kullanıcıların belirli bir değer girmelerini isteyerek kullanıcılara yardımcı olması amaçlanan metin. Bu metin her zaman görünür.

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

string

Bir kullanıcı tarafından girilen ve form girişi etkinliğinin bir parçası olarak döndürülen değer.

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

Type

Bir 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 yapılması gerekenler. Örneğin, bir kullanıcının alana eklemesi veya metin silmesi.

Yapılması gereken işlemlere örnek olarak özel işlev çalıştırma veya Google Chat'te iletişim kutusu açma 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. Kullanıcılar yazarken, önerilen değerler kullanıcıların yazdıklarıyla eşleşecek şekilde dinamik olarak filtrelenir.

Örneğin, programlama dili için bir metin giriş alanı; Java, JavaScript, Python ve C++ ö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 anlayabileceği değerler girmelerine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript, diğerleri java script girebilir. JavaScript önermek, kullanıcıların uygulamanızla etkileşimde bulunma şeklini standartlaştırabilir.

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

Google Chat uygulamaları ve Google Workspace Eklentileri için kullanılabilir.

Action

İsteğe bağlı. Metin giriş alanı, etkileşimde bulunan kullanıcılara öneriler sağladığında hangi işlemin yapılacağını belirtin.

Belirtilmemesi halinde ö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 Eklentileri ile kullanılabilir, Google Chat uygulamalarında kullanılamaz.

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 ve Google Workspace Eklentileri için kullanılamaz.

string

Widget'ta gösterilen metin.

HorizontalAlignment

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

TextParagraph

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

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

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

Image

Bir resim görüntüler.

Ö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üslü bir metin öğesi görüntüler.

Örneğin, aşağıdaki JSON e-posta adresini gösteren süslü 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 iki düğme oluşturur. İlki mavi bir metin düğmesi, ikincisi ise bağlantı 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 yazabileceği bir metin kutusu görüntüler.

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

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Başka bir örnek daha vermek gerekirse aşağıdaki JSON, bir programlama dili için statik öneriler içeren bir 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 öğe seçebilmesini sağlayan bir seçim denetimi 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çmesine olanak tanıyan 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 girmelerine olanak tanıyan bir widget görüntüler.

Örneğin, aşağıdaki JSON randevu planlamak için bir tarih 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 çizgi ayırıcı görüntüler.

Örneğin, aşağıdaki JSON bir ayırıcı oluşturur:

"divider": {
}

Grid

Öğe koleksiyonu içeren bir ızgara görüntüler.

Izgara, herhangi bir sayıda sütun ve öğeyi 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ütunlu bir ızgarada 5 satır bulunur. 11 öğe ve 2 sütunlu bir ızgarada 6 satır bulunur.

Google Chat uygulamaları ve Google Workspace Eklentileri için 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österilir.

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

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

"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"
          }
        }
      ]
    }
  ]
}