Got 5 minutes? Help us improve the Google Chat developer documentation by taking a quick survey.

Tarih ve saat seçici

DateTimePicker widget'ı, kullanıcıların tarih, saat veya hem tarih hem de saat girmelerine olanak tanır.

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ılardan bilgileri doğru girmelerini isteyen bir hata gösterir.

Kullanıcıların girdiği tarih ve saat değerlerini işlemek için Form verilerini alma bölümüne bakın.

Örnek

Aşağıda, üç farklı DateTimePicker widget türünden oluşan bir kart gösterilmektedir:

JSON gösterimi ve alanları

JSON gösterimi
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
Alanlar
name

string

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

Form girişleriyle çalışma hakkında ayrıntılı bilgi için Form verilerini alma bölümüne bakın.

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

enum (DateTimePickerType)

Widget'ın tarih, saat veya tarih ve saat girmeyi destekleyip desteklemediği.

valueMsEpoch

string (int64 format)

Unix sıfır zamanından bu yana geçen milisaniye cinsinden widget'ta görüntülenen varsayılan değer.

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

  • DATE_AND_TIME : UTC saat diliminde takvim tarihi ve saati. Örneğin, 1 Ocak 2023 saat 12:00'yi (UTC) temsil etmek için 1672574400000 kullanın.
  • DATE_ONLY : 00:00:00 (UTC) olan bir takvim tarihi. Örneğin, 1 Ocak 2023'ü temsil etmek için 1672531200000 değerini kullanın.
  • TIME_ONLY : UTC saat diliminde Örneğin, 12:00'yi temsil etmek için 43200000 (veya 12 * 60 * 60 * 1000) kullanın.
timezoneOffsetDate

integer

Saat diliminin UTC ile dakika cinsinden farkını gösteren sayı. Ayarlanırsa valueMsEpoch, belirtilen saat diliminde görüntülenir. Politika ayarlanmazsa değer varsayılan olarak kullanıcının saat dilimi ayarına ayarlanır.

onChangeAction

object (Action)

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

Tarih/Saat Seçici Türü

Sıralamalar
DATE_AND_TIME Kullanıcılar tarih ve saat girer.
DATE_ONLY Kullanıcılar tarih girer.
TIME_ONLY Kullanıcılar zaman girişi yapar.

İşlem

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

JSON gösterimi
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Alanlar
function

string

İçeren öğe tıklandığında veya iki tarafa da etkinleştirildiğinde çağrılacak özel bir işlev.

Örneğin kullanımı, Etkileşimli kartlar oluşturma konusuna bakın.

parameters[]

object (ActionParameter)

İşlem parametrelerinin listesi.

loadIndicator

enum (LoadIndicator)

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

persistValues

boolean

İşlemden sonra form değerlerinin devam edip etmediğini belirtir. Varsayılan değer: false.

true ise işlem tetiklendikten sonra form değerleri kalır. İşlem işlenirken kullanıcının değişiklik yapmasına izin vermek için LoadIndicator öğesini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin ResponseType değerini de UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId öğesinin aynısını kullanmanız gerekir.

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

interaction

enum (Interaction)

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

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

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

Bir interaction belirtildiğinde, uygulama özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction OPEN_DIALOG olarak ayarlandığında uygulama bir iletişim kutusunu 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ı sadeleştirilir ve istemcide hiçbir şey gösterilmez.

İşlem Parametresi

İş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 gelecek hafta ertele. Dize parametreleri listesinde erteleme türünü ve erteleme süresini ileten action method = snooze() kullanabilirsiniz.

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

JSON gösterimi
{
  "key": string,
  "value": string
}
Alanlar
key

string

İşlem komut dosyası için parametrenin adı.

value

string

Parametrenin değeri.

Yük Göstergesi

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

Sıralamalar
SPINNER İçeriğin yüklenmekte olduğunu belirtmek için bir döner simge görüntüler.
NONE Hiçbir şey gösterilmez.

Etkileşim

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

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

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

Bir interaction belirtildiğinde, uygulama özel etkileşimli şekillerde yanıt verebilir. Örneğin, interaction OPEN_DIALOG olarak ayarlandığında uygulama bir iletişim kutusunu 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ı sadeleştirilir 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şimde bulunmak için kullandığı pencereli, kart tabanlı bir arayüz olan iletişim kutusunu açar.

Chat uygulamaları yalnızca kart mesajlarına yapılan düğme tıklamalarına yanıt olarak desteklenir.

Google Workspace Eklentileri tarafından desteklenmez. Bir eklenti için belirtilirse, kartın tamamı sadeleştirilir ve istemcide hiçbir şey gösterilmez.

Sorunu giderin

Bir Google Chat uygulaması veya kart hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu" veya "İsteğiniz işleme alınamıyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, bir kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde bir hata mesajı gösterilmese de, Chat uygulamaları için hata günlük kaydı etkinken hataları düzeltmenize yardımcı olmak üzere açıklayıcı hata mesajları ve günlük verileri mevcuttur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım almak için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.