DateTimePicker (Çok yakında)

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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:

Google Chat'te Metin Paragrafı widget'ını gösteren bir kart mesajı.
Şekil 1: Google Chat'te, üç tarih widget'ını gösteren bir kart mesajı. Hem tarih hem de saat için, biri yalnızca tarih için ve diğeri de yalnızca saat için.

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 (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
Alanlar
name

string

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

string

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

enum ( DateTimePickerType )

Tarih ve saat seçicinin desteklediği tarih ve saat türü.

valueMsEpoch

string ( int64 format)

Kullanıcı girişinden veya önceki kullanıcı girişinden önce varsayılan olarak gösterilen değer (milisaniye cinsinden). Dönem zamanı .

DATE_AND_TIME türü için tam dönem değeri kullanılır.

DATE_ONLY türü için yalnızca sıfır zamanının tarihi kullanılır.

TIME_ONLY türünde, yalnızca sıfır zamanı kullanılır. Örneğin, 03:00 değerini göstermek için sıfır zamanı 3 * 60 * 60 * 1000 olarak ayarlayın.

timezoneOffsetDate

integer

UTC saat dilimine göre saat dilimi farkını dakika cinsinden gösteren sayı. Ayarlanırsa valueMsEpoch belirtilen saat diliminde görüntülenir. Ayarlanmazsa istemci tarafında kullanıcının saat dilimi ayarını kullanır.

onChangeAction

object ( Action )

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 (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Alanlar
function

string

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[]

object ( ActionParameter )

İşlem parametrelerinin listesi.

loadIndicator

enum ( LoadIndicator )

Harekete geçirici mesaj gösterilirken işlemin gösterdiği yükleme göstergesini belirtir.

persistValues

boolean

Form değerlerinin işlemden sonra da devam edip etmediğini belirtir. Varsayılan değer: false .

true değeri belirlenirse form değerleri işlem tetiklendikten sonra da kalır. Kullanıcının işlem sırasında değişiklik yapmasına izin vermek için LoadEndator değerini NONE olarak ayarlayın. Chat uygulamalarındaki kart mesajları için işlemin Yanıt Türü 'nü UPDATE_MESSAGE olarak ayarlamanız ve işlemi içeren karttaki cardId cardId özelliğini kullanmanız gerekir.

false değeri belirlenirse işlem tetiklendiğinde form değerleri temizlenir. İşlem sırasında kullanıcının değişiklik yapmasını engellemek için LoadEndator değerini SPINNER olarak ayarlayın.

interaction

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

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

string

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

value

string

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.