Cards v2

object (CardHeader)

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

object (Section)

Bir 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ında bir örnek için Kart bölümünü tanımlama bölümüne bakın.

enum (DividerStyle)

Başlık, bölümler ve alt bilgi arasındaki ayırıcı stili.

object (CardAction)

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

Google Workspace Eklentileriyle 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"
      }
    }
  }
]

string

Kartın adı. Kart gezinmesinde kart tanımlayıcısı olarak kullanılır.

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

object (CardFixedFooter)

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

primaryButton veya secondaryButton belirtmeden fixedFooter değerini ayarlamak hataya neden olur. Chat uygulamalarında iletişim kutularında sabit altbilgi kullanabilirsiniz ancak kart mesajlarında kullanamazsınız.

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

enum (DisplayStyle)

Google Workspace eklentilerinde peekCardHeader öğesinin görüntüleme özelliklerini belirler.

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

object (CardHeader)

İçeriğe dayalı içerikler gösterilirken göz atma kartı başlığı, kullanıcının ana sayfa kartları ile içeriğe dayalı kartlar arasında ileri geri gezinebilmesi için yer tutucu görevi görür.

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

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.

string

Kart başlığının alt başlığı. Belirtilirse title'ün altında kendi satırında görünür.

enum (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 en üstünde görünen metin. Basit HTML biçimli metinleri destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makalelere göz atın.

object (Widget)

Bölümdeki tüm widget'lar. En az bir widget içermelidir.

boolean

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 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.

integer

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üm beş widget içeriyorsa ve uncollapsibleWidgetsCount değeri 2 olarak ayarlanmışsa 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.

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

enum (HorizontalAlignment)

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

object (TextParagraph)

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

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

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

object (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"
}

object (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": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object (ButtonList)

Düğme listesi.

Örneğin, aşağıdaki JSON dosyası 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"
        }
      }
    }
  ]
}

object (TextInput)

Kullanıcıların metin 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 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"
      }
    ]
  }
}

object (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
    }
  ]
}

object (DateTimePicker)

Kullanıcıların tarih, saat veya tarih ve saat girmelerine olanak tanıyan bir widget gösterir.

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

object (Divider)

Widget'lar arasında yatay bir çizgi ayırıcısı görüntüler.

Örneğin, aşağıdaki JSON bir bölücü oluşturur:

"divider": {
}

object (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ırlarının sütun sayısına 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 Eklentilerinde kullanılabilir.

Örneğin, aşağıdaki JSON tek bir öğe içeren 2 sütunlu bir ızgara oluşturur:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

object (Columns)

En fazla 2 sütun gösterir.

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

object (ChipList)

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

string

Widget'ta gösterilen metin.

integer

Widget'ta gösterilen maksimum metin satırı sayısı. Metin, belirtilen maksimum satır sayısını aşarsa fazla içerik daha fazla göster düğmesinin arkasında saklanır. Metin, belirtilen maksimum satır sayısına eşit veya bundan daha 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 Eklentilerinde kullanılamaz.

string

Resmi barındıran HTTPS URL'si.

Örneğin:

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

object (OnClick)

Kullanıcı resmi tıkladığında bu işlem tetiklenir.

string

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

object (Action)

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

object (OpenLink)

Belirtilirse bu onClick bağlantı açma işlemini tetikler.

object (Action)

Bir eklenti, işlemin bir bağlantıyı açması gerektiğinde bu işlemi tetikler. Bu, bağlantıyı almak için sunucuya danışması gerektiğinden yukarıdaki openLink yönteminden farklıdır. Bu nedenle, bağlantı açma işlemi yanıtı gelmeden önce web istemcisinin yapması gereken bazı hazırlık çalışmaları gerekir.

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

object (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.

object (OverflowMenu)

Belirtilirse bu onClick, bir taşma menüsü açar. Google Chat uygulamaları için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

string

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

Kullanım örneği için Form verilerini okuma bölümünü inceleyin.

object (ActionParameter)

İşlem parametrelerinin listesi.

enum (LoadIndicator)

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

boolean

İş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 cardId 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 değerini SPINNER olarak ayarlayın.

enum (Interaction)

İsteğe bağlı. İletişim kutusu açarken 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çma veya bir işlevi çalıştırma gibi bir action çalıştırarak normal şekilde yanıt verir.

interaction belirterek uygulama özel etkileşimli şekillerde 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ı için kullanılabilir ve Google Workspace eklentilerinde kullanılamaz.

string

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

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

boolean

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

string

İşlem komut dosyası parametresinin adı.

string

Parametrenin değeri.

string

Açılacak URL.

enum (OpenAs)

Bağlantıyı açma.

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

enum (OnClose)

İstemcinin, bağlantıyı açtıktan sonra bağlantıyı unutup unutmayacağını veya pencere kapanana kadar bağlantıyı gözlemleyip gözlemleyemeyeceğini belirtir.

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

object (OverflowMenuItem)

Zorunlu. Menü seçeneklerinin listesi.

object (Icon)

Metnin önünde gösterilen simge.

string

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

object (OnClick)

Zorunlu. Bir menü seçeneği seçildiğinde çağrılan işlem. Bu OnClick bir OverflowMenu içeremez, belirtilen herhangi bir OverflowMenu atlanır ve menü öğesi devre dışı bırakılır.

boolean

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

string

İsteğe bağlı. Erişilebilirlik için kullanılan simgeye dair açıklama. Belirtilmediği takdirde varsayılan değer Button sağlanır. En iyi uygulama olarak, simgenin neyi gösterdiği ve varsa ne işe yaradığı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 Button olarak ayarlanmışsa kullanıcı düğmenin üzerine geldiğinde altText yardım metni olarak görünür. Ancak düğme aynı zamanda text değerini de ayarlarsa simgenin altText değeri yoksayılır.

enum (ImageType)

Resme uygulanan kırpma stili. Bazı durumlarda, kırpma uygulanması, resmin yerleşik bir simge olduğundan daha büyük çizilmesine neden olur.

string

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

Ö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 bölümüne bakın.

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 şunları içerir: .png ve .jpg.

object (MaterialIcon)

Google Material simgelerinden birini gösterin.

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

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

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

string

Google Material simgesi bölümü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.

boolean

Simgenin doldurulmuş olarak oluşturulup oluşturulmayacağı. Varsayılan değer yanlıştır.

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

integer

Simgenin çizgi kalınlığı. {100, 200, 300, 400, 500, 600, 700} arasından seçim yapın. Yoksa varsayılan değer 400 olur. 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 gidip Özelleştir altındaki ayarları düzenleyin.

integer

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. Yoksa varsayılan değer 0 olur. 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 gidip Özelleştir altındaki ayarları düzenleyin.

object (Icon)

startIcon yerine kullanımdan kaldırıldı.

object (Icon)

Metnin önünde gösterilen simge.

string

text üzerinde görünen metin. Her zaman kısaltılır.

string

Zorunlu. Birincil metin.

Basit biçimlendirmeyi destekler. Metin biçimlendirme hakkında daha fazla bilgi için Google Chat uygulamalarında metni biçimlendirme ve Google Workspace Eklentilerinde metin biçimlendirme başlıklı makalelere göz atın.

boolean

Metni kaydırma ayarı. true değerine ayarlanırsa metin kaydırılır ve birden fazla satırda görüntülenir. Aksi takdirde metin kısaltılır.

Yalnızca text için geçerlidir, topLabel ve bottomLabel için geçerli değildir.

string

text altında görünen metin. Her zaman sarar.

object (OnClick)

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

object (Button)

Kullanıcının bir işlemi tetiklemek için tıklayabileceği bir düğme.

object (SwitchControl)

Kullanıcının durumunu değiştirip bir işlem tetiklemek için tıklayabileceği bir anahtar widget'ı.

object (Icon)

Metinden sonra görüntülenen bir simge.

Yerleşik ve özel simgeleri destekler.

string

Düğmenin içinde gösterilen metin.

object (Icon)

Düğmenin içinde gösterilen simge. Hem icon hem de text ayarlanırsa simge metinden önce görünür.

object (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 göre 0 ile 1 arasında bir kayan nokta sayısı olmalıdır. Bu sayılarda 0 (0/255) rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıda renk, maksimum yoğunluğunda kırmızıya ayarlanır:

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

alpha alanı, düğme rengi için kullanılamaz. Belirtilirse bu alan yoksayılır.

object (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).

boolean

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

string

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

Kullanıcılara düğmenin ne 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".

enum (Type)

İsteğe bağlı. Düğmenin türü. Ayarlanmazsa düğme türü varsayılan olarak OUTLINED olur. color alanı ayarlanmışsa düğme türü FILLED olarak zorlanır ve bu alan için ayarlanan tüm değerler yoksayılır.

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

number

[0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı.

number

[0, 1] aralığındaki bir değer olarak renkteki yeşil miktarı.

number

[0, 1] aralığındaki bir değer olarak renkteki mavi miktarı.

number

Bu rengin piksele uygulanması gereken oranı. Yani nihai piksel rengi şu denklemle tanımlanır:

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

Bu, 1.0 değerinin düz bir renge karşılık gelirken, 0.0 değerinin tamamen şeffaf bir renge karşılık geldiği anlamına gelir. Varsayılan değer ile ayarlanmamış değer arasında ayrım yapılabilmesi için bu işlemde basit bir kayan nokta skaler yerine sarmalayıcı mesaj kullanılır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açıkça 1,0 değeri verilmiş gibi).

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 edinmek için Form verilerini alma başlıklı makaleyi inceleyin.

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 edinmek için Form verilerini alma başlıklı makaleyi inceleyin.

boolean

true olduğunda anahtar seçilidir.

object (Action)

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

enum (ControlType)

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

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

object (Button)

Düğme dizisi.

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 bölümüne bakın.

string

Kullanıcı arayüzündeki 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ını öğrenmek istiyorsanız 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ılara belirli bir değer girmelerini isteyerek yardımcı olmayı amaçlayan metin. Bu metin her zaman görünür durumdadır.

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

string

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

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

enum (Type)

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

object (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 dizisi açma verilebilir.

object (Suggestions)

Kullanıcıların girebileceği önerilen değerler. Bu değerler, kullanıcılar metin giriş alanını 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 anlayabileceği değerler girmesine yardımcı olur. JavaScript'ten bahsederken bazı kullanıcılar javascript, bazı kullanıcılar ise java script yazabilir. Öneriler sunmak JavaScript kullanıcıların uygulamanızla nasıl etkileşime gireceğini standartlaştırabilir.

Belirtildiği durumlarda, TextInput.type her zaman MULTIPLE_LINE olarak ayarlanmış olsa bile SINGLE_LINE olur.

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

object (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.

object (Validation)

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

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 Eklentilerinde kullanılamaz.

Action

Navigation

Gösterilen kartları gönderin veya güncelleyin.

Card

Kart yığını, bir kartı kart yığınına aktarır.

Card

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

object (SuggestionItem)

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

string

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

integer

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

enum (InputType)

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

string

Zorunlu. Form girişi etkinliğindeki seçim girişini tanımlayan ad.

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

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 bir iş kaydının aciliyetini açılır menüden seçiyorsa etiket "Aciliyet" veya "Aciliyeti seçin" olabilir.

enum (SelectionType)

Kullanıcılara widget'ta gösterilen öğelerin türü SelectionInput 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.

object (SelectionItem)

Seçilebilir öğe dizisi. Örneğin, bir radyo düğmesi veya onay kutusu dizisi. En fazla 100 öğeyi destekler.

object (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 bölümüne bakın.

integer

Ç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.

integer

Çoklu seçim menüleri için, kullanıcının menü önerilen seçim öğelerini döndürmeden önce girdiği metin karakterlerinin sayısı.

Ayarlanmazsa çoklu seçim menüsü aşağıdaki varsayılan değerleri kullanır:

• Menü statik bir SelectionInput öğe dizisi kullanıyorsa varsayılan olarak 0 karakterdir ve öğeler hemen diziden doldurulur.
• Menüde bir dinamik veri kaynağı (multi_select_data_source) kullanılıyorsa önerilen öğelerin döndürülmesi için veri kaynağını sorgulamadan önce varsayılan olarak 3 karakter kullanılır.

object (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.

object (Action)

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

object (PlatformDataSource)

Google Workspace'teki bir veri kaynağı.

string

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

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ılı bilgi edinmek için Form verilerini alma başlıklı makaleyi inceleyin.

boolean

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

string

Çoklu seçim menüleri için öğenin alanın yanında görüntülenen simgeye ait URL. text PNG ve JPEG dosyalarını destekler. HTTPS URL'si olmalıdır. Örneğin, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.

string

Çoklu seçim menüleri için öğenin alanının altında görüntülenen metin açıklaması veya etiket. text

enum (CommonDataSource)

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

object (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.

object (ChatClientDataSourceMarkup)

Google Chat'ten bir veri kaynağı.

object (SpaceDataSource)

Kullanıcının üyesi olduğu Google Chat alanları.

boolean

true değerine ayarlanırsa çoklu seçim menüsü, mevcut Google Chat alanını varsayılan olarak öğe olarak seçer.

string

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

Form girişleriyle çalışma hakkında ayrıntılı bilgi edinmek 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.

enum (DateTimePickerType)

Widget'ın tarih, saat veya tarih ve saat girişini destekleyip desteklemediği.

string (int64 format)

Unix dönem zamanından itibaren widget'ta gösterilen varsayılan değer (milisaniye cinsinden).

Değeri, seçicinin türüne göre belirtin ( DateTimePickerType):

• DATE_AND_TIME : UTC'de bir takvim tarihi ve saati. Örneğin, 1 Ocak 2023 saat 12:00 (UTC) için 1672574400000 değerini kullanın.
• DATE_ONLY : UTC'de 00:00:00 olan 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'yi temsil etmek için 43200000 (veya 12 * 60 * 60 * 1000) kullanın.

integer

UTC ile saat dilimi arasındaki farkı dakika cinsinden temsil eden sayı. Ayarlanırsa valueMsEpoch belirtilen saat diliminde gösterilir. Ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.

object (Action)

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

object (Validation)

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

string

Izgara başlığında gösterilen metin.

object (GridItem)

Izgarada gösterilecek öğeler.

object (BorderStyle)

Her ızgara öğesine uygulanacak kenar stili.

integer

Izgarada görüntülenecek sütun sayısı. Bu alan belirtilmezse varsayılan bir değer kullanılır ve bu varsayılan değer, ızgaranın gösterildiği yere (ileti dizisi veya yardımcı) bağlı olarak farklıdır.

object (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.

string

Bu ızgara öğesi için kullanıcı tarafından belirtilen bir tanımlayıcı. Bu tanımlayıcı, üst ızgaranın onClick callback parametrelerinde döndürülür.

object (ImageComponent)

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

string

Izgara öğesinin başlığı.

string

Izgara öğesinin alt başlığı.

enum (GridItemLayout)

Izgara öğesi için kullanılacak düzen.

string

Resim URL'si.

string

Resmin erişilebilirlik etiketi.

object (ImageCropStyle)

Resme uygulanacak kırpma stili.

object (BorderStyle)

Resme uygulanacak kenarlık stili.

enum (ImageCropType)

Kırpma türü.

number

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
}

enum (BorderType)

Kenarlık türü.

object (Color)

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

Çizgi 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 sayılarda 0 (0/255) rengin yokluğunu, 1 (255/255) ise rengin maksimum yoğunluğunu temsil eder.

Örneğin, aşağıda renk, maksimum yoğunluğunda kırmızıya ayarlanır:

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

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

integer

Kenarlık için köşe yarıçapı.

object (Column)

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

enum (HorizontalSizeStyle)

Bir sütunun, kartın genişliğini nasıl dolduracağını belirtir.

enum (HorizontalAlignment)

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

enum (VerticalAlignment)

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

object (Widgets)

Bir sütuna dahil edilen widget dizisi. Widget'lar belirtildikleri sırayla görünür.

object (TextParagraph)

TextParagraph widget'ı.

object (Image)

Image widget'ı.

object (DecoratedText)

DecoratedText widget'ı.

object (ButtonList)

ButtonList widget'ı.

object (TextInput)

TextInput widget'ı.

object (SelectionInput)

SelectionInput widget'ı.

object (DateTimePicker)

DateTimePicker widget'ı.

object (ChipList)

ChipList widget'ı. Google Chat uygulamalarında kullanılabilir, Google Workspace Eklentilerinde kullanılamaz.

enum (Layout)

Belirtilen çip listesi düzeni.

object (Chip)

Bir çip dizisi.

object (Icon)

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

string

Çipin içinde gösterilen metin.

object (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).

boolean

Ç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 kullanın.

boolean

Çipin etkin durumda olup olmadığını ve kullanıcı işlemlerini yoksayıp yoksamadığını belirtir. Varsayılan olarak false değerine ayarlanır.

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.

enum (HorizontalAlignment)

Genişletme ve daraltma düğmesinin yatay hizası.

object (Button)

İsteğe bağlı. Bölümü genişletmek 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 olmayacaktır. Bu alan ayarlanmazsa varsayılan düğme kullanılır.

object (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.

string

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

object (OnClick)

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

object (Button)

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

object (Button)

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