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

Package google.apps.card.v1

Dizin

Action (message)
Action.ActionParameter (message)
Action.Interaction (enum)
Action.LoadIndicator (enum)
BorderStyle (message)
BorderStyle.BorderType (enum)
Button (message)
Button.Type (enum)
ButtonList (message)
Card (message)
Card.CardAction (message)
Card.CardFixedFooter (message)
Card.CardHeader (message)
Card.DisplayStyle (enum)
Card.DividerStyle (enum)
Card.Section (message)
Chip (message)
ChipList (message)
ChipList.Layout (enum)
CollapseControl (message)
Columns (message)
Columns.Column (message)
Columns.Column.HorizontalSizeStyle (enum)
Columns.Column.VerticalAlignment (enum)
Columns.Column.Widgets (message)
DateTimePicker (message)
DateTimePicker.DateTimePickerType (enum)
DecoratedText (message)
DecoratedText.SwitchControl (message)
DecoratedText.SwitchControl.ControlType (enum)
Divider (message)
EndNavigation (message)
EndNavigation.Action (enum)
GetAutocompletionResponse (message)
Grid (message)
Grid.GridItem (message)
Grid.GridItem.GridItemLayout (enum)
Icon (message)
Image (message)
ImageComponent (message)
ImageCropStyle (message)
ImageCropStyle.ImageCropType (enum)
Link (message)
LinkPreview (message)
MaterialIcon (message)
Navigation (message)
Notification (message)
OnClick (message)
OpenLink (message)
OpenLink.OnClose (enum)
OpenLink.OpenAs (enum)
OverflowMenu (message)
OverflowMenu.OverflowMenuItem (message)
RenderActions (message)
RenderActions.Action (message)
SelectionInput (message)
SelectionInput.PlatformDataSource (message)
SelectionInput.PlatformDataSource.CommonDataSource (enum)
SelectionInput.SelectionItem (message)
SelectionInput.SelectionType (enum)
SubmitFormResponse (message)
Suggestions (message)
Suggestions.SuggestionItem (message)
TextInput (message)
TextInput.Type (enum)
TextParagraph (message)
Validation (message)
Validation.InputType (enum)
Widget (message)
Widget.HorizontalAlignment (enum)
Widget.ImageType (enum)

İşlem

Form gönderilirken davranışı açıklayan bir işlem. Örneğin, formu işlemek için bir Apps Komut Dosyası'nı çağırabilirsiniz. İşlem tetiklenirse form değerleri sunucuya gönderilir.

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

Alanlar
`function`	`string` İçerdiği öğe tıklandığında veya başka bir şekilde etkinleştirildiğinde çağrılacak özel işlev. Örnek kullanım için Form verilerini okuma başlıklı makaleyi inceleyin.
`parameters[]`	`ActionParameter` İşlem parametrelerinin listesi.
`loadIndicator`	`LoadIndicator` Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.
`persistValues`	`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şlemi içeren karttaki `card_id` metnini 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` öğesini `SPINNER` olarak ayarlayın.
`interaction`	`Interaction` İsteğe bağlı. İletişim kutusu açarken 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` değerini `OPEN_DIALOG` olarak ayarlayarak uygulama bir iletişim kutusu açabilir. Belirtilen durumlarda 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.
`requiredWidgets[]`	`string` Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir. İsteğe bağlı. Bu listeyi, geçerli bir gönderim için bu işlemin ihtiyaç duyduğu widget'ların adlarıyla doldurun. 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 eklentileri için kullanılabilir.
`allWidgetsAreRequired`	`bool` Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizlemesi Programı kapsamında kullanılabilir. İsteğe bağlı. Bu durumda, bu işlem tüm widget'ların gerekli olduğu kabul edilir. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

ActionParameter

İşlem yöntemi çağrıldığında sağlanacak dize parametrelerinin listesi. Örneğin, şu üç erteleme düğmesini kullanabilirsiniz: şimdi ertele, bir gün ertele veya sonraki hafta ertele. Dize parametreleri listesinde erteleme türünü ve erteleme süresini iletmek için action method = snooze() kullanabilirsiniz.

Daha fazla bilgi için CommonEventObject sayfasına bakın.

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

Alanlar

Alanlar
`key`	`string` İşlem komut dosyası parametresinin adı.
`value`	`string` Parametrenin değeri.

key

string

İşlem komut dosyası parametresinin adı.

value

string

Parametrenin değeri.

Etkileşim

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

Kullanıcıyla etkileşime (ör. kullanıcının kart mesajındaki bir düğmeyi tıklaması) yanıt olarak yapılacak işlem.

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

Sıralamalar

INTERACTION_UNSPECIFIED Varsayılan değer. action normal şekilde çalışır.

Sıralamalar
`INTERACTION_UNSPECIFIED`	Varsayılan değer. `action` normal şekilde çalışır.
`OPEN_DIALOG`	Chat uygulamalarının kullanıcılarla etkileşimde bulunmak için kullandığı pencereli, kart tabanlı bir arayüz olan iletişim kutusunu açar. Yalnızca kart mesajlarındaki düğme tıklamalarına yanıt olarak Chat uygulamaları tarafından desteklenir. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

OPEN_DIALOG

Chat uygulamalarının kullanıcılarla etkileşimde bulunmak için kullandığı pencereli, kart tabanlı bir arayüz olan iletişim kutusunu açar.

Yalnızca kart mesajlarındaki düğme tıklamalarına yanıt olarak Chat uygulamaları tarafından desteklenir. Bir eklenti için belirtilirse kartın tamamı kaldırılır ve istemcide hiçbir şey gösterilmez.

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

LoadIndicator

Harekete geçirici mesajı çağırırken işlemin görüntülediği yükleme göstergesini belirtir.

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

Sıralamalar
`SPINNER`	İçeriğin yüklendiğini göstermek için bir döner simge görüntüler.
`NONE`	Hiçbir şey gösterilmez.

BorderStyle

Kenarlık türü ve rengi dahil olmak üzere bir kartın veya widget'ın kenarlığı için stil seçenekleri.

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

Alanlar

Alanlar
`type`	`BorderType` Kenarlık türü.
`strokeColor`	`Color` Tür `BORDER_TYPE_STROKE` olduğunda kullanılacak renkler. Satır rengini ayarlamak için `red`, `green` ve `blue` alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Bu değerde `0` (0/255), rengin yokluğunu, `1` (255/255) ise rengin maksimum yoğunluğunu temsil eder. Örneğin, aşağıdaki ifade rengi maksimum yoğunlukta kırmızı olarak ayarlar: `"color": { "red": 1, "green": 0, "blue": 0, }` `alpha` alanı, fırça rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.
`cornerRadius`	`int32` Kenarlığın köşe yarıçapı.

type

BorderType

Kenarlık türü.

strokeColor

Color

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

Satır rengini ayarlamak için red, green ve blue alanları için bir değer belirtin. Değer, RGB renk değerine göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Bu değerde 0 (0/255), rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıdaki ifade rengi maksimum yoğunlukta kırmızı olarak ayarlar:

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

alpha alanı, fırça rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.

cornerRadius

int32

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

BorderType

Widget'lara uygulanan kenar türünü temsil eder.

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

Sıralamalar
`BORDER_TYPE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`NO_BORDER`	Varsayılan değer. Kenarlık yok.
`STROKE`	Özet.

Düğme

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge düğmesi. Google Chat uygulamalarıyla ilgili bir örnek için Düğme ekleme başlıklı makaleyi inceleyin.

Bir resmi tıklanabilir bir düğme yapmak için Image (ImageComponent değil) belirtin ve onClick işlemini ayarlayın.

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

Alanlar
`text`	`string` Düğmenin içinde görüntülenen metin.
`icon`	`Icon` Düğmenin içinde bir simge görüntülenir. Hem `icon` hem de `text` ayarlanırsa simge metnin önünde görünür.
`color`	`Color` İsteğe bağlı. Düğmenin rengi. Ayarlanırsa `type` düğmesi `FILLED` olarak ayarlanır ve `text` ile `icon` alanlarının rengi, okunabilirlik için zıt bir renge ayarlanır. Örneğin, düğme rengi mavi olarak ayarlanırsa düğmedeki metinler veya simgeler beyaz olarak ayarlanır. Düğme rengini ayarlamak için `red`, `green` ve `blue` alanları için bir değer belirtin. Değer, RGB renk değerine bağlı olarak 0 ile 1 arasında bir kayan sayı olmalıdır. Burada `0` (0/255) renk yokluğunu, `1` (255/255) ise rengin maksimum yoğunluğunu temsil eder. Örneğin, aşağıdaki ifade rengi maksimum yoğunlukta kırmızı olarak ayarlar: `"color": { "red": 1, "green": 0, "blue": 0, }` `alpha` alanı, düğme rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.
`onClick`	`OnClick` Zorunlu. Kullanıcı düğmeyi tıkladığında gerçekleştirilecek işlem (ör. köprü açma veya özel işlev çalıştırma).
`disabled`	`bool` `true` ise düğme etkin olmayan bir durumda gösterilir ve kullanıcı işlemlerine yanıt vermez.
`altText`	`string` Erişilebilirlik için kullanılan alternatif metin. Kullanıcılara düğmenin ne işe yaradığını bildiren 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`	`Type` İsteğe bağlı. Düğmenin türü. Ayarlanmadan bırakılırsa düğme türü varsayılan olarak `OUTLINED` olur. `color` alanı ayarlanırsa düğme türü `FILLED` değerine zorlanır ve bu alan için ayarlanan herhangi bir değer yoksayılır. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

Tür

İsteğe bağlı. Düğmenin türü. color alanı ayarlanırsa type, FILLED değerine zorlanır.

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

Sıralamalar
`TYPE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`OUTLINED`	Dış çizgili düğmeler, orta düzeyde vurgulu düğmelerdir. Bunlar genellikle önemli olan ancak Chat uygulamasında veya eklentisinde birincil işlem olmayan işlemleri içerir.
`FILLED`	Doldurulmuş düğmelerde düz renkli bir kapsayıcı bulunur. En fazla görsel etkiye sahiptir ve Chat uygulamasında veya eklentisinde önemli ve birincil işlem için önerilir.
`FILLED_TONAL`	Doldurulmuş tonlu düğme, doldurulmuş ve kenarlıklandırılmış düğmeler arasında alternatif bir orta yoldur. Bu düğmeler, düşük öncelikli düğmenin anahat düğmesinden biraz daha fazla vurgu gerektirdiği durumlarda kullanışlıdır.
`BORDERLESS`	Bir düğmenin varsayılan durumunda görünmez bir kapsayıcısı yoktur. Genellikle en düşük önceliğe sahip işlemler için, özellikle de birden fazla seçenek sunulduğunda kullanılır.

ButtonList

Yatay olarak düzenlenmiş düğmelerin listesi. Google Chat uygulamalarında örnek için Düğme ekleme bölümüne bakın.

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

Alanlar

Alanlar
`buttons[]`	`Button` Düğme dizisi.

buttons[]

Button

Düğme dizisi.

Kart

Google Chat mesajında veya Google Workspace eklentisinde gösterilen kart arayüzü.

Kartlar; tanımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve rich media öğelerini (ör. resim) destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma yönlendirmek için kartlardan yararlanın.

Kart Oluşturucu ile kartları tasarlayın ve önizleyin.

Kart Oluşturucu'yu açın

Kart oluşturmayı öğrenmek için aşağıdaki dokümanlara göz atın:

Google Chat uygulamaları için Kart veya iletişim kutusunun bileşenlerini tasarlama başlıklı makaleyi inceleyin.
Google Workspace eklentileri için Kart tabanlı arayüzler başlıklı makaleyi inceleyin.

Örnek: Google Chat uygulaması için kart mesajı

Örnek kişi kartı

Google Chat'te örnek kart mesajını oluşturmak için aşağıdaki JSON'u kullanın:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "[email protected]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}

Alanlar
`header`	`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.
`sections[]`	`Section` Widget koleksiyonu içerir. Her bölümün isteğe bağlı bir başlığı vardır. Bölümler, görsel olarak bir çizgiyle 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.
`sectionDividerStyle`	`DividerStyle` Başlık, bölümler ve alt bilgi arasındaki ayırıcı stili.
`cardActions[]`	`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: `"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" } } } ]`
`name`	`string` Kartın adı. Kart gezinmesinde kart tanımlayıcı olarak kullanılır. Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.
`fixedFooter`	`CardFixedFooter` Bu kartın alt kısmında gösterilen sabit altbilgi. `primaryButton` veya `secondaryButton` belirtmeden `fixedFooter` ayarlamak hataya neden olur. Chat uygulamalarında, iletişim kutularında sabit altbilgileri kullanabilir ancak kart mesajlarını kullanamazsınız. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
`displayStyle`	`DisplayStyle` Google Workspace eklentilerinde `peekCardHeader` öğesinin görüntüleme özelliklerini belirler. Google Workspace eklentilerinde kullanılabilir, Google Chat uygulamalarında kullanılamaz.
`peekCardHeader`	`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 ve Google Chat uygulamalarında kullanılamaz.

CardAction

Kart işlemi, kartla ilişkili işlemdir. Örneğin, bir fatura kartı; faturayı silme, faturayı e-postayla gönderme veya faturayı bir tarayıcıda açma gibi işlemleri içerebilir.

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

Alanlar

Alanlar
`actionLabel`	`string` İşlem menüsü öğesi olarak görüntülenen etiket.
`onClick`	`OnClick` Bu işlem öğesi için `onClick` işlemi.

actionLabel

string

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

onClick

OnClick

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

CardFixedFooter

Kartın alt kısmında görünen kalıcı (yapışkan) bir 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ıyla ilgili bir örnek için Kalıcı altbilgi ekleme başlıklı makaleyi inceleyin.

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

Alanlar

Alanlar
`primaryButton`	`Button` Sabit altbilginin birincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır.
`secondaryButton`	`Button` Sabit altbilginin ikincil düğmesi. Düğme, metin ve renk ayarlanmış bir metin düğmesi olmalıdır. `secondaryButton` ayarlandıysa `primaryButton`'u da ayarlamanız gerekir.

primaryButton

Button

Sabit altbilginin birincil düğmesi. Düğme, metin ve rengin ayarlandığı bir metin düğmesi olmalıdır.

secondaryButton

Button

Sabit altbilginin ikincil düğmesi. Düğme, metin ve renk ayarlanmış bir metin düğmesi olmalıdır. secondaryButton ayarlandıysa primaryButton'u da ayarlamanız gerekir.

CardHeader

Kart başlığını temsil eder. Google Chat uygulamalarında bir örnek için Başlık ekleme bölümüne bakın.

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

Alanlar
`title`	`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 kaplar. Yalnızca başlık belirtilirse her iki satır da başlığı kaplar.
`subtitle`	`string` Kart başlığının alt başlığı. Belirtilirse `title` öğesinin altında kendi satırında görünür.
`imageType`	`ImageType` Resmi kırpmak için kullanılan şekil. Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
`imageUrl`	`string` Kart başlığındaki resmin HTTPS URL'si.
`imageAltText`	`string` Bu resmin erişilebilirlik için kullanılan alternatif metni.

DisplayStyle

Google Workspace Eklentileri'nde bir kartın nasıl gösterileceğini belirler.

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

Sıralamalar
`DISPLAY_STYLE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`PEEK`	Kartın başlığı, kenar çubuğunun alt kısmında görünür ve grubun mevcut üst kartını kısmen kapatır. Başlığı tıkladığınızda kart, kart yığınına eklenir. Kartta başlık yoksa bunun yerine oluşturulmuş bir başlık kullanılır.
`REPLACE`	Varsayılan değer. Kart, kart grubundaki en üstteki kartın görünümü değiştirilerek gösterilir.

DividerStyle

Kartın ayırıcı stili. Şu anda yalnızca kart bölümleri arasında ayırıcılar için kullanılır.

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

Sıralamalar
`DIVIDER_STYLE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`SOLID_DIVIDER`	Varsayılan seçenektir. Güçlü bir ayırıcı oluşturun.
`NO_DIVIDER`	Ayarlanırsa ayırıcı oluşturulmaz. Bu stil, ayırıcıyı düzenden tamamen kaldırır. Sonuç, hiç ayırıcı eklememekle eşdeğerdir.

Bölüm

Bölüm, belirtildikleri sırayla dikey olarak oluşturulan bir widget koleksiyonu içerir.

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

Alanlar
`header`	`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 metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.
`widgets[]`	`Widget` Bölümdeki tüm widget'lar. En az bir widget içermelidir.
`collapsible`	`bool` Bu bölümün daraltılabilir olup olmadığını belirtir. Daraltılabilir bölümler, widget'ların bir kısmını veya tamamını gizler. Ancak kullanıcılar, Daha fazla göster'i tıklayarak gizli widget'ları görmek için bölümü genişletebilir. Kullanıcılar Daha az göster'i tıklayarak widget'ları tekrar gizleyebilir. Gizlenen widget'ları belirlemek için `uncollapsibleWidgetsCount` değerini belirtin.
`uncollapsibleWidgetsCount`	`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üm beş widget içeriyorsa ve `uncollapsibleWidgetsCount`, `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`	`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.

Çip

Kullanıcıların tıklayabileceği bir metin, simge veya metin ve simge çipi.

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

Alanlar
`icon`	`Icon` Simge resmi. Hem `icon` hem de `text` ayarlanmışsa simge metinden önce görünür.
`label`	`string` Çipin içinde görüntülenen metin.
`onClick`	`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).
`enabled (deprecated)`	`bool` Bu öğenin desteği sonlandırıldı. Çipin etkin durumda olup olmadığını ve kullanıcı işlemlerine yanıt verip vermediğini belirtir. Varsayılan olarak `true` değerine ayarlanır. Kullanımdan kaldırıldı. Bunun yerine `disabled` politikasını kullanın.
`disabled`	`bool` Çipin devre dışı durumda olup olmadığı ve kullanıcı işlemlerini yoksayıp saymadığı. Varsayılan olarak `false` değerine ayarlanır.
`altText`	`string` Erişilebilirlik için kullanılan alternatif metin. Kullanıcılara çipin ne işe yaradığını gösteren açıklayıcı bir metin ayarlayın. Örneğin, bir çip köprü açıyorsa şunu yazın: "Yeni bir tarayıcı sekmesi açar ve https://developers.google.com/workspace/chat" adresindeki Google Chat geliştirici belgelerine gider.

ChipList

Yatay olarak yerleştirilmiş çiplerin listesi. Bu liste yatay olarak kaydırılabilir veya bir sonraki satıra sarılabilir.

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

Alanlar

Alanlar
`layout`	`Layout` Belirtilen çip listesi düzeni.
`chips[]`	`Chip` Bir çip dizisi.

layout

Layout

Belirtilen çip listesi düzeni.

chips[]

Chip

Bir çip dizisi.

Düzen

Çip listesi düzeni.

Sıralamalar
`LAYOUT_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`WRAPPED`	Varsayılan değer. Yeterli yatay alan yoksa çip listesi bir sonraki satıra kaydırılır.
`HORIZONTAL_SCROLLABLE`	Kullanılabilir alana sığmayan çipler yatay olarak kaydırılır.

CollapseControl

Genişletme ve daraltma kontrolünü temsil eder. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

Alanlar

Alanlar
`horizontalAlignment`	`HorizontalAlignment` Genişlet ve daralt düğmesinin yatay hizalaması.
`expandButton`	`Button` İsteğe bağlı. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. HemexpandButton hem expandButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmayacaktır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.
`collapseButton`	`Button` İsteğe bağlı. Bölümü daraltmak için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

horizontalAlignment

HorizontalAlignment

Genişlet ve daralt düğmesinin yatay hizalaması.

expandButton

Button

İsteğe bağlı. Bölümü genişletmek için özelleştirilebilir bir düğme tanımlayın. HemexpandButton hem expandButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmayacaktır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

collapseButton

Button

İsteğe bağlı. Bölümü daraltmak için özelleştirilebilir bir düğme tanımlayın. Hem expandButton hem de collapseButton alanı ayarlanmalıdır. Yalnızca bir alan grubu geçerli olmaz. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

Sütunlar

Columns widget'ı, bir kartta veya iletişim kutusunda en fazla 2 sütun gösterir. Her bir sütuna widget ekleyebilirsiniz. Widget'lar belirtildikleri sırayla görünür. Google Chat uygulamalarında bir örnek için Kartları ve iletişim kutularını sütunlarda görüntüleme bölümüne bakın.

Her bir sütunun yüksekliği, uzun sütuna göre belirlenir. Örneğin, ilk sütun ikinci sütundan uzunsa her iki sütun da ilk sütunun yüksekliğine sahip olur. Her sütun farklı sayıda widget içerebileceğinden satır tanımlayamaz veya sütunlar arasında widget'ları hizalayamazsınız.

Sütunlar yan yana gösterilir. HorizontalSizeStyle alanını kullanarak her sütunun genişliğini özelleştirebilirsiniz. Kullanıcının ekran genişliği çok darsa ikinci sütun ilk sütunun altına yerleştirilir:

Web'de, ekran genişliği 480 pikselden az veya bu değere eşitse ikinci sütun sarmalanır.
iOS cihazlarda, ekran genişliği 300 puntodan az veya bu değere eşitse ikinci sütun kaydırılır.
Android cihazlarda, ekran genişliği 320 dp'den az veya bu değere eşitse ikinci sütun sarmalanır.

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

Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir. Sütunları destekleyen eklenti kullanıcı arayüzleri şunlardır:

Kullanıcılar eklentiyi bir e-posta taslağından açtığında gösterilen iletişim kutusu.
Kullanıcılar Google Takvim etkinliğindeki Ek ekle menüsünden eklentiyi açtığında görüntülenen iletişim kutusu.

Alanlar

Alanlar
`columnItems[]`	`Column` Sütun dizisi. Bir karta veya iletişim kutusuna en fazla 2 sütun ekleyebilirsiniz.

columnItems[]

Column

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

Sütun

Bir sütun.

Google Workspace eklentileri ve Chat uygulamaları

Alanlar
`horizontalSizeStyle`	`HorizontalSizeStyle` Bir sütunun kartın genişliğini nasıl doldurduğunu belirtir.
`horizontalAlignment`	`HorizontalAlignment` Widget'ların bir sütunun sol, sağ veya ortasına hizalanıp hizalanmayacağını belirtir.
`verticalAlignment`	`VerticalAlignment` Widget'ların bir sütunun üstüne, altına veya ortasına hizalanıp hizalanmayacağını belirtir.
`widgets[]`	`Widgets` Bir sütuna dahil edilen widget dizisi. Widget'lar belirtildikleri sırayla görünür.

HorizontalSizeStyle

Bir sütunun kartın genişliğini nasıl doldurduğunu belirtir. Her bir sütunun genişliği, HorizontalSizeStyle değerine ve sütundaki widget'ların genişliğine bağlıdır.

Google Workspace Eklentileri ve Chat uygulamaları

Sıralamalar
`HORIZONTAL_SIZE_STYLE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`FILL_AVAILABLE_SPACE`	Varsayılan değer. Sütun, kartın genişliğinin %70'ine kadar olan kullanılabilir alanı doldurur. Her iki sütun da `FILL_AVAILABLE_SPACE` değerine ayarlanırsa her sütun, alanın% 50'sini doldurur.
`FILL_MINIMUM_SPACE`	Sütun, mümkün olan en az alanı doldurur ve kartın genişliğinin en fazla %30'unu kaplar.

VerticalAlignment

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

Google Workspace Eklentileri ve Chat uygulamaları

Sıralamalar
`VERTICAL_ALIGNMENT_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`CENTER`	Varsayılan değer. Widget'ları bir sütunun ortasına hizalar.
`TOP`	Widget'ları bir sütunun üst kısmına hizalar.
`BOTTOM`	Widget'ları bir sütunun alt kısmına hizalar.

Widget'lar

Bir sütuna ekleyebileceğiniz desteklenen widget'lar.

Google Workspace Eklentileri ve Chat uygulamaları

Alanlar
Birlik alanı `data`. `data` şunlardan yalnızca biri olabilir:
`textParagraph`	`TextParagraph` `TextParagraph` widget'ı.
`image`	`Image` `Image` widget'ı.
`decoratedText`	`DecoratedText` `DecoratedText` widget'ı.
`buttonList`	`ButtonList` `ButtonList` widget'ı.
`textInput`	`TextInput` `TextInput` widget'ı.
`selectionInput`	`SelectionInput` `SelectionInput` widget'ı.
`dateTimePicker`	`DateTimePicker` `DateTimePicker` widget'ı.
`chipList`	`ChipList` `ChipList` widget'ı. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

DateTimePicker

Kullanıcıların tarih, saat veya hem tarih hem de saat girmesine olanak tanır. Google Chat uygulamalarında örnek görmek için Kullanıcının tarih ve saat seçmesine izin verme başlıklı makaleyi inceleyin.

Kullanıcılar metin girebilir veya tarih ve saat seçmek için seçiciyi kullanabilir. Kullanıcılar geçersiz bir tarih veya saat girerse seçici, kullanıcıların bilgileri doğru şekilde girmelerini isteyen bir hata gösterir.

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

Alanlar
`name`	`string` `DateTimePicker` öğesinin bir form girişi 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.
`label`	`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.
`type`	`DateTimePickerType` Widget'ın tarih, saat veya tarih ve saat girişini destekleyip desteklemediği.
`valueMsEpoch`	`int64` Unix sıfır zamanından itibaren milisaniye cinsinden widget'ta gösterilen varsayılan değer. Değeri, seçicinin türüne göre belirtin (`DateTimePickerType`): `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'de bir saat. Örneğin, 12:00 değerini göstermek için `43200000` (veya `12 * 60 * 60 * 1000`) değerini kullanın.
`timezoneOffsetDate`	`int32` UTC ile saat dilimi arasındaki farkı dakika cinsinden temsil eden sayı. Ayarlanırsa `value_ms_epoch`, belirtilen saat diliminde gösterilir. Ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.
`onChangeAction`	`Action` Kullanıcı `DateTimePicker` arayüzünden Kaydet veya Temizle'yi tıkladığında tetiklenir.
`validation`	`Validation` Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizlemesi Programı kapsamında kullanılabilir. İsteğe bağlı. Bu tarih zamanlayıcı seçici için gerekli doğrulamayı belirtin. Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.

DateTimePickerType

DateTimePicker widget'ındaki tarih ve saat biçimi. Kullanıcıların tarih, saat veya hem tarih ve saat girebileceğini belirler.

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

Sıralamalar
`DATE_AND_TIME`	Kullanıcılar bir tarih ve saat girer.
`DATE_ONLY`	Kullanıcılar bir tarih girer.
`TIME_ONLY`	Kullanıcılar bir saat girer.

DecoratedText

Metni, metnin üstünde veya altında bir etiket, metnin önünde bir simge, seçim widget'ı veya metnin ardından bir düğme gibi isteğe bağlı süslemelerle gösteren widget. Google Chat uygulamalarıyla ilgili bir örnek için Desenli metin içeren metinler görüntüleme başlıklı makaleyi inceleyin.

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

Alanlar
`icon (deprecated)`	`Icon` Bu öğenin desteği sonlandırıldı. `startIcon` için kullanımdan kaldırıldı.
`startIcon`	`Icon` Metnin önünde gösterilen simge.
`topLabel`	`string` `text` üzerinde görünen metin. Her zaman kısaltılır.
`text`	`string` Zorunlu. Birincil metin. Basit biçimlendirmeyi destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.
`wrapText`	`bool` Metin 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.
`bottomLabel`	`string` `text` öğesinin altında görünen metin. Her zaman sarmalar.
`onClick`	`OnClick` Bu işlem, kullanıcılar `topLabel` veya `bottomLabel` düğmesini tıkladığında tetiklenir.
Birlik alanı `control`. `decoratedText` widget'ındaki metnin sağ tarafında görünen bir düğme, anahtar, onay kutusu veya resim. `control` şunlardan yalnızca biri olabilir:
`button`	`Button` Kullanıcının bir işlemi tetiklemek için tıklayabileceği bir düğme.
`switchControl`	`SwitchControl` Kullanıcının durumunu değiştirip bir işlem tetiklemek için tıklayabileceği bir anahtar widget'ı.
`endIcon`	`Icon` Metinden sonra görüntülenen bir simge. Yerleşik ve özel simgeleri destekler.

Anahtar Kontrolü

Açma/kapatma stilinde bir anahtar veya decoratedText widget'ının içindeki bir onay kutusu.

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

Yalnızca decoratedText widget'ında desteklenir.

Alanlar
`name`	`string` Anahtar widget'ının bir form girişi 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.
`value`	`string` Bir kullanıcı tarafından girilen ve form girişi etkinliği kapsamında 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.
`selected`	`bool` `true` olduğunda anahtar seçilir.
`onChangeAction`	`Action` Anahtar durumu değiştirildiğinde yapılacak işlem (ör. hangi işlevin çalıştırılacağı).
`controlType`	`ControlType` Anahtar, kullanıcı arayüzünde nasıl görünür? Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

ControlType

Anahtar, kullanıcı arayüzünde nasıl görünür?

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

Sıralamalar
`SWITCH`	Açma/kapatma düğmesi.
`CHECKBOX`	`CHECK_BOX` için kullanımdan kaldırıldı.
`CHECK_BOX`	Onay kutusu.

Refüj

Bu türde alan yoktur.

Widget'lar arasında bir ayırıcıyı yatay çizgi olarak görüntüler. Google Chat uygulamalarıyla ilgili bir örnek için Widget'lar arasına yatay ayırıcı ekleme başlıklı makaleyi inceleyin.

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

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

"divider": {}

EndNavigation

İletişim kutusu akış işlemi.

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

Alanlar

action

Action

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

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

İşlem

İstemcinin bir iletişim kutusu akışını sonlandırması için oluşturma işlemi türleri.

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

Sıralamalar
`ACTION_UNSPECIFIED`	İşlem belirtilmedi.
`CLOSE_DIALOG`	İletişim akışını kapatın.
`CLOSE_DIALOG_AND_EXECUTE`	İletişim akışını kapatın ve iletişim akışını açan kartı yenileyin.

GetAutocompletionResponse

Metin alanı için otomatik tamamlama öğelerini göstermek için gereken öğeleri içeren otomatik tamamlama kapsayıcısını alma yanıtı.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz. Örneğin:

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

Alanlar

Alanlar
`autoComplete`	`Suggestions`
`schema`	`string` Bu, söz dizimi kontrolü için işaretlemede bulunabilecek işlevsiz bir şema alanıdır.

autoComplete

Suggestions

schema

string

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

Izgara

Öğe koleksiyonunun yer aldığı bir ızgara görüntüler. Öğeler yalnızca metin veya resim içerebilir. Duyarlı sütunlar için veya metin ya da resimlerden daha fazlasını eklemek için Columns öğesini kullanın. Google Chat uygulamalarıyla ilgili bir örnek için Öğe koleksiyonu içeren bir ızgara görüntüleme başlıklı makaleyi inceleyin.

Izgara, istediğiniz sayıda sütun ve öğeyi destekler. Satır sayısı, öğelerin sütunlara bölünmesiyle belirlenir. 10 öğe ve 2 sütun içeren bir tabloda 5 satır vardır. 11 öğe ve 2 sütun içeren bir tabloda 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"
    }
  }
}

Alanlar
`title`	`string` Izgara başlığında görüntülenen metin.
`items[]`	`GridItem` Izgarada görüntülenecek öğeler.
`borderStyle`	`BorderStyle` Her bir ızgara öğesine uygulanacak kenarlık stili.
`columnCount`	`int32` Izgarada gösterilecek 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`	`OnClick` Bu geri çağırma, her bir tablo öğesi tarafından yeniden kullanılır ancak öğenin, geri çağırma parametrelerine eklenen öğeler listesindeki tanımlayıcı ve dizini ile birlikte kullanılır.

GridItem

Bir öğeyi ızgara düzeninde gösterir. Öğeler metin, resim veya hem metin hem de resim içerebilir.

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

Alanlar
`id`	`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 parametrelerinde döndürülür.
`image`	`ImageComponent` Tablo öğesinde görüntülenen resim.
`title`	`string` Izgara öğesinin başlığı.
`subtitle`	`string` Izgara öğesinin alt başlığı.
`layout`	`GridItemLayout` Izgara öğesi için kullanılacak düzen.

GridItemLayout

Izgara öğesi için kullanılabilecek çeşitli düzen seçeneklerini gösterir.

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

Sıralamalar
`GRID_ITEM_LAYOUT_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`TEXT_BELOW`	Başlık ve alt başlık, ızgara öğesinin resminin altında gösterilir.
`TEXT_ABOVE`	Başlık ve alt başlık, ızgara öğesinin resminin üzerinde gösterilir.

Simge

Bir karttaki widget'ta gösterilen simge. Google Chat uygulamalarıyla ilgili bir örnek için Simge ekleme başlıklı makaleyi inceleyin.

Yerleşik ve özel simgeleri destekler.

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

Alanlar
`altText`	`string` İsteğe bağlı. Erişilebilirlik için kullanılan simgeye dair açıklama. Belirtilmediği takdirde varsayılan değer `Button` olur. 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 `Button` içinde ayarlanırsa kullanıcı imlecini düğmenin üzerine getirdiğinde `altText` yardım metni olarak görünür. Ancak düğme `text` değerini de ayarlarsa simgenin `altText` değeri yoksayılır.
`imageType`	`ImageType` Resme uygulanan kırpma stili. Bazı durumlarda `CIRCLE` kırpma uygulandığında resim, yerleşik bir simge olduğundan daha büyük çizilir.
Birlik alanı `icons`. Karttaki widget'ta gösterilen simge. `icons` şunlardan yalnızca biri olabilir:
`knownIcon`	`string` Google Workspace tarafından sağlanan yerleşik simgelerden birini gösterir. Örneğin, uçak simgesi göstermek 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.
`iconUrl`	`string` HTTPS URL'sinde barındırılan özel bir simge görüntüleyin. Örneğin: `"iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"` Desteklenen dosya türleri `.png` ve `.jpg`'dur.
`materialIcon`	`MaterialIcon` Google Materyal Simgelerinden birini görüntüleyin. Örneğin, bir onay kutusu simgesi görüntülemek için `"materialIcon": { "name": "check_box" }` Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentileriyle kullanılamaz.

Resim

URL ile belirtilen ve onClick işlemi içerebilen bir resim. Örnek için Resim ekleme bölümüne bakın.

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

Alanlar

Alanlar
`imageUrl`	`string` Resmi barındıran HTTPS URL'si. Örneğin: `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`
`onClick`	`OnClick` Kullanıcı resmi tıkladığında, tıklama bu işlemi tetikler.
`altText`	`string` Bu resmin erişilebilirlik için kullanılan alternatif metni.

imageUrl

string

Resmi barındıran HTTPS URL'si.

Örneğin:

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

onClick

OnClick

Kullanıcı resmi tıkladığında, tıklama bu işlemi tetikler.

altText

string

Bu resmin erişilebilirlik için kullanılan alternatif metni.

ImageComponent

Bir resmi temsil eder.

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

Alanlar
`imageUri`	`string` Resim URL'si.
`altText`	`string` Resmin erişilebilirlik etiketi.
`cropStyle`	`ImageCropStyle` Resme uygulanacak kırpma stili.
`borderStyle`	`BorderStyle` Resme uygulanacak kenarlık stili.

ImageCropStyle

Bir resme uygulanan kırpma stilini temsil eder.

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

Ö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
}

Alanlar

Alanlar
`type`	`ImageCropType` Kırpma türü.
`aspectRatio`	`double` Kırpma türü `RECTANGLE_CUSTOM` ise kullanılacak en boy oranı. Örneğin, 16:9 en boy oranını uygulamak için: `cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }`

type

ImageCropType

Kırpma türü.

aspectRatio

double

Kırpma türü RECTANGLE_CUSTOM ise kullanılacak en boy oranı.

Örneğin, 16:9 en boy oranını uygulamak için:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

Resme uygulanan kırpma stilini gösterir.

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

Sıralamalar
`IMAGE_CROP_TYPE_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`SQUARE`	Varsayılan değer. Kare kırpma uygular.
`CIRCLE`	Dairesel kırpma uygular.
`RECTANGLE_CUSTOM`	Özel en boy oranına sahip dikdörtgen kırpma uygular. `aspectRatio` ile özel en boy oranını ayarlayın.
`RECTANGLE_4_3`	4:3 en boy oranına sahip dikdörtgen kırpma uygular.

Bağlantı

Eklentiye döndürülen üçüncü taraf kaynağının bağlantı nesnesi. Daha fazla bilgi için @ menüsünden üçüncü taraf kaynakları oluşturma başlıklı makaleyi inceleyin.

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

Alanlar

Alanlar
`url`	`string` Eklenti için geri döneceğiniz bağlantının URL'si.
`title`	`string` Eklenti sayfasına dönmek için bağlantının başlığı.

url

string

Eklenti için geri döneceğiniz bağlantının URL'si.

title

string

Eklenti sayfasına dönmek için bağlantının başlığı.

LinkPreview

Kart ve akıllı çip göstererek üçüncü taraf bağlantısını önizleyen kart işlemi. Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme başlıklı makaleyi inceleyin.

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

Örneğin, aşağıdaki JSON, bağlantı önizlemesi ve akıllı çipi için benzersiz bir başlık ile başlık ve metin açıklaması içeren bir önizleme kartı döndürür:

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

Örnek, aşağıdaki bağlantı önizlemesini döndürür:

Örnek bağlantı önizlemesi

Alanlar

Alanlar
`previewCard`	`Card` Üçüncü taraf bir hizmetten gelen bağlantıyla ilgili bilgileri gösteren kart.
`title`	`string` Bağlantı önizlemesi için akıllı çipte gösterilen başlık. Ayarlanmazsa akıllı çip, `preview_card` öğesinin başlığını gösterir.
`linkPreviewTitle`	`string` Bağlantı önizlemesinde gösterilen başlık. Ayarlanmamışsa bağlantı önizlemesinde `preview_card` öğesinin başlığı gösterilir.

previewCard

Card

Üçüncü taraf bir hizmetten gelen bağlantıyla ilgili bilgileri gösteren kart.

title

string

Bağlantı önizlemesi için akıllı çipte gösterilen başlık. Ayarlanmazsa akıllı çip, preview_card öğesinin başlığını gösterir.

linkPreviewTitle

string

Bağlantı önizlemesinde gösterilen başlık. Ayarlanmamışsa bağlantı önizlemesinde preview_card öğesinin başlığı gösterilir.

MaterialIcon

2.500'den fazla seçenek içeren Google Material Simgesi.

Örneğin, özelleştirilmiş ağırlık ve not içeren bir onay kutusu simgesi görüntülemek için şunları yazın:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

Alanlar
`name`	`string` Google Material simgesi'nde tanımlanan simge adı (ör. `check_box`). Geçersiz adlar atlanır ve boş dizeyle değiştirilir. Bu da simgenin oluşturulamamasına neden olur.
`fill`	`bool` Simgenin dolu olarak oluşturulup oluşturulmayacağı. Varsayılan değer false'tur. Farklı simge ayarlarını önizlemek için Google Yazı Tipi Simgelerine gidin ve Özelleştir bölümündeki ayarları yapın.
`weight`	`int32` Simgenin çizgi kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Bu ayar 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 altındaki ayarları yapın.
`grade`	`int32` Ağırlık ve sınıf, sembolün 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. Bu değer yoksa varsayılan değer 0'dır. 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.

Kart yığınını manipüle eden kart işlemi.

Örneğin:

1) Yığına yeni bir kart ekleyin (ileri git). Chat uygulamalarında, yalnızca uygulama ana sayfasında kullanılabilir.

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

 navigations : {
    pushCard : CARD
  }

2) Yığının en üstündeki kartı güncelleyin (güncelleyin).

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

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) Güncellemeden bir adım geri gidin.

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

  navigations : {
    popCard : true,
  }

4) Birden fazla adıma geri dönün ve ilgili kartı güncelleyin.

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

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) Tanımlanmış bir CARD_NAME yönüne giden birden fazla adım geri gidin.

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

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) Kök klasöre geri dönün ve ilgili kartı güncelleyin.

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

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) Belirtilen karta gidip bu kartı da açın.

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

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) Üstteki kartı yeni bir kartla değiştirin. Chat uygulamalarında, yalnızca uygulama ana sayfasında kullanılabilir.

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

  navigations : {
    updateCard : CARD
  }

Alanlar
Birlik alanı `navigate_action`. `navigate_action` yalnızca aşağıdakilerden biri olabilir:
`popToRoot`	`bool` Kart grubu, kök kart hariç tüm kartları çıkarır.
`pop`	`bool` Kart yığını bir karttan çıkıyor.
`popToCard`	`string` Kart yığını, belirtilen kartın üzerindeki tüm kartları belirli bir kart adıyla gösterir.
`pushCard`	`Card` Kart yığını, bir kartı kart yığınına itiyor.
`updateCard`	`Card` Kart grubu, üstteki kartı yeni bir kartla günceller ve doldurulmuş form alanı değerlerini korur. Eşdeğer olmayan bir alan için değer atlanır.
`endNavigation`	`EndNavigation` İletişim kutusu akışı sonu gezinme işlemi. Daha fazla bilgi için Google Chat uygulaması için ana sayfa oluşturma başlıklı makaleyi inceleyin. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

Bildirim

Ana makine uygulamasında bir bildirim gösteren kart işlemi.

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

Alanlar

Alanlar
`text`	`string` Bildirimde görüntülenecek düz metin (HTML etiketleri olmadan).

text

string

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

OnClick

Kullanıcılar karttaki düğme gibi etkileşimli bir öğeyi tıkladığında nasıl yanıt verileceğini gösterir.

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

Alanlar
Birlik alanı `data`. `data` şunlardan yalnızca biri olabilir:
`action`	`Action` Belirtilen bu `onClick` tarafından bir işlem tetiklenir.
`openLink`	`OpenLink` Belirtilen bu `onClick`, bağlantı açma işlemini tetikler.
`openDynamicLinkAction`	`Action` Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde 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 ve Google Chat uygulamalarında kullanılamaz.
`card`	`Card` Belirtilen durumlarda, tıklandıktan sonra kart yığınına yeni bir kart eklenir. Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.
`overflowMenu`	`OverflowMenu` Belirtilirse bu `onClick`, bir taşma menüsü açar. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

OpenLink

Bir köprü açan onClick etkinliğini temsil eder.

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

Alanlar

Alanlar
`url`	`string` Açılacak URL.
`openAs`	`OpenAs` Bağlantı nasıl açılır? Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.
`onClose`	`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 ve Google Chat uygulamalarında kullanılamaz.

url

string

Açılacak URL.

openAs

OpenAs

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

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

onClose

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 ve Google Chat uygulamalarında kullanılamaz.

OnClose

OnClick işlemi tarafından açılan bir bağlantı kapatıldığında istemcinin yaptığı işlem.

Uygulama, istemci platformu özelliklerine bağlıdır. Örneğin, bir web tarayıcısı bir bağlantıyı OnClose işleyici içeren bir pop-up pencerede açabilir.

Hem OnOpen hem de OnClose işleyicileri ayarlandıysa ve istemci platformu her iki değeri de destekleyemiyorsa OnClose öncelikli olur.

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

Sıralamalar

NOTHING Varsayılan değer. Kart yeniden yüklenmez ve hiçbir şey olmaz.

Sıralamalar
`NOTHING`	Varsayılan değer. Kart yeniden yüklenmez ve hiçbir şey olmaz.
`RELOAD`	Alt pencere kapandıktan sonra kartı yeniden yükler. `OpenAs.OVERLAY` ile birlikte kullanılırsa alt pencere modal iletişim kutusu gibi davranır ve alt pencere kapanana kadar üst kart engellenir.

RELOAD

Alt pencere kapandıktan sonra kartı yeniden yükler.

OpenAs.OVERLAY ile birlikte kullanılırsa alt pencere modal iletişim kutusu gibi davranır ve alt pencere kapanana kadar üst kart engellenir.

OpenAs

OnClick işlemi bir bağlantı açtığında, müşteri bunu tam boyutlu bir pencere (istemci tarafından kullanılan çerçeveyse) veya yer paylaşımı (pop-up gibi) olarak açabilir. Uygulama, istemci platformu özelliklerine bağlıdır ve seçilen değer istemci tarafından desteklenmiyorsa yoksayılabilir. FULL_SIZE tüm müşteriler tarafından desteklenmektedir.

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

Sıralamalar
`FULL_SIZE`	Bağlantı, tam boyutlu bir pencere olarak açılır (müşteri tarafından kullanılan çerçeve bu ise).
`OVERLAY`	Bağlantı, pop-up gibi bir yer paylaşımı olarak açılır.

OverflowMenu

Kullanıcıların çağırabileceği bir veya daha fazla işlemi içeren bir pop-up menü sunan widget. Örneğin, bir kartta birincil olmayan işlemleri göstermek. İşlemler mevcut alana sığmadığında bu widget'ı kullanabilirsiniz. Kullanmak için widget'ı destekleyen widget'ların OnClick işleminde belirtin. Örneğin, Button içinde.

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

Alanlar

items[]

OverflowMenuItem

Zorunlu. Menü seçenekleri listesi.

OverflowMenuItem

Kullanıcıların taşma menüsünde çağırabileceği bir seçenek.

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

Alanlar
`startIcon`	`Icon` Metnin önünde gösterilen simge.
`text`	`string` Zorunlu. Öğeyi kullanıcılara tanımlayan veya açıklayan metin.
`onClick`	`OnClick` Zorunlu. Bir menü seçeneği belirlendiğinde çağrılan işlem. Bu `OnClick`, `OverflowMenu` içeremez. Belirtilen tüm `OverflowMenu`'lar bırakılır ve menü öğesi devre dışı bırakılır.
`disabled`	`bool` Menü seçeneğinin devre dışı bırakılıp bırakılmayacağı. Varsayılan değer yanlıştır.

RenderActions

Bir karta bir işlem yapmasını veya eklenti ana uygulamasını ya da Chat uygulamasını uygulamaya özgü bir işlem yapmasını söyleyen bir dizi oluşturma talimatı.

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

Alanlar

action

Action

hostAppAction

HostAppActionMarkup

Bağımsız ana makine uygulamaları tarafından işlenen işlemler.

schema

string

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

İşlem

Alanlar
`navigations[]`	`Navigation` Gösterilen kartları itin, pop up olarak gösterin veya güncelleyin.
`link`	`OpenLink` Hedef bağlantıyı hemen yeni bir sekmede veya pop-up'ta açın.
`notification`	`Notification` Son kullanıcıya bildirim gösterin.
`linkPreview`	`LinkPreview` Son kullanıcıya bağlantı önizlemesi gösterin.
`links[]`	`Link` Google Workspace uygulamasından oluşturulan üçüncü taraf kaynağın bağlantısı. Bir öğeli nesne dizisi olarak biçimlendirilir. Daha fazla bilgi için @ menüsünden üçüncü taraf kaynakları oluşturma başlıklı makaleyi inceleyin.

SelectionInput

Kullanıcıların seçebileceği bir veya daha fazla kullanıcı arayüzü öğesi oluşturan bir widget. Örneğin, açılır menü veya onay kutuları. Tahmin edilebilecek veya numaralandırılabilen verileri toplamak için bu widget'ı kullanabilirsiniz. Google Chat uygulamalarında bir örnek için Seçilebilir kullanıcı arayüzü öğeleri ekleme bölümüne bakın.

Chat uygulamaları, kullanıcıların seçtiği veya girdiği öğelerin değerini işleyebilir. Form girişleriyle çalışma hakkında ayrıntılar için Form verilerini alma başlıklı makaleye göz atın.

Kullanıcılardan tanımlanmamış veya soyut veriler toplamak için TextInput widget'ını kullanın.

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

Alanlar
`name`	`string` Zorunlu. Form giriş etkinliğinde 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.
`label`	`string` Kullanıcı arayüzündeki 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 metin belirtin. Örneğin, kullanıcılar açılır menüden bir iş biletinin aciliyetini seçiyorsa etiket "Aciliyet" veya "Aciliyeti seçin" olabilir.
`type`	`SelectionType` `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 seçebilir ancak açılır menüden yalnızca bir değer seçebilir.
`items[]`	`SelectionItem` Seçilebilir öğelerden oluşan bir dizi. Örneğin, bir dizi radyo düğmesi veya onay kutusu. 100 adede kadar öğeyi destekler.
`onChangeAction`	`Action` Belirtilen durumlarda, seçim değiştiğinde form 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.
`multiSelectMaxSelectedItems`	`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.
`multiSelectMinQueryLength`	`int32` Çoklu seçim menüleri için, uygulamanın otomatik tamamlama sorgusu yapmadan ve menüde önerilen öğeleri göstermeden önce kullanıcının girdiği metin karakterlerinin sayısı. Belirtilmezse varsayılan olarak statik veri kaynakları için 0 karakter, harici veri kaynakları için 3 karakter olur.
`validation`	`Validation` Açılır menüler için bu seçim giriş alanının doğrulaması. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
Birleştirme alanı `multi_select_data_source`. Çoklu seçim menüsü için seçim öğelerini dolduran veri kaynağı. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz. `multi_select_data_source` yalnızca aşağıdakilerden biri olabilir:
`externalDataSource`	`Action` İlişkisel veri tabanı gibi harici bir veri kaynağı.
`platformDataSource`	`PlatformDataSource` Google Workspace'ten bir veri kaynağı.

PlatformDataSource

Çoklu seçim menüsünü kullanan bir SelectionInput widget'ı için Google Workspace'ten bir veri kaynağı. Çoklu seçim menüsündeki öğeleri doldurmak için kullanılır.

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

Alanlar

Birlik alanı data_source. Veri kaynağı. data_source yalnızca aşağıdakilerden biri olabilir:

commonDataSource

CommonDataSource

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

hostAppDataSource

HostAppDataSourceMarkup

Google Workspace barındıran uygulamasına (ör. Google Chat'teki alanlar) özgü bir veri kaynağı.

Bu alan Google API istemci kitaplıklarını destekler ancak Cloud istemci kitaplıklarında kullanılamaz. Daha fazla bilgi edinmek için İstemci kitaplıklarını yükleme başlıklı makaleyi inceleyin.

CommonDataSource

Tüm Google Workspace uygulamaları tarafından paylaşılan bir veri kaynağı.

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

Sıralamalar
`UNKNOWN`	Varsayılan değer. Kullanmayın.
`USER`	Google Workspace kullanıcıları Kullanıcı yalnızca Google Workspace kuruluşundaki kullanıcıları görüntüleyebilir ve seçebilir.

SelectionItem

Kullanıcıların bir seçim girişinde seçebileceği bir öğe (ör. onay kutusu veya anahtar).

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

Alanlar
`text`	`string` Öğeyi kullanıcılara tanımlayan veya açıklayan metin.
`value`	`string` Bu öğeyle ilişkilendirilen değer. Müşteri bunu 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.
`selected`	`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.
`startIconUri`	`string` Çoklu seçim menüleri için öğenin `text` alanının yanında görüntülenen simgenin URL'si. 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`.
`bottomText`	`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.

SelectionType

Kullanıcıların seçebileceği öğelerin biçimi. Farklı seçenekler farklı etkileşim türlerini destekler. Örneğin, kullanıcılar birden fazla onay kutusunu seçebilir ancak açılır menüden yalnızca bir öğe seçebilir.

Her seçim girişi bir seçim türünü destekler. Onay kutuları ve anahtarların birlikte kullanılması desteklenmez.

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

Sıralamalar
`CHECK_BOX`	Onay kutuları. Kullanıcılar bir veya daha fazla onay kutusunu işaretleyebilir.
`RADIO_BUTTON`	Bir dizi radyo düğmesi. Kullanıcılar bir radyo düğmesi seçebilir.
`SWITCH`	Bir dizi anahtar. Kullanıcılar bir veya daha fazla anahtarı açabilir.
`DROPDOWN`	Açılır menü. Kullanıcılar menüden bir öğe seçebilir.
`MULTI_SELECT`	Statik veya dinamik veriler için çoklu seçim menüsü. Kullanıcılar menü çubuğundan bir veya daha fazla öğe seçer. Kullanıcılar, dinamik verileri doldurmak için değerler de girebilir. Örneğin, kullanıcılar bir Google Chat alanının adını yazmaya başlayabilir ve widget, alanı otomatik olarak önerir. Bir çoklu seçim menüsünün öğelerini doldurmak için aşağıdaki veri kaynağı türlerinden birini kullanabilirsiniz: Statik veriler: Öğeler widget'ta `SelectionItem` nesneleri olarak belirtilir. En fazla 100 öğe. Google Workspace verileri: Öğeler, Google Workspace'teki veriler (ör. Google Workspace kullanıcıları veya Google Chat alanları) kullanılarak doldurulur. Harici veriler: Öğeler Google Workspace dışındaki harici bir veri kaynağından doldurulur. Çoklu seçim menüsünün nasıl uygulanacağına dair örnekler için Çoklu seçim menüsü ekleme başlıklı makaleyi inceleyin. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.

SubmitFormResponse

Kartın ve/veya eklenti ana uygulamanın gerçekleştirmesi gereken işlemleri ve kartın durumunun değişip değişmediğini içeren bir otomatik tamamlama kapsayıcısı almak dışında, form gönderme işlemine verilen yanıt.

Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz. Örneğin:

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: [email protected]"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}

Alanlar

renderActions

RenderActions

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

stateChanged

bool

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

schema

string

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

Öneriler

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ığıyla eşleşecek şekilde dinamik olarak filtrelenir.

Örneğin, programlama dili için bir metin giriş alanında Java, JavaScript, Python ve C++ kodu önerilebilir. Kullanıcılar Jav yazmaya başladığında Java ve JavaScript gösteren öneri filtreleri listesi 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.

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.

Alanlar

items[]

SuggestionItem

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

SuggestionItem

Kullanıcıların bir metin giriş alanına girebileceği önerilen bir değer.

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

Alanlar

Birlik alanı content.

content yalnızca aşağıdakilerden biri olabilir:

text

string

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

TextInput

Kullanıcıların metin girebileceği bir alan. Önerileri ve değişiklikle ilgili işlemleri destekler. Google Chat uygulamalarında bir örnek için Kullanıcıların metin girebileceği bir alan ekleme başlıklı makaleyi inceleyin.

Sohbet uygulamaları, form giriş etkinlikleri sırasında girilen metnin değerini alır ve işleyebilir. Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma başlıklı makaleyi inceleyin.

Kullanıcılardan tanımlanmamış veya soyut veriler toplamanız gerektiğinde metin girişi kullanın. Kullanıcılardan tanımlanmış veya listelenmiş veriler toplamak için SelectionInput widget'ını kullanın.

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

Alanlar
`name`	`string` Form girişi etkinliğinde metin girişinin 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.
`label`	`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 metin 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.
`hintText`	`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 durumdadır. `label` belirtilmediyse gereklidir. Aksi takdirde isteğe bağlıdır.
`value`	`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`	`Type` Metin giriş alanı kullanıcı arayüzünde nasıl görünür? Örneğin, alanın tek mi yoksa çok satırlı mı olduğu.
`onChangeAction`	`Action` Metin giriş alanında bir değişiklik olduğunda yapılacak işlem. Örneğin, kullanıcının alana metin eklemesi veya metinleri silme işlemi. Yapılacak işlemlere örnek olarak Google Chat'te özel işlev çalıştırma veya iletişim kutusu açma verilebilir.
`initialSuggestions`	`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ığı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 listesi yalnızca `Java` ve `JavaScript`'yi gösterecek şekilde filtrelenir. Ö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. Belirtildiğinde `TextInput.type`, `MULTIPLE_LINE` olarak ayarlanmış olsa bile her zaman `SINGLE_LINE` olur. Google Chat uygulamaları ve Google Workspace eklentilerinde kullanılabilir.
`autoCompleteAction`	`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. Belirtilen durumda uygulama, burada belirtilen işlemi (ör. özel işlev çalıştırma) gerçekleştirir. Google Workspace eklentilerinde kullanılabilir ve Google Chat uygulamalarında kullanılamaz.
`validation`	`Validation` Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizlemesi Programı kapsamında kullanılabilir. Bu metin giriş alanı için gerekli doğrulamayı belirtin. Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir.
`placeholderText`	`string` Alan boşken 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.

Tür

Metin giriş alanı kullanıcı arayüzünde nasıl görünür? Örneğin, tek satırlık giriş alanı mı yoksa çok satırlık giriş mi olduğu. initialSuggestions belirtilmişse type, MULTIPLE_LINE olarak ayarlanmış olsa bile her zaman SINGLE_LINE olur.

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

Sıralamalar
`SINGLE_LINE`	Metin giriş alanının yüksekliği bir satır olmak üzere sabittir.
`MULTIPLE_LINE`	Metin giriş alanı, birden fazla satırın sabit yüksekliğine sahiptir.

TextParagraph

Biçimlendirmeyi destekleyen bir metin paragrafı. Google Chat uygulamalarında bir örnek için Biçimlendirilmiş metin paragrafı ekleme başlıklı makaleyi inceleyin. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin.

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

Alanlar

text

string

Widget'ta gösterilen metin.

maxLines

int32

Widget'ta gösterilen 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 bu sayıdan 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.

Doğrulama

Bağlı olduğu widget'ı doğrulamak için gereken verileri gösterir.

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

Alanlar

characterLimit

int32

Metin girişi widget'ları için karakter sınırlamasını belirtin. Bunun yalnızca metin girişi için kullanıldığını ve diğer widget'lar için yoksayıldığını unutmayın.

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

inputType

InputType

Giriş widget'larının türünü belirtin.

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

InputType

Giriş widget'ının türü.

Sıralamalar
`INPUT_TYPE_UNSPECIFIED`	Tür belirtilmedi. Kullanmayın.
`TEXT`	Tüm karakterleri kabul eden normal metin.
`INTEGER`	Tam sayı değeri.
`FLOAT`	Kayan noktalı değer.
`EMAIL`	Bir e-posta adresi.
`EMOJI_PICKER`	Sistem tarafından sağlanan emoji seçiciden seçilen bir emoji.

Alanlar
`horizontalAlignment`	`HorizontalAlignment` Widget'ların bir sütunun soluna, sağına veya ortasına hizalanıp hizalanmayacağını belirtir.
Birleştirme alanı `data`. Widget'larda yalnızca aşağıdaki öğelerden biri bulunabilir. Daha fazla öğe görüntülemek için birden fazla widget alanı kullanabilirsiniz. `data` yalnızca aşağıdakilerden biri olabilir:
`textParagraph`	`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 metin biçimlendirme ve Google Workspace eklentilerinde metin biçimlendirme başlıklı makaleleri inceleyin. Örneğin, aşağıdaki JSON kalın metin oluşturur: `"textParagraph": { "text": " <b>bold text</b>" }`
`image`	`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`	`DecoratedText` Süslenmiş bir metin öğesi 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": "[email protected]", "bottomLabel": "This is a new Email address!", "switchControl": { "name": "has_send_welcome_email_to_sasha", "selected": false, "controlType": "CHECKBOX" } }`
`buttonList`	`ButtonList` Düğme listesi. Örneğin, aşağıdaki JSON iki düğme oluşturur. Birincisi mavi metin düğmesi, ikincisi ise bağlantı açan resim düğmesidir: `"buttonList": { "buttons": [ { "text": "Edit", "color": { "red": 0, "green": 0, "blue": 1, }, "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }`
`textInput`	`TextInput` Kullanıcıların metin yazabileceği bir metin kutusu gösterir. Ö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 öneriler içeren 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`	`SelectionInput` Kullanıcıların öğe seçmesine olanak tanıyan bir seçim denetimi gösterir. 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 beden 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`	`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`	`Divider` Widget'lar arasında yatay bir çizgi ayırıcı gösterir. Örneğin, aşağıdaki JSON bir bölücü oluşturur: `"divider": { }`
`grid`	`Grid` Öğe koleksiyonunun yer aldığı bir ızgara görüntüler. Izgara, istediğiniz sayıda sütun ve öğeyi destekler. Satır sayısı, öğe sayısının üst sınırı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 tabloda 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`	`Columns` En fazla 2 sütun görüntülenir. 2'den fazla sütun eklemek veya satır 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" } } ] } ] }`
`chipList`	`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.

HorizontalAlignment

Sıralamalar
`HORIZONTAL_ALIGNMENT_UNSPECIFIED`	Kullanmayın. Belirtilmedi.
`START`	Varsayılan değer. Widget'ları sütunun başlangıç konumuna hizalar. Soldan sağa düzenlerde sola hizalar. Sağdan sola düzenler için sağa hizalanır.
`CENTER`	Widget'ları sütunun ortasına hizalar.
`END`	Widget'ları sütunun son konumuna hizalar. Soldan sağa düzenler için widget'ları sağa hizalar. Sağdan sola düzenlerde, widget'ları sola hizalar.

ImageType

Sıralamalar
`SQUARE`	Varsayılan değer. Resme kare maske uygular. Örneğin, 4x3 boyutundaki bir resim 3x3 boyutuna getirilir.
`CIRCLE`	Resme yuvarlak bir maske uygular. Örneğin, 4x3 boyutundaki bir resim çapı 3 olan bir daireye dönüşür.

Package google.apps.card.v1

Dizin

İşlem

ActionParameter

Etkileşim

LoadIndicator

BorderStyle

BorderType

Düğme

Tür

ButtonList

Kart

CardAction

CardFixedFooter

CardHeader

DisplayStyle

DividerStyle

Bölüm

Çip

ChipList

Düzen

CollapseControl

Sütunlar

Sütun

HorizontalSizeStyle

VerticalAlignment

Widget'lar

DateTimePicker

DateTimePickerType

DecoratedText

Anahtar Kontrolü

ControlType

Refüj

EndNavigation

İşlem

GetAutocompletionResponse

Izgara

GridItem

GridItemLayout

Simge

Resim

ImageComponent

ImageCropStyle

ImageCropType

Bağlantı

LinkPreview

MaterialIcon

Gezinme

Bildirim

OnClick

OpenLink

OnClose

OpenAs

OverflowMenu

OverflowMenuItem

RenderActions

İşlem

SelectionInput

PlatformDataSource

CommonDataSource

SelectionItem

SelectionType

SubmitFormResponse

Öneriler

SuggestionItem

TextInput

Tür

TextParagraph

Doğrulama

InputType

Widget

HorizontalAlignment

ImageType