DateTimePicker (em breve)

Não há suporte para os apps de chat. O suporte dos apps de chat estará disponível em breve.

O widget DateTimePicker permite que os usuários especifiquem uma data, hora ou data e hora.

Ele aceita a entrada de texto de usuários, mas apresenta um seletor de data e hora interativo que ajuda os usuários a inserir datas e horários formatados. Se os usuários inserirem uma data ou hora incorretamente, o widget mostrará um erro solicitando que os usuários insiram o formato correto.

Os apps de chat recebem e podem processar o valor de datas e horários inseridos pelo usuário durante eventos de entrada do formulário. Veja mais detalhes sobre como trabalhar com entradas de formulário em Receber dados do formulário.

Exemplo

A imagem a seguir mostra um card que consiste em um widget DateTimePicker:

Figura 1: uma mensagem com card no Google Chat que mostra três widgets DateTimePicker: um para selecionar a data e a hora, um para a data e outro.

Este é o JSON do cartão:

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 representação e campos JSON

Representação JSON
{ "name": string, "label": string, "type": enum (DateTimePickerType), "valueMsEpoch": string, "timezoneOffsetDate": integer, "onChangeAction": { object (Action) } }

Campos
name	string O nome pelo qual o seletor de data e hora é identificado em um evento de entrada do formulário. Para ver detalhes sobre como trabalhar com entradas de formulário, consulte Receber dados de formulário .
label	string O texto que solicita que os usuários insiram data, hora ou data e hora. Especifique o texto que ajuda o usuário a inserir as informações necessárias do app. Por exemplo, se os usuários estiverem marcando um horário, um marcador como "Data do agendamento" ou "Data e hora do agendamento" pode funcionar.
type	enum ( DateTimePickerType ) Que tipo de entrada de data e hora é compatível com o seletor de data e hora.
valueMsEpoch	string ( int64 format) O valor exibido como padrão antes da entrada do usuário ou da entrada do usuário anterior, representado em milissegundos ( Époch time ). Para o tipo DATE_AND_TIME , o valor de época completo é usado. Para o tipo DATE_ONLY , apenas a data da hora de época é usada. Para o tipo TIME_ONLY , apenas o horário do período é usado. Por exemplo, para representar 3h, defina o horário da época como 3 * 60 * 60 * 1000 .
timezoneOffsetDate	integer O número que representa a diferença de fuso horário em relação ao UTC, em minutos. Se definido, o valueMsEpoch será exibido no fuso horário especificado. Se não for definido, será usada a configuração de fuso horário do usuário no lado do cliente.
onChangeAction	object ( Action ) Acionado quando o usuário clica em Salvar ou Limpar na interface do seletor de data e hora.

DateTimePickerType

Enums
DATE_AND_TIME	O usuário pode selecionar uma data e hora.
DATE_ONLY	O usuário só pode selecionar uma data.
TIME_ONLY	O usuário só pode selecionar um horário.

Action

Uma ação que descreve o comportamento quando o formulário é enviado. Por exemplo, um Apps Script pode ser invocado para processar o formulário. Se a ação for acionada, os valores do formulário serão enviados ao servidor.

Representação JSON
{ "function": string, "parameters": [ { object (ActionParameter) } ], "loadIndicator": enum (LoadIndicator), "persistValues": boolean, "interaction": enum (Interaction) }

Campos
function	string Uma função personalizada a ser invocada quando o elemento que contém o conteúdo for clicado ou ativado por outros motivos. Para ver exemplos de uso, consulte Criar cards interativos .
parameters[]	object ( ActionParameter ) Lista de parâmetros de ação.
loadIndicator	enum ( LoadIndicator ) Especifica o indicador de carregamento que a ação exibe ao fazer a chamada para a ação.
persistValues	boolean Indica se os valores do formulário persistem após a ação. O valor padrão é false . Se true , os valores do formulário permanecem após o acionamento da ação. Para permitir que o usuário faça alterações durante o processamento da ação, defina LoadIndicator como NONE . Para mensagens do cartão em apps de chat, você também precisa definir o ResponseType da ação como UPDATE_MESSAGE e usar o mesmo cardId do cartão que continha a ação. Se false , os valores do formulário serão apagados quando a ação for acionada. Para evitar que o usuário faça alterações enquanto a ação é processada, defina LoadIndicator como SPINNER .
interaction	enum ( Interaction ) Opcional. Obrigatório ao abrir uma caixa de diálogo . O que fazer em resposta a uma interação com o usuário, como clicar em um botão em uma mensagem de card. Se não for especificado, o app responderá executando uma action , como a abertura de um link ou a execução de uma função, normalmente. Ao especificar um interaction , o app pode responder de maneiras interativas especiais. Por exemplo, definindo interaction como OPEN_DIALOG , o app pode abrir uma caixa de diálogo . Quando especificado, um indicador de carregamento não é mostrado. Compatível com apps de chat, mas não com complementos do Google Workspace. Se especificado para um complemento, todo o cartão será retirado, e nada será exibido no cliente.

ActionParameter

Lista de parâmetros de string a serem fornecidos quando o método de ação for invocado. Por exemplo, considere estes três botões: adiar agora, adiar 1 dia ou adiar semana que vem. Você pode usar o método de ação = sleep(), transmitindo o tipo de adiamento e o tempo de adiamento na lista de parâmetros de string.

Para saber mais, consulte CommonEventObject .

Representação JSON
{ "key": string, "value": string }

Campos
key	string Nome do parâmetro do script de ação.
value	string O valor do parâmetro.

LoadIndicator

Especifica o indicador de carregamento que a ação exibe ao fazer a chamada para a ação.

Enums
SPINNER	Exibe um ícone de carregamento indicando que o conteúdo está sendo carregado.
NONE	Nada é exibido.

Interaction

Opcional. Obrigatório ao abrir uma caixa de diálogo .

O que fazer em resposta a uma interação com o usuário, como clicar em um botão em uma mensagem de card.

Se não for especificado, o app responderá executando uma action , como a abertura de um link ou a execução de uma função, normalmente.

Ao especificar um interaction , o app pode responder de maneiras interativas especiais. Por exemplo, definindo interaction como OPEN_DIALOG , o app pode abrir uma caixa de diálogo .

Quando especificado, um indicador de carregamento não é mostrado.

Compatível com apps de chat, mas não com complementos do Google Workspace. Se especificado para um complemento, todo o cartão será retirado, e nada será exibido no cliente.

Enums
INTERACTION_UNSPECIFIED	Valor padrão. O action é executado normalmente.
OPEN_DIALOG	Abre uma caixa de diálogo , uma interface em janelas e baseada em cards que os apps de chat usam para interagir com os usuários. Esse recurso só é compatível com apps de chat em resposta a cliques em botões nas mensagens do card. Não é compatível com os complementos do Google Workspace. Se especificado para um complemento, todo o cartão será retirado, e nada será exibido no cliente.