Chat uygulamaları tarafından desteklenmez. Sohbet uygulamaları desteği yakında geliyor.
DateTimePicker
widget'ı, kullanıcıların tarih, saat veya hem tarih hem de saat belirtmesini sağlar.
Kullanıcıların metin girişlerini kabul eder, ancak kullanıcıların biçimlendirilmiş tarihleri ve saatleri girmelerine yardımcı olacak etkileşimli bir tarih ve saat seçici içerir. Kullanıcılar tarih veya saati yanlış girerse widget, kullanıcılardan doğru biçimi girmelerini isteyen bir hata gösterir.
Chat uygulamaları, form giriş etkinlikleri sırasında kullanıcılar tarafından girilen tarih ve saatlerin 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ı makaleye bakın.
Örnek
Aşağıdaki resimde, DateTimePicker
widget'ından oluşan bir kart gösterilmektedir:

Kartın JSON'i şöyledir:
JSON
{
"cardsV2": [
{
"cardId": "exampleCard",
"card": {
"sections": [
{
"widgets": [
{
"textParagraph": {
"text": "A datetime picker widget with both date and time:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "meeting",
"type": 'DATE_AND_TIME',
}
},
{
"textParagraph": {
"text": "A datetime picker widget with just date:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "Choose a date",
"type": 'DATE_ONLY',
}
},
{
"textParagraph": {
"text": "A datetime picker widget with just time:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "Select a time",
"type": 'TIME_ONLY',
}
},
]
}
]
}
}
]
}
DateTimePicker
JSON gösterimi ve alanları
JSON gösterimi |
---|
{ "name": string, "label": string, "type": enum ( |
Alanlar | |
---|---|
name
|
Tarih giriş seçicisinin 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ı makaleye bakın. |
label
|
Kullanıcılardan tarih, saat veya tarih bilgisi girmelerini isteyen metin. Kullanıcının uygulamanızın ihtiyaç duyduğu bilgileri girmesine yardımcı olacak bir metin belirtin. Örneğin, kullanıcılar bir randevu belirliyorsa "Randevu tarihi" veya "Randevu tarihi ve saati" gibi bir etiket uygun olabilir. |
type
|
Tarih ve saat seçicinin desteklediği tarih ve saat türü. |
valueMsEpoch
|
Kullanıcı girişinden veya önceki kullanıcı girişinden önce varsayılan olarak gösterilen değer (milisaniye cinsinden). Dönem zamanı .
|
timezoneOffsetDate
|
UTC saat dilimine göre saat dilimi farkını dakika cinsinden gösteren sayı. Ayarlanırsa
|
onChangeAction
|
Kullanıcı, tarih ve saat dilimi seçici arayüzünden Kaydet veya Temizle seçeneğini tıkladığında tetiklenir. |
DateTimePickerType
Sıralamalar | |
---|---|
DATE_AND_TIME
|
Kullanıcı bir tarih ve saat seçebilir. |
DATE_ONLY
|
Kullanıcı yalnızca bir tarih seçebilir. |
TIME_ONLY
|
Kullanıcı yalnızca saat seçebilir. |
Action
Form gönderildiğinde davranışı açıklayan bir işlem. Örneğin, formu işlemek için Apps Komut Dosyası çağırılabilir. İşlem tetiklenirse form değerleri sunucuya gönderilir.
JSON gösterimi |
---|
{ "function": string, "parameters": [ { object ( |
Alanlar | |
---|---|
function
|
Kapsayıcı öğe tıklandığında veya alt özellik etkinleştirildiğinde çağrılan özel işlev. Örneğin, Etkileşimli kart oluşturma bölümüne göz atın. |
parameters[]
|
İşlem parametrelerinin listesi. |
loadIndicator
|
Harekete geçirici mesaj gösterilirken işlemin gösterdiği yükleme göstergesini belirtir. |
persistValues
|
Form değerlerinin işlemden sonra da devam edip etmediğini belirtir. Varsayılan değer:
|
interaction
|
İsteğe bağlı. İletişim kutusu açılırken gerekir. Bir kullanıcının etkileşimine yanıt olarak yapılması gerekenler (ör. bir kullanıcı, kart mesajındaki düğmeyi tıkladığında).
Belirtilmemesi halinde uygulama, normal şekilde bir
Uygulama,
Belirtildiğinde yükleme göstergesi gösterilmez. Chat uygulamaları tarafından desteklenir ancak Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez. |
ActionParameter
İşlem yöntemi çağrıldığında verilecek dize parametrelerinin listesi. Örneğin, şu üç erteleme düğmesini kullanabilirsiniz: "ertele", "1 gün ertele", "ertesi hafta ertele". Dize parametreleri listesinde erteleme türünü ve erteleme zamanını ileterek işlem yöntemi = pause() işlemini kullanabilirsiniz.
Daha fazla bilgi için CommonEventObject bölümüne bakın.
JSON gösterimi |
---|
{ "key": string, "value": string } |
Alanlar | |
---|---|
key
|
İşlem komut dosyası için parametrenin adı. |
value
|
Parametrenin değeri. |
LoadIndicator
Harekete geçirici mesaj gösterilirken işlemin gösterdiği yükleme göstergesini belirtir.
Sıralamalar | |
---|---|
SPINNER
|
İçeriğin yüklendiğini belirtmek için bir döner simge görüntüler. |
NONE
|
Hiçbir şey gösterilmez. |
Interaction
İsteğe bağlı. İletişim kutusu açılırken gerekir.
Bir kullanıcının etkileşimine yanıt olarak yapılması gerekenler (ör. bir kullanıcı, kart mesajındaki düğmeyi tıkladığında).
Belirtilmemesi halinde uygulama, normal şekilde bir
action
işlemi (bağlantı açma veya bir işlevi çalıştırma gibi) çalıştırarak yanıt verir.
Uygulama,
interaction
belirterek özel etkileşimli şekillerde yanıt verebilir. Örneğin,
interaction
öğesini
OPEN_DIALOG
olarak ayarladığınızda, uygulama bir
iletişim kutusu
açabilir.
Belirtildiğinde yükleme göstergesi gösterilmez.
Chat uygulamaları tarafından desteklenir ancak Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez.
Sıralamalar | |
---|---|
INTERACTION_UNSPECIFIED
|
Varsayılan değer.
action
normal şekilde çalışır.
|
OPEN_DIALOG
|
Chat uygulamalarının kullanıcılarla etkileşim kurmak için kullandığı, pencereye dayalı, 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. Google Workspace eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı çıkarılır ve istemcide hiçbir şey gösterilmez. |