DateTimePicker (disponibile a breve)

Il widget DateTimePicker consente agli utenti di specificare una data, un'ora o una data e un'ora.

Accetta l'input di testo degli utenti, ma è disponibile un selettore interattivo di data e ora che consente agli utenti di inserire date e ore formattate. Se gli utenti inseriscono una data o un'ora in modo errato, il widget mostra un errore che richiede agli utenti di inserire il formato corretto.

Le app di chat ricevono e possono elaborare il valore delle date e degli orari inseriti dall'utente durante gli eventi di input del modulo. Per informazioni dettagliate sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo.

Funzionalità non supportata dalle app di chat. Il supporto per le app di chat sarà disponibile a breve.

Esempio

La seguente immagine mostra una scheda composta da un widget DateTimePicker:

Un messaggio destinato a una scheda in Google Chat che mostra un widget Paragrafo di testo.
Figura 1: un messaggio della scheda in Google Chat che mostra tre widget DateTimePicker: uno per la selezione di data e ora, uno per la data e uno per l'orario.

Ecco il codice JSON della scheda:

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 Rappresentazione e campi JSON

Rappresentazione JSON
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
Campi
name

string

Il nome con cui viene identificato il selettore di data e ora in un evento di input del modulo.

Per maggiori dettagli sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo .

label

string

Il testo che chiede agli utenti di inserire una data, un'ora o una data/ora.

Specifica del testo che aiuti l'utente a inserire le informazioni di cui la tua app ha bisogno. Ad esempio, se gli utenti stanno fissando un appuntamento, l'etichetta "Data/ora dell'appuntamento" o "Data e ora dell'appuntamento" potrebbero andare bene.

type

enum ( DateTimePickerType )

Tipo di data e ora supportati dal selettore data/ora.

valueMsEpoch

string ( int64 format)

Il valore visualizzato come valore predefinito prima dell'input dell'utente o dell'input dell'utente precedente, espresso in millisecondi ( Ora del periodo ).

Per il tipo DATE_AND_TIME , viene utilizzato il valore completo del periodo.

Per il tipo DATE_ONLY , viene utilizzata solo la data dell'ora del periodo.

Per il tipo TIME_ONLY , viene utilizzato solo l'orario. Ad esempio, per rappresentare le 03:00, imposta l'ora del periodo su 3 * 60 * 60 * 1000 .

timezoneOffsetDate

integer

Il numero che rappresenta la differenza di fuso orario dal fuso orario UTC, in minuti. Se impostato, valueMsEpoch viene visualizzato nel fuso orario specificato. Se non viene configurato, utilizza l'impostazione del fuso orario dell'utente sul lato client.

onChangeAction

object ( Action )

Si attiva quando l'utente fa clic su Salva o Cancella dall'interfaccia del selettore data/ora.

DateTimePickerType

Enum
DATE_AND_TIME L'utente può selezionare una data e un'ora.
DATE_ONLY L'utente può selezionare solo una data.
TIME_ONLY L'utente può selezionare solo un orario.

Action

Azione che descrive il comportamento al momento dell'invio del modulo. Ad esempio, uno script di Apps Script può essere richiamato per gestire il modulo.

Rappresentazione JSON
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Campi
function

string

Una funzione personalizzata da richiamare quando viene fatto clic sull'elemento contenitore o attivato in modo orizzontale.

Ad esempio, consulta Creare schede interattive .

parameters[]

object ( ActionParameter )

Elenco dei parametri delle azioni.

loadIndicator

enum ( LoadIndicator )

Specifica l'indicatore di caricamento visualizzato dall'azione durante l'invito all'azione.

persistValues

boolean

Indica se i valori del modulo persistono dopo l'azione. Il valore predefinito è false .

Se true , i valori del modulo rimangono dopo l'attivazione dell'azione. Quando utilizzi LoadIndicator.NONE per le azioni, è consigliabile persistValues = true e assicurare che eventuali modifiche apportate dall'utente dopo l'invio del modulo o le azioni di modifica al server non vengano sovrascritte dalla risposta.

Se false , i valori del modulo vengono cancellati quando viene attivata l'azione. Se persistValues è impostato su false , è vivamente consigliato utilizzare la scheda LoadIndicator.SPINNER per tutte le azioni, poiché questa operazione blocca la UI per garantire che l'utente non apporti modifiche durante l'elaborazione.

Funzionalità non supportata dalle app di chat.

interaction

enum ( Interaction )

(Facoltativo) Obbligatorio quando apri una finestra di dialogo .

Che cosa fare in risposta a un'interazione con un utente, ad esempio se un utente fa clic sul pulsante nel messaggio di una scheda.

Se non specificati, l'app risponde eseguendo un action (come l'apertura di un link o eseguendo una funzione) come di consueto.

Se specifichi un interaction , l'app può rispondere in modi speciali e interattivi. Ad esempio, impostando interaction su OPEN_DIALOG , l'app può aprire una finestra di dialogo .

Se specificato, non viene mostrato un indicatore di caricamento.

Supportato dalle app di chat, ma non dai componenti aggiuntivi di Google Workspace. Se si specifica un componente aggiuntivo, si rimuove l'intera scheda e non viene mostrato nulla nel client.

ActionParameter

Elenco di parametri stringa da fornire quando viene richiamato il metodo dell'azione. Ad esempio, considera tre pulsanti di posticipazione: posticipa ora, posticipa di 1 giorno, posticipa la settimana successiva Puoi utilizzare il metodo di azione = posticipa(), passando il tipo di posticipazione e il tempo di posticipazione nell'elenco dei parametri della stringa.

Per scoprire di più, consulta CommonEventObject .

Rappresentazione JSON
{
  "key": string,
  "value": string
}
Campi
key

string

Il nome del parametro per lo script di azione.

value

string

Il valore del parametro.

LoadIndicator

Specifica l'indicatore di caricamento visualizzato dall'azione durante l'invito all'azione.

Enum
SPINNER Viene visualizzata una rotellina che indica che i contenuti sono in fase di caricamento.
NONE Nessun messaggio visualizzato.

Interaction

(Facoltativo) Obbligatorio quando apri una finestra di dialogo .

Che cosa fare in risposta a un'interazione con un utente, ad esempio se un utente fa clic sul pulsante nel messaggio di una scheda.

Se non specificati, l'app risponde eseguendo un action (come l'apertura di un link o eseguendo una funzione) come di consueto.

Se specifichi un interaction , l'app può rispondere in modi speciali e interattivi. Ad esempio, impostando interaction su OPEN_DIALOG , l'app può aprire una finestra di dialogo .

Se specificato, non viene mostrato un indicatore di caricamento.

Supportato dalle app di chat, ma non dai componenti aggiuntivi di Google Workspace. Se si specifica un componente aggiuntivo, si rimuove l'intera scheda e non viene mostrato nulla nel client.

Enum
INTERACTION_UNSPECIFIED Valore predefinito. action viene eseguito normalmente.
OPEN_DIALOG

Consente di aprire una finestra di dialogo , un'interfaccia con finestra basata su schede che le app di chat utilizzano per interagire con gli utenti.

Supportato solo dalle app di Chat in risposta ai clic sui pulsanti nei messaggi delle schede.

Non supportati dai componenti aggiuntivi di Google Workspace. Se si specifica un componente aggiuntivo, si rimuove l'intera scheda e non viene mostrato nulla nel client.