Card

Es una interfaz de tarjeta que se muestra en un mensaje de Google Chat o en un complemento de Google Workspace.

Las tarjetas admiten un diseño definido, elementos interactivos de la IU, como botones, y contenido multimedia enriquecido, como imágenes. Usa tarjetas para presentar información detallada, recopilar información de los usuarios y guiarlos para que den el siguiente paso.

Diseña tarjetas y obtén una vista previa de ellas con el Creador de tarjetas.

Abre el Creador de tarjetas

Para aprender a compilar tarjetas, consulta la siguiente documentación:

Nota: Puedes agregar hasta 100 widgets por tarjeta. Si los widgets de una sección hacen que el recuento total supere los 100, se ignorará toda esa sección y todas las siguientes. Este límite se aplica tanto a los mensajes de tarjeta como a los diálogos en las apps de Google Chat, y a las tarjetas en los complementos de Google Workspace.

Ejemplo: Mensaje de tarjeta para una app de Google Chat

Ejemplo de tarjeta de contacto

Para crear el mensaje de tarjeta de ejemplo en Google Chat, usa el siguiente JSON:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
Representación JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  },
  "expressionData": [
    {
      object (ExpressionData)
    }
  ]
}
Campos
header

object (CardHeader)

Es el encabezado de la tarjeta. Un encabezado suele contener una imagen principal y un título. Los encabezados siempre aparecen en la parte superior de una tarjeta.
sections[]

object (Section)

Contiene una colección de widgets. Cada sección tiene su propio encabezado opcional. Las secciones se separan visualmente con una línea divisoria. Para ver un ejemplo en las apps de Google Chat, consulta Define una sección de una tarjeta.
sectionDividerStyle

enum (DividerStyle)

El estilo del divisor entre el encabezado, las secciones y el pie de página.
cardActions[]

object (CardAction)

Son las acciones de la tarjeta. Las acciones se agregan al menú de la barra de herramientas de la tarjeta. Admite hasta 10 elementos CardAction.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.

Por ejemplo, el siguiente JSON construye un menú de acciones de tarjeta con las opciones Settings y Send Feedback:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

Es el nombre de la tarjeta. Se usa como identificador de tarjeta en la navegación por tarjetas.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.
displayStyle

enum (DisplayStyle)

En los complementos de Google Workspace, establece las propiedades de visualización de peekCardHeader.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.
peekCardHeader

object (CardHeader)

Cuando se muestra contenido contextual, el encabezado de la tarjeta de vista previa actúa como un marcador de posición para que el usuario pueda navegar hacia adelante entre las tarjetas de la página principal y las tarjetas contextuales.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.
expressionData[]

object (ExpressionData)

Son los datos de expresión de la tarjeta.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

CardHeader

Representa un encabezado de tarjeta. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un encabezado.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
Campos
title

string

Obligatorio. Es el título del encabezado de la tarjeta. El encabezado tiene una altura fija: si se especifican un título y un subtítulo, cada uno ocupa una línea. Si solo se especifica el título, este ocupa ambas líneas.
subtitle

string

Es el subtítulo del encabezado de la tarjeta. Si se especifica, aparece en su propia línea debajo de title.
imageType

enum (ImageType)

Es la forma que se usa para recortar la imagen.

Disponible para las apps de Google Chat y los complementos de Google Workspace.
imageUrl

string

Es la URL HTTPS de la imagen en el encabezado de la tarjeta.
imageAltText

string

Es el texto alternativo de esta imagen que se usa para la accesibilidad.

Sección

Una sección contiene una colección de widgets que se renderizan de forma vertical en el orden en que se especifican.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "id": string,
  "collapseControl": {
    object (CollapseControl)
  }
}
Campos
header

string

Es el texto que aparece en la parte superior de una sección. Admite texto con formato HTML simple. Para obtener más información sobre cómo dar formato al texto, consulta Cómo dar formato al texto en las apps de Google Chat y Cómo dar formato al texto en los complementos de Google Workspace.
widgets[]

object (Widget)

Todos los widgets de la sección. Debe contener al menos un widget. Una tarjeta admite hasta 100 widgets en todas las secciones.
collapsible

boolean

Indica si esta sección se puede contraer.

Las secciones contraíbles ocultan algunos o todos los widgets, pero los usuarios pueden expandir la sección para revelar los widgets ocultos haciendo clic en Mostrar más. Los usuarios pueden volver a ocultar los widgets haciendo clic en Mostrar menos.

Para determinar qué widgets están ocultos, especifica uncollapsibleWidgetsCount.
uncollapsibleWidgetsCount

integer

Es la cantidad de widgets no contraíbles que permanecen visibles incluso cuando se contrae una sección.

Por ejemplo, cuando una sección contiene cinco widgets y el uncollapsibleWidgetsCount se establece en 2, los primeros dos widgets siempre se muestran y los últimos tres se contraen de forma predeterminada. El uncollapsibleWidgetsCount solo se tiene en cuenta cuando collapsible es true.
id

string

Es un ID único asignado a la sección que se usa para identificar la sección que se mutará. El ID tiene un límite de 64 caracteres y debe tener el formato [a-zA-Z0-9-]+.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
collapseControl

object (CollapseControl)

Opcional. Define el botón para expandir y contraer la sección. Este botón solo se mostrará si la sección se puede contraer. Si no se establece este campo, se usa el botón predeterminado.

Widget

Cada tarjeta se compone de widgets.

Un widget es un objeto compuesto que puede representar texto, imágenes, botones y otros tipos de objetos.

Representación JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "id": string,
  "visibility": enum (Visibility),
  "eventActions": [
    {
      object (EventAction)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
}
Campos
horizontalAlignment

enum (HorizontalAlignment)

Especifica si los widgets se alinean a la izquierda, a la derecha o al centro de una columna.
id

string

Es un ID único asignado al widget que se usa para identificar el widget que se mutará. El ID tiene un límite de 64 caracteres y debe tener el formato [a-zA-Z0-9-]+.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
visibility

enum (Visibility)

Especifica si el widget es visible o está oculto. El valor predeterminado es VISIBLE.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
eventActions[]

object (EventAction)

Especifica las acciones de eventos que se pueden realizar en el widget.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
Un widget solo puede tener uno de los siguientes elementos. Puedes usar varios campos de widget para mostrar más elementos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
textParagraph

object (TextParagraph)

Muestra un párrafo de texto. Admite texto con formato HTML simple. Para obtener más información sobre cómo dar formato al texto, consulta Cómo dar formato al texto en las apps de Google Chat y Cómo dar formato al texto en los complementos de Google Workspace.

Por ejemplo, el siguiente JSON crea un texto en negrita:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

object (Image)

Muestra una imagen.

Por ejemplo, el siguiente JSON crea una imagen con texto alternativo:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

object (DecoratedText)

Muestra un elemento de texto decorado.

Por ejemplo, el siguiente JSON crea un widget de texto decorado que muestra la dirección de correo electrónico:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

object (ButtonList)

Es una lista de botones.

Por ejemplo, el siguiente JSON crea dos botones. El primero es un botón de texto azul y el segundo es un botón de imagen que abre un vínculo:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

object (TextInput)

Muestra un cuadro de texto en el que los usuarios pueden escribir.

Por ejemplo, el siguiente JSON crea una entrada de texto para una dirección de correo electrónico:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Como otro ejemplo, el siguiente JSON crea una entrada de texto para un lenguaje de programación con sugerencias estáticas:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

object (SelectionInput)

Muestra un control de selección que permite a los usuarios elegir elementos. Los controles de selección pueden ser casillas de verificación, botones de selección, interruptores o menús desplegables.

Por ejemplo, el siguiente JSON crea un menú desplegable que permite a los usuarios elegir un tamaño:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

object (DateTimePicker)

Muestra un widget que permite a los usuarios ingresar una fecha, una hora o una fecha y hora.

Por ejemplo, el siguiente JSON crea un selector de fecha y hora para programar una cita:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}
divider

object (Divider)

Muestra un divisor de línea horizontal entre los widgets.

Por ejemplo, el siguiente JSON crea un divisor:

"divider": {
}
grid

object (Grid)

Muestra una cuadrícula con una colección de elementos.

Una cuadrícula admite cualquier cantidad de columnas y elementos. La cantidad de filas se determina según los límites superiores de la cantidad de elementos dividida por la cantidad de columnas. Una cuadrícula con 10 elementos y 2 columnas tiene 5 filas. Una cuadrícula con 11 elementos y 2 columnas tiene 6 filas.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Por ejemplo, el siguiente JSON crea una cuadrícula de 2 columnas con un solo elemento:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

object (Columns)

Muestra hasta 2 columnas.

Para incluir más de 2 columnas o usar filas, usa el widget Grid.

Por ejemplo, el siguiente JSON crea 2 columnas que contienen párrafos de texto:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

object (Carousel)

Contiene una colección de elementos CarouselCard, cada uno de los cuales contiene widgets anidados. Por ejemplo, esta es una representación JSON de un carrusel que contiene dos tarjetas de carrusel, cada una con un párrafo de texto:

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in the carousel."
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in the carousel."
          }
        }
      ]
    }
  ]
}
chipList

object (ChipList)

Es una lista de chips.

Por ejemplo, el siguiente JSON crea dos chips. El primero es un chip de texto y el segundo es un chip de ícono que abre un vínculo:

"chipList": {
  "chips": [
    {
      "label": "Edit",
      "disabled": true
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
Fin de los campos mutuamente excluyentes.

TextParagraph

Un párrafo de texto que admite formato. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un párrafo de texto con formato. Para obtener más información sobre cómo dar formato al texto, consulta Cómo dar formato al texto en las apps de Google Chat y Cómo dar formato al texto en los complementos de Google Workspace.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
Campos
text

string

Es el texto que se muestra en el widget.
maxLines

integer

Es la cantidad máxima de líneas de texto que se muestran en el widget. Si el texto supera la cantidad máxima de líneas especificada, el contenido excedente se oculta detrás de un botón Mostrar más. Si el texto es igual o más corto que la cantidad máxima de líneas especificada, no se muestra el botón Mostrar más.

El valor predeterminado es 0, en cuyo caso se muestra todo el contexto. Se ignoran los valores negativos.
textSyntax

enum (TextSyntax)

La sintaxis del texto. Si no se establece, el texto se renderiza como HTML.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

TextSyntax

Es la sintaxis que se usa para dar formato al texto.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Enums
TEXT_SYNTAX_UNSPECIFIED El texto se renderiza como HTML si no se especifica.
HTML El texto se renderiza como HTML. Este es el valor predeterminado.
MARKDOWN El texto se renderiza como Markdown.

Imagen

Es una imagen que se especifica con una URL y puede tener una acción onClick. Para ver un ejemplo, consulta Agrega una imagen.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
Campos
imageUrl

string

Es la URL HTTPS que aloja la imagen.

Por ejemplo:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

object (OnClick)

Cuando un usuario hace clic en la imagen, se activa esta acción.
altText

string

Es el texto alternativo de esta imagen que se usa para la accesibilidad.

DecoratedText

Es un widget que muestra texto con decoraciones opcionales, como una etiqueta arriba o abajo del texto, un ícono delante del texto, un widget de selección o un botón después del texto. Para ver un ejemplo en las apps de Google Chat, consulta Muestra texto con texto decorativo.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "onClick": {
    object (OnClick)
  },

  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
}
Campos
icon
(deprecated)

object (Icon)

Se dio de baja y se reemplazó por startIcon.
startIcon

object (Icon)

Es el ícono que se muestra delante del texto.
startIconVerticalAlignment

enum (VerticalAlignment)

Opcional. Es la alineación vertical del ícono de inicio. Si no se establece, el ícono se centrará verticalmente.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.
topLabel

string

Es el texto que aparece sobre text. Siempre se trunca.
topLabelText

object (TextParagraph)

Equivalente de TextParagraph de topLabel. Siempre se trunca. Permite un formato más complejo que topLabel.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.
text

string

Obligatorio. Es el texto principal.

Admite formato simple. Para obtener más información sobre cómo dar formato al texto, consulta Cómo dar formato al texto en las apps de Google Chat y Cómo dar formato al texto en los complementos de Google Workspace.
contentText

object (TextParagraph)

Equivalente de TextParagraph de text. Permite un formato más complejo que text.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.
wrapText

boolean

Es el parámetro de configuración de ajuste de texto. Si es true, el texto se ajusta y se muestra en varias líneas. De lo contrario, el texto se trunca.

Solo se aplica a text, no a topLabel ni a bottomLabel.
bottomLabel

string

Es el texto que aparece debajo de text. Siempre se ajusta.
bottomLabelText

object (TextParagraph)

Equivalente de TextParagraph de bottomLabel. Siempre se ajusta. Permite un formato más complejo que bottomLabel.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.
onClick

object (OnClick)

Esta acción se activa cuando los usuarios hacen clic en cualquier parte del widget de DecoratedText (incluidos text, topLabel, bottomLabel y los íconos), excepto cuando hacen clic en un control interactivo independiente (button o switchControl).
Un botón, un interruptor, una casilla de verificación o una imagen que aparece a la derecha del texto en el widget decoratedText. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
button

object (Button)

Es un botón en el que un usuario puede hacer clic para activar una acción.
switchControl

object (SwitchControl)

Es un widget de interruptor en el que un usuario puede hacer clic para cambiar su estado y activar una acción.
endIcon

object (Icon)

Es un ícono que se muestra después del texto.

Admite íconos integrados y personalizados.
Fin de los campos mutuamente excluyentes.

VerticalAlignment

Representa el atributo de alineación vertical.

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED Tipo no especificado No lo utilices.
TOP Alineación con la posición superior.
MIDDLE Alineación en la posición central.
BOTTOM Alineación con la posición inferior.

SwitchControl

Un interruptor de estilo de activación o una casilla de verificación dentro de un widget decoratedText.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Solo se admite en el widget decoratedText.

Representación JSON 
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
Campos
name

string

Es el nombre con el que se identifica el widget de interruptor en un evento de entrada de formulario (como la clave en CommonEventObject.form_inputs).

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
value

string

Es el valor que se devuelve en CommonEventObject.form_inputs[name].string_inputs cuando se selecciona el interruptor (selected es true). Si selected es true y no se establece value, se devuelve una cadena vacía ("") en stringInputs.value. Cuando selected es false, este valor se omite de stringInputs.value.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
selected

boolean

Cuando es true, se selecciona el interruptor y se incluye su value en CommonEventObject.form_inputs[name].string_inputs.value.
onChangeAction

object (Action)

Es la acción que se realizará cuando se cambie el estado del interruptor, como la función que se ejecutará.
controlType

enum (ControlType)

Cómo aparece el interruptor en la interfaz de usuario.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

ControlType

Cómo aparece el interruptor en la interfaz de usuario.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
SWITCH Un interruptor de estilo de activación o desactivación.
CHECKBOX Se dio de baja y se reemplazó por CHECK_BOX.
CHECK_BOX Una casilla de verificación.

TextInput

Es un campo en el que los usuarios pueden ingresar texto. Admite sugerencias y acciones de cambio. Admite la validación del envío de formularios. Cuando Action.all_widgets_are_required se establece en true o este widget se especifica en Action.required_widgets, la acción de envío se bloquea, a menos que se ingrese un valor. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un campo en el que un usuario pueda ingresar texto.

Las apps de Chat reciben y pueden procesar el valor del texto ingresado durante los eventos de entrada de formularios. Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.

Cuando necesites recopilar datos indefinidos o abstractos de los usuarios, usa una entrada de texto. Para recopilar datos definidos o enumerados de los usuarios, usa el widget SelectionInput.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string,

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campos
name

string

Es el nombre con el que se identifica la entrada de texto en un evento de entrada de formulario.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
label

string

Es el texto que aparece sobre el campo de entrada de texto en la interfaz de usuario.

Especifica el texto que ayuda al usuario a ingresar la información que necesita tu app. Por ejemplo, si le preguntas el nombre a alguien, pero necesitas específicamente su apellido, escribe surname en lugar de name.

Es obligatorio si no se especifica hintText. De lo contrario, es opcional.
hintText

string

Es el texto que aparece debajo del campo de entrada de texto para ayudar a los usuarios indicándoles que ingresen un valor determinado. Este texto siempre está visible.

Es obligatorio si no se especifica label. De lo contrario, es opcional.
value

string

Es el valor que ingresa un usuario y que se devuelve como parte de un evento de entrada de formulario.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
type

enum (Type)

Cómo aparece un campo de entrada de texto en la interfaz de usuario Por ejemplo, si el campo es de una o varias líneas.
onChangeAction

object (Action)

Qué hacer cuando se produce un cambio en el campo de entrada de texto. Por ejemplo, un usuario que agrega texto al campo o lo borra.

Algunos ejemplos de acciones que se pueden realizar son ejecutar una función personalizada o abrir un diálogo en Google Chat.
initialSuggestions

object (Suggestions)

Son los valores sugeridos que los usuarios pueden ingresar. Estos valores aparecen cuando los usuarios hacen clic dentro del campo de entrada de texto. A medida que los usuarios escriben, los valores sugeridos se filtran de forma dinámica para que coincidan con lo que escribieron.

Por ejemplo, un campo de entrada de texto para el lenguaje de programación podría sugerir Java, JavaScript, Python y C++. Cuando los usuarios comienzan a escribir Jav, la lista de sugerencias se filtra para mostrar solo Java y JavaScript.

Los valores sugeridos ayudan a guiar a los usuarios para que ingresen valores que tu app pueda interpretar. Cuando se refieren a JavaScript, algunos usuarios pueden ingresar javascript y otros java script. Sugerir JavaScript puede estandarizar la forma en que los usuarios interactúan con tu app.

Cuando se especifica, TextInput.type siempre es SINGLE_LINE, incluso si se establece en MULTIPLE_LINE.

Disponible para las apps de Google Chat y los complementos de Google Workspace.
autoCompleteAction

object (Action)

Opcional. Especifica qué acción se debe realizar cuando el campo de entrada de texto proporciona sugerencias a los usuarios que interactúan con él.

Si no se especifica, initialSuggestions establece las sugerencias y el cliente las procesa.

Si se especifica, la app realiza la acción que se indica aquí, como ejecutar una función personalizada.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.
validation

object (Validation)

Especifica la validación del formato de entrada necesaria para este campo de texto.

Disponible para las apps de Google Chat y los complementos de Google Workspace.
placeholderText

string

Es el texto que aparece en el campo de entrada de texto cuando está vacío. Usa este texto para solicitar a los usuarios que ingresen un valor. Por ejemplo, Enter a number from 0 to 100.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.
La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
hostAppDataSource

object (HostAppDataSourceMarkup)

Es una fuente de datos que es única para una aplicación alojada de Google Workspace, como los correos electrónicos de Gmail, los eventos del Calendario de Google o los mensajes de Google Chat.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
Fin de los campos mutuamente excluyentes.

Tipo

Cómo aparece un campo de entrada de texto en la interfaz de usuario Por ejemplo, si se trata de un campo de entrada de una sola línea o de varias líneas. Si se especifica initialSuggestions, type siempre es SINGLE_LINE, incluso si se establece en MULTIPLE_LINE.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
SINGLE_LINE El campo de entrada de texto tiene una altura fija de una línea.
MULTIPLE_LINE El campo de entrada de texto tiene una altura fija de varias líneas.

RenderActions

Es un conjunto de instrucciones de renderización que le indica a una tarjeta que realice una acción o le indica a la app host del complemento o a la app de Chat que realice una acción específica de la app.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Campos
action

Action

Acción

Campos
navigations[]

Navigation

Agrega, quita o actualiza una tarjeta.

Complementos en Google Chat.

Agrega una tarjeta nueva a la pila (navega hacia adelante). En el caso de las apps de Chat, solo está disponible para la página principal de la app.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

navigations: {
  pushCard: CARD
}

Reemplaza la tarjeta superior por una nueva. En el caso de las apps de Chat, solo está disponible para la página principal de la app.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

navigations: {
  updateCard: CARD
}

Sugerencias

Son los valores sugeridos que los usuarios pueden ingresar. Estos valores aparecen cuando los usuarios hacen clic dentro del campo de entrada de texto. A medida que los usuarios escriben, los valores sugeridos se filtran de forma dinámica para que coincidan con lo que escribieron.

Por ejemplo, un campo de entrada de texto para un lenguaje de programación podría sugerir Java, JavaScript, Python y C++. Cuando los usuarios comienzan a escribir Jav, la lista de sugerencias se filtra para mostrar Java y JavaScript.

Los valores sugeridos ayudan a guiar a los usuarios para que ingresen valores que tu app pueda interpretar. Cuando se refieren a JavaScript, algunos usuarios pueden ingresar javascript y otros java script. Sugerir JavaScript puede estandarizar la forma en que los usuarios interactúan con tu app.

Cuando se especifica, TextInput.type siempre es SINGLE_LINE, incluso si se establece en MULTIPLE_LINE.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
Campos
items[]

object (SuggestionItem)

Es una lista de sugerencias que se usan para las recomendaciones de autocompletado en los campos de entrada de texto.

SuggestionItem

Es un valor sugerido que los usuarios pueden ingresar en un campo de entrada de texto.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{

  "text": string
}
Campos
La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
text

string

Es el valor de una entrada sugerida para un campo de entrada de texto. Esto equivale a lo que los usuarios ingresan por sí mismos.
Fin de los campos mutuamente excluyentes.

Validación

Representa los datos necesarios para validar el widget al que se adjunta.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
Campos
characterLimit

integer

Especifica el límite de caracteres para los widgets de entrada de texto. Ten en cuenta que esto solo se usa para la entrada de texto y se ignora en otros widgets.

Disponible para las apps de Google Chat y los complementos de Google Workspace.
inputType

enum (InputType)

Especifica el tipo de widgets de entrada.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

InputType

Es el tipo de widget de entrada.

Enums
INPUT_TYPE_UNSPECIFIED Tipo no especificado No lo utilices.
TEXT Es texto normal que acepta todos los caracteres.
INTEGER Un valor de número entero.
FLOAT Un valor de número de punto flotante
EMAIL Una dirección de correo electrónico.
EMOJI_PICKER Un emoji seleccionado del selector de emojis que proporciona el sistema.

HostAppDataSourceMarkup

Una fuente de datos de una aplicación de Google Workspace. La fuente de datos propaga los elementos disponibles para un widget.

Representación JSON 
{

  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  },
  "workflowDataSource": {
    object (WorkflowDataSourceMarkup)
  }
}
Campos
Es la aplicación de Google Workspace que propaga los elementos disponibles para un widget. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
chatDataSource

object (ChatClientDataSourceMarkup)

Una fuente de datos de Google Chat.
workflowDataSource

object (WorkflowDataSourceMarkup)

Una fuente de datos de Google Workflow.
Fin de los campos mutuamente excluyentes.

ChatClientDataSourceMarkup

Para un widget SelectionInput que usa un menú de selección múltiple, una fuente de datos de Google Chat. La fuente de datos propaga los elementos de selección para el menú de selección múltiple. Por ejemplo, un usuario puede seleccionar los espacios de Google Chat de los que es miembro.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON 
{

  "spaceDataSource": {
    object (SpaceDataSource)
  }
}
Campos
La fuente de datos de Google Chat. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
spaceDataSource

object (SpaceDataSource)

Espacios de Google Chat de los que el usuario es miembro.
Fin de los campos mutuamente excluyentes.

SpaceDataSource

Es una fuente de datos que propaga los espacios de Google Chat como elementos de selección para un menú de selección múltiple. Solo propaga los espacios de los que el usuario es miembro.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON 
{
  "defaultToCurrentSpace": boolean
}
Campos
defaultToCurrentSpace

boolean

Si se establece en true, el menú de selección múltiple selecciona el espacio de Google Chat actual como un elemento de forma predeterminada.

WorkflowDataSourceMarkup

* Solo es compatible con el flujo de trabajo de Google Workspace, pero no con las apps de Google Chat ni los complementos de Google Workspace.

En un widget TextInput o SelectionInput con el tipo MULTI_SELECT o un DateTimePicker, proporciona la fuente de datos de Google.

Representación JSON 
{
  "includeVariables": boolean,
  "type": enum (Type)
}
Campos
includeVariables

boolean

Indica si se deben incluir variables del paso anterior en la fuente de datos.
type

enum (Type)

Es el tipo de fuente de datos.

Tipo

Es una enumeración que representa el tipo de fuente de datos del flujo de trabajo.

Enums
UNKNOWN Valor predeterminado No usar.
USER Usuarios de Google Workspace El usuario solo puede ver y seleccionar usuarios de su organización de Google Workspace.
SPACE Espacios de Google Chat de los que el usuario es miembro.
USER_WITH_FREE_FORM Los usuarios pueden elegir ver y seleccionar miembros existentes de su organización de Google Workspace o ingresar manualmente una dirección de correo electrónico o un dominio válido.

SelectionInput

Es un widget que crea uno o más elementos de la IU que los usuarios pueden seleccionar. Admite la validación del envío de formularios solo para los menús dropdown y multiselect. Cuando Action.all_widgets_are_required se establece en true o este widget se especifica en Action.required_widgets, la acción de envío se bloquea, a menos que se seleccione un valor. Por ejemplo, un menú desplegable o casillas de verificación. Puedes usar este widget para recopilar datos que se pueden predecir o enumerar. Para ver un ejemplo en las apps de Google Chat, consulta Agrega elementos de la IU seleccionables.

Las apps de Chat pueden procesar el valor de los elementos que los usuarios seleccionan o ingresan. Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.

Para recopilar datos indefinidos o abstractos de los usuarios, usa el widget TextInput.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMinQueryLength": integer,
  "dataSourceConfigs": [
    {
      object (DataSourceConfig)
    }
  ],
  "multiSelectMaxSelectedItems": integer,
  "hintText": string,

  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
}
Campos
name

string

Obligatorio. Es el nombre que identifica la entrada de selección en un evento de entrada de formulario.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
label

string

Es el texto que aparece sobre el campo de entrada de selección en la interfaz de usuario.

Especifica el texto que ayuda al usuario a ingresar la información que necesita tu app. Por ejemplo, si los usuarios seleccionan la urgencia de un ticket de trabajo en un menú desplegable, la etiqueta podría ser "Urgencia" o "Seleccionar urgencia".
type

enum (SelectionType)

Es el tipo de elementos que se muestran a los usuarios en un widget de SelectionInput. Los tipos de selección admiten diferentes tipos de interacciones. Por ejemplo, los usuarios pueden seleccionar una o más casillas de verificación, pero solo pueden seleccionar un valor de un menú desplegable.
items[]

object (SelectionItem)

Es un array de elementos seleccionables. Por ejemplo, un array de botones de selección o casillas de verificación. Admite hasta 100 elementos.
onChangeAction

object (Action)

Si se especifica, el formulario se envía cuando cambia la selección. Si no se especifica, debes especificar un botón independiente que envíe el formulario.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
multiSelectMinQueryLength

integer

En el caso de los menús de selección múltiple, es la cantidad de caracteres de texto que ingresa un usuario antes de que el menú devuelva los elementos de selección sugeridos.

Si no se establece, el menú de selección múltiple usa los siguientes valores predeterminados:

  • Si el menú usa un array estático de elementos SelectionInput, el valor predeterminado es 0 caracteres y se completan de inmediato los elementos del array.
  • Si el menú usa una fuente de datos dinámica (multi_select_data_source), el valor predeterminado es de 3 caracteres antes de consultar la fuente de datos para devolver los elementos sugeridos.
dataSourceConfigs[]

object (DataSourceConfig)

Opcional. Son los parámetros de configuración de la fuente de datos para el control de selección. Este campo proporciona un control más detallado sobre la fuente de datos.

Si se especifica, se ignoran los campos multiSelectMaxSelectedItems, multiSelectMinQueryLength, externalDataSource y platformDataSource.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio.

Disponible para el Dropdown widget en las apps de Google Chat. Para el widget Dropdown en las apps de Google Chat, solo se admite un DataSourceConfig. Si se configuran varios DataSourceConfig, solo se usa el primero.
multiSelectMaxSelectedItems

integer

En el caso de los menús de selección múltiple, es la cantidad máxima de elementos que puede seleccionar un usuario. El valor mínimo es 1 elemento. Si no se especifica, el valor predeterminado es 3 elementos.
hintText

string

Opcional. Es el texto que aparece debajo del campo de entrada de selección y que tiene como objetivo ayudar a los usuarios pidiéndoles que ingresen un valor determinado. Este texto siempre está visible.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Para un menú de selección múltiple, una fuente de datos que propaga de forma dinámica los elementos de selección.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
externalDataSource

object (Action)

Una fuente de datos externa, como una base de datos relacional
platformDataSource

object (PlatformDataSource)

Una fuente de datos de Google Workspace.
Fin de los campos mutuamente excluyentes.

SelectionType

Es el formato de los elementos que los usuarios pueden seleccionar. Las diferentes opciones admiten distintos tipos de interacciones. Por ejemplo, los usuarios pueden seleccionar varias casillas de verificación, pero solo pueden seleccionar un elemento de un menú desplegable.

Cada entrada de selección admite un tipo de selección. Por ejemplo, no se admite mezclar casillas de verificación y botones de activación.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
CHECK_BOX Es un conjunto de casillas de verificación. Los usuarios pueden seleccionar una o más casillas de verificación.
RADIO_BUTTON Un conjunto de botones de selección. Los usuarios pueden seleccionar un botón de selección.
SWITCH Un conjunto de interruptores. Los usuarios pueden activar uno o más interruptores.
DROPDOWN

Un menú desplegable Los usuarios pueden seleccionar un elemento del menú.

En el caso de las apps de Google Chat, puedes propagar elementos con una fuente de datos dinámica y sugerir elementos automáticamente a medida que los usuarios escriben en el menú. Por ejemplo, los usuarios pueden comenzar a escribir el nombre de un espacio de Google Chat y el widget sugerirá automáticamente el espacio. Para propagar elementos de forma dinámica en un menú desplegable, usa uno de los siguientes tipos de fuentes de datos:

  • Datos de Google Workspace: Los elementos se completan con datos de Google Workspace, como los usuarios de Google Workspace o los espacios de Google Chat.
  • Datos externos: Los elementos se propagan desde una fuente de datos externa fuera de Google Workspace.

Para ver ejemplos de cómo implementar menús desplegables para apps de Chat, consulta Agrega un menú desplegable y Completa menús desplegables de forma dinámica.

Disponible para las apps de Google Chat y los complementos de Google Workspace.
MULTI_SELECT

Un menú con un cuadro de texto. Los usuarios pueden escribir y seleccionar uno o más elementos. En el caso de los complementos de Google Workspace, debes propagar los elementos con un array estático de objetos SelectionItem.

En el caso de las apps de Google Chat, también puedes propagar elementos con una fuente de datos dinámica y sugerir elementos automáticamente a medida que los usuarios escriben en el menú. Por ejemplo, los usuarios pueden comenzar a escribir el nombre de un espacio de Google Chat y el widget sugerirá automáticamente el espacio. Para propagar elementos de forma dinámica en un menú de selección múltiple, usa uno de los siguientes tipos de fuentes de datos:

  • Datos de Google Workspace: Los elementos se completan con datos de Google Workspace, como los usuarios de Google Workspace o los espacios de Google Chat.
  • Datos externos: Los elementos se propagan desde una fuente de datos externa fuera de Google Workspace.

Si quieres ver ejemplos de cómo implementar menús de selección múltiple para apps de Chat, consulta Agrega un menú de selección múltiple.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

PlatformDataSource

Para un widget SelectionInput que usa un menú de selección múltiple, una fuente de datos de Google Workspace. Se usa para propagar elementos en un menú de selección múltiple.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON 
{

  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campos
La fuente de datos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
commonDataSource

enum (CommonDataSource)

Es una fuente de datos que comparten todas las aplicaciones de Google Workspace, como los usuarios de una organización de Google Workspace.
hostAppDataSource

object (HostAppDataSourceMarkup)

Es una fuente de datos que es única para una aplicación alojada de Google Workspace, como los espacios en Google Chat.

Este campo admite las bibliotecas cliente de la API de Google, pero no está disponible en las bibliotecas cliente de Cloud. Para obtener más información, consulta Instala las bibliotecas cliente.
Fin de los campos mutuamente excluyentes.

CommonDataSource

Una fuente de datos compartida por todas las aplicaciones de Google Workspace.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Enums
UNKNOWN Valor predeterminado No usar.
USER Usuarios de Google Workspace El usuario solo puede ver y seleccionar usuarios de su organización de Google Workspace.

DataSourceConfig

Es un objeto de configuración que ayuda a configurar las fuentes de datos de un widget.

Está disponible para las apps de Google Chat y los complementos de Google Workspace que extienden Google Workspace Studio.

Representación JSON 
{

  "remoteDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  "minCharactersTrigger": integer
}
Campos
La fuente de datos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
remoteDataSource

object (Action)

Los datos provienen de un proveedor de datos remoto.
platformDataSource

object (PlatformDataSource)

Los datos provienen de una aplicación de Google Workspace.
Fin de los campos mutuamente excluyentes.
minCharactersTrigger

integer

Es la cantidad mínima de caracteres que el usuario debe ingresar antes de que se active este proveedor de datos (es decir, antes de que comience a mostrar resultados).

DateTimePicker

Permite que los usuarios ingresen una fecha, una hora o ambas. Admite la validación del envío de formularios. Cuando Action.all_widgets_are_required se establece en true o este widget se especifica en Action.required_widgets, la acción de envío se bloquea, a menos que se seleccione un valor. Para ver un ejemplo en las apps de Google Chat, consulta Permite que un usuario elija una fecha y hora.

Los usuarios pueden ingresar texto o usar el selector para elegir fechas y horas. Si los usuarios ingresan una fecha o una hora no válidas, el selector muestra un error que les solicita que ingresen la información correctamente.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

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

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campos
name

string

Es el nombre con el que se identifica el DateTimePicker en un evento de entrada de formulario.

Para obtener detalles sobre cómo trabajar con entradas de formularios, consulta Cómo recibir datos de formularios.
label

string

Es el texto que solicita a los usuarios que ingresen una fecha, una hora o una fecha y hora. Por ejemplo, si los usuarios programan una cita, usa una etiqueta como Appointment date o Appointment date and time.
type

enum (DateTimePickerType)

Indica si el widget admite el ingreso de una fecha, una hora o la fecha y la hora.
valueMsEpoch

string (int64 format)

Es el valor predeterminado que se muestra en el widget, en milisegundos desde el tiempo Unix.

Especifica el valor según el tipo de selector (DateTimePickerType):

  • DATE_AND_TIME: una fecha y hora del calendario en UTC. Por ejemplo, para representar el 1 de enero de 2023 a las 12:00 p.m. UTC, usa 1672574400000.
  • DATE_ONLY: una fecha de calendario a las 00:00:00 UTC. Por ejemplo, para representar el 1 de enero de 2023, usa 1672531200000.
  • TIME_ONLY: Es una hora en UTC. Por ejemplo, para representar las 12:00 p.m., usa 43200000 (o 12 * 60 * 60 * 1000).
timezoneOffsetDate

integer

Es el número que representa la diferencia de zona horaria con respecto a la hora UTC, en minutos. Si se establece, el valueMsEpoch se muestra en la zona horaria especificada. Si no se establece, el valor predeterminado es la configuración de zona horaria del usuario.

Nota: Este campo se expresa en minutos, mientras que las cargas útiles de los eventos de interacción del usuario suelen proporcionar diferencias de zona horaria en milisegundos (divide por 60000 para convertir).
onChangeAction

object (Action)

Se activa cuando el usuario hace clic en Guardar o Borrar en la interfaz de DateTimePicker.
La fuente de datos especificada para representar una fecha y hora. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
hostAppDataSource

object (HostAppDataSourceMarkup)

Es una fuente de datos que es única para una aplicación alojada de Google Workspace, como los correos electrónicos de Gmail, los eventos del Calendario de Google o los mensajes de Google Chat.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.
Fin de los campos mutuamente excluyentes.

DateTimePickerType

Es el formato de la fecha y la hora en el widget DateTimePicker. Determina si los usuarios pueden ingresar una fecha, una hora o ambas.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
DATE_AND_TIME Los usuarios ingresan una fecha y hora.
DATE_ONLY Los usuarios ingresan una fecha.
TIME_ONLY Los usuarios ingresan una hora.

Divisor

Este tipo no tiene campos.

Muestra un divisor entre widgets como una línea horizontal. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un divisor horizontal entre widgets.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Por ejemplo, el siguiente JSON crea un divisor:

"divider": {}

Cuadrícula

Muestra una cuadrícula con una colección de elementos. Los elementos solo pueden incluir texto o imágenes. Para las columnas responsivas o para incluir más que texto o imágenes, usa Columns. Para ver un ejemplo en las apps de Google Chat, consulta Muestra una cuadrícula con una colección de elementos.

Una cuadrícula admite cualquier cantidad de columnas y elementos. La cantidad de filas se determina dividiendo los elementos por las columnas. Una cuadrícula con 10 elementos y 2 columnas tiene 5 filas. Una cuadrícula con 11 elementos y 2 columnas tiene 6 filas.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Por ejemplo, el siguiente JSON crea una cuadrícula de 2 columnas con un solo elemento:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
Representación JSON 
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
Campos
title

string

Es el texto que se muestra en el encabezado de la cuadrícula.
items[]

object (GridItem)

Son los elementos que se mostrarán en la cuadrícula.
borderStyle

object (BorderStyle)

Es el estilo de borde que se aplicará a cada elemento de la cuadrícula.
columnCount

integer

Es la cantidad de columnas que se mostrarán en la cuadrícula. Si no se especifica este campo, se usa un valor predeterminado, que varía según dónde se muestre la cuadrícula (diálogo o complemento).
onClick

object (OnClick)

Cada elemento de cuadrícula individual reutiliza esta devolución de llamada, pero con el identificador del elemento agregado a los parámetros de la devolución de llamada (en la clave "grid_item_identifier").

GridItem

Representa un elemento en un diseño de cuadrícula. Los elementos pueden contener texto, una imagen o ambos.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
Campos
id

string

Es un identificador especificado por el usuario para este elemento de cuadrícula. Este identificador se devuelve en los parámetros de devolución de llamada onClick de la cuadrícula superior.
image

object (ImageComponent)

Es la imagen que se muestra en el elemento de cuadrícula.
title

string

Es el título del elemento de la cuadrícula.
subtitle

string

Es el subtítulo del elemento de la cuadrícula.
layout

enum (GridItemLayout)

Es el diseño que se usará para el elemento de cuadrícula.

ImageComponent

Representa una imagen.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
Campos
imageUri

string

Es la URL de la imagen.
altText

string

Es la etiqueta de accesibilidad de la imagen.
cropStyle

object (ImageCropStyle)

Es el estilo de recorte que se aplicará a la imagen.
borderStyle

object (BorderStyle)

Es el estilo de borde que se aplicará a la imagen.

ImageCropStyle

Representa el estilo de recorte aplicado a una imagen.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Por ejemplo, a continuación, se muestra cómo aplicar una relación de aspecto de 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
Representación JSON 
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
Campos
type

enum (ImageCropType)

Es el tipo de cultivo.
aspectRatio

number

Es la relación de aspecto que se usará si el tipo de recorte es RECTANGLE_CUSTOM.

Por ejemplo, a continuación, se muestra cómo aplicar una relación de aspecto de 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

Representa el estilo de recorte aplicado a una imagen.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
IMAGE_CROP_TYPE_UNSPECIFIED No usar. Sin especificar.
SQUARE Valor predeterminado Aplica un recorte cuadrado.
CIRCLE Aplica un recorte circular.
RECTANGLE_CUSTOM Aplica un recorte rectangular con una relación de aspecto personalizada. Establece la relación de aspecto personalizada con aspectRatio.
RECTANGLE_4_3 Aplica un recorte rectangular con una relación de aspecto de 4:3.

BorderStyle

Son las opciones de estilo para el borde de una tarjeta o un widget, incluidos el tipo y el color del borde.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
Campos
type

enum (BorderType)

Es el tipo de borde.
strokeColor

object (Color)

Son los colores que se usarán cuando el tipo sea BORDER_TYPE_STROKE.

Para establecer el color del trazo, especifica un valor para los campos red, green y blue. El valor debe ser un número de punto flotante entre 0 y 1 según el valor de color RGB, donde 0 (0/255) representa la ausencia de color y 1 (255/255) representa la intensidad máxima del color.

Por ejemplo, en el siguiente código, se establece el color rojo en su intensidad máxima:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

El campo alpha no está disponible para el color del trazo. Si se especifica, se ignora este campo.
cornerRadius

integer

Es el radio de la esquina del borde.

BorderType

Representa los tipos de bordes que se aplican a los widgets.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
BORDER_TYPE_UNSPECIFIED No usar. Sin especificar.
NO_BORDER Sin borde.
STROKE Valor predeterminado Outline.

GridItemLayout

Representa las diversas opciones de diseño disponibles para un elemento de cuadrícula.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
GRID_ITEM_LAYOUT_UNSPECIFIED No usar. Sin especificar.
TEXT_BELOW El título y el subtítulo se muestran debajo de la imagen del elemento de cuadrícula.
TEXT_ABOVE El título y el subtítulo se muestran sobre la imagen del elemento de cuadrícula.

Columnas

El widget Columns muestra hasta 2 columnas en una tarjeta o un diálogo. Puedes agregar widgets a cada columna; los widgets aparecen en el orden en que se especifican. Para ver un ejemplo en las apps de Google Chat, consulta Muestra tarjetas y diálogos en columnas.

La altura de cada columna se determina según la columna más alta. Por ejemplo, si la primera columna es más alta que la segunda, ambas tendrán la altura de la primera. Como cada columna puede contener una cantidad diferente de widgets, no puedes definir filas ni alinear widgets entre las columnas.

Las columnas se muestran una al lado de la otra. Puedes personalizar el ancho de cada columna con el campo HorizontalSizeStyle. Si el ancho de la pantalla del usuario es demasiado estrecho, la segunda columna se ajusta debajo de la primera:

  • En la Web, la segunda columna se ajusta si el ancho de la pantalla es menor o igual a 480 píxeles.
  • En los dispositivos iOS, la segunda columna se ajusta si el ancho de la pantalla es menor o igual que 300 pt.
  • En los dispositivos Android, la segunda columna se ajusta si el ancho de la pantalla es inferior o igual a 320 dp.

Para incluir más de dos columnas o usar filas, usa el widget Grid.

Disponible para las apps de Google Chat y los complementos de Google Workspace. Las IU de complementos que admiten columnas incluyen las siguientes:

  • Es el diálogo que se muestra cuando los usuarios abren el complemento desde un borrador de correo electrónico.
  • Es el diálogo que se muestra cuando los usuarios abren el complemento desde el menú Agregar archivo adjunto en un evento de Calendario de Google.
Representación JSON 
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
Campos
columnItems[]

object (Column)

Un array de columnas. Puedes incluir hasta 2 columnas en una tarjeta o un diálogo.

Columna

Una columna

Complementos de Google Workspace y apps de Chat

Representación JSON 
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
Campos
horizontalSizeStyle

enum (HorizontalSizeStyle)

Especifica cómo una columna llena el ancho de la tarjeta.
horizontalAlignment

enum (HorizontalAlignment)

Especifica si los widgets se alinean a la izquierda, a la derecha o al centro de una columna.
verticalAlignment

enum (VerticalAlignment)

Especifica si los widgets se alinean en la parte superior, inferior o central de una columna.
widgets[]

object (Widgets)

Es un array de widgets incluidos en una columna. Los widgets aparecen en el orden en que se especifican.

HorizontalSizeStyle

Especifica cómo una columna llena el ancho de la tarjeta. El ancho de cada columna depende de HorizontalSizeStyle y del ancho de los widgets que contiene.

Complementos de Google Workspace y apps de Chat

Enums
HORIZONTAL_SIZE_STYLE_UNSPECIFIED No usar. Sin especificar.
FILL_AVAILABLE_SPACE Valor predeterminado La columna ocupa el espacio disponible, hasta el 70% del ancho de la tarjeta. Si ambas columnas se establecen en FILL_AVAILABLE_SPACE, cada una ocupa el 50% del espacio.
FILL_MINIMUM_SPACE La columna ocupa la menor cantidad de espacio posible y no más del 30% del ancho de la tarjeta.

HorizontalAlignment

Especifica si los widgets se alinean a la izquierda, a la derecha o al centro de una columna.

Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Enums
HORIZONTAL_ALIGNMENT_UNSPECIFIED No usar. Sin especificar.
START Valor predeterminado Alinea los widgets con la posición inicial de la columna. En los diseños de izquierda a derecha, se alinea a la izquierda. En el caso de los diseños de derecha a izquierda, se alinea a la derecha.
CENTER Alinea los widgets con el centro de la columna.
END Alinea los widgets con la posición final de la columna. Para los diseños de izquierda a derecha, alinea los widgets a la derecha. En el caso de los diseños de derecha a izquierda, alinea los widgets a la izquierda.

VerticalAlignment

Especifica si los widgets se alinean en la parte superior, inferior o central de una columna.

Complementos de Google Workspace y apps de Chat

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED No usar. Sin especificar.
CENTER Valor predeterminado Alinea los widgets al centro de una columna.
TOP Alinea los widgets en la parte superior de una columna.
BOTTOM Alinea los widgets con la parte inferior de una columna.

Widgets

Son los widgets compatibles que puedes incluir en una columna.

Complementos de Google Workspace y apps de Chat

Representación JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
}
Campos
La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
textParagraph

object (TextParagraph)

TextParagraph widget
image

object (Image)

Image widget
decoratedText

object (DecoratedText)

DecoratedText widget
buttonList

object (ButtonList)

ButtonList widget
textInput

object (TextInput)

TextInput widget
selectionInput

object (SelectionInput)

SelectionInput widget
dateTimePicker

object (DateTimePicker)

DateTimePicker widget
chipList

object (ChipList)

ChipList widget
Fin de los campos mutuamente excluyentes.

ChipList

Es una lista de chips dispuestos de forma horizontal, que se pueden desplazar horizontalmente o ajustar a la siguiente línea.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
Campos
layout

enum (Layout)

Es el diseño de la lista de chips especificado.
chips[]

object (Chip)

Un array de chips.

Diseño

Es el diseño de la lista de chips.

Enums
LAYOUT_UNSPECIFIED No usar. Sin especificar.
WRAPPED Valor predeterminado La lista de chips se ajusta a la siguiente línea si no hay suficiente espacio horizontal.
HORIZONTAL_SCROLLABLE Los chips se desplazan de forma horizontal si no caben en el espacio disponible.

Chip

Un chip de texto, ícono o texto e ícono en el que los usuarios pueden hacer clic.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
Campos
icon

object (Icon)

Es la imagen del ícono. Si se configuran icon y label, el ícono aparecerá antes de la etiqueta.
label

string

Es el texto que se muestra dentro del chip.
onClick

object (OnClick)

Opcional. Es la acción que se debe realizar cuando un usuario hace clic en el chip, como abrir un hipervínculo o ejecutar una función personalizada.
enabled
(deprecated)

boolean

Obsoleto: Usa disabled en su lugar.

Indica si el chip está en un estado activo y responde a las acciones del usuario.
disabled

boolean

Indica si el chip está en un estado inactivo y, por lo tanto, ignora las acciones del usuario. La configuración predeterminada es false.
altText

string

Es el texto alternativo que se usa para la accesibilidad.

Establece un texto descriptivo que les permita a los usuarios saber qué hace el chip. Por ejemplo, si un chip abre un hipervínculo, escribe: "Abre una nueva pestaña del navegador y navega a la documentación para desarrolladores de Google Chat en https://developers.google.com/workspace/chat".

CarouselCard

Es una tarjeta que se puede mostrar como un elemento de carrusel. Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON 
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
Campos
widgets[]

object (NestedWidget)

Es una lista de widgets que se muestran en la tarjeta del carrusel. Los widgets se muestran en el orden en que se especifican.
footerWidgets[]

object (NestedWidget)

Es una lista de widgets que se muestran en la parte inferior de la tarjeta de carrusel. Los widgets se muestran en el orden en que se especifican.

NestedWidget

Es una lista de widgets que se pueden mostrar en un diseño contenedor, como un CarouselCard. Disponible para las apps de Google Chat y no disponible para los complementos de Google Workspace.

Representación JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
}
Campos
La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
textParagraph

object (TextParagraph)

Es un widget de párrafo de texto.
buttonList

object (ButtonList)

Es un widget de lista de botones.
image

object (Image)

Un widget de imagen.
Fin de los campos mutuamente excluyentes.

Visibilidad

Especifica si un elemento de la IU está visible o está oculto.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Enums
VISIBILITY_UNSPECIFIED Visibilidad sin especificar. No lo utilices.
VISIBLE El elemento de la IU es visible.
HIDDEN El elemento de la IU está oculto.

EventAction

Representa una acción que se puede realizar en un elemento de la IU.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "actionRuleId": string,
  "postEventTriggers": [
    {
      object (Trigger)
    }
  ],

  "commonWidgetAction": {
    object (CommonWidgetAction)
  }
}
Campos
actionRuleId

string

Es el identificador único de ActionRule.
postEventTriggers[]

object (Trigger)

Es la lista de activadores que se activarán después de que se ejecute EventAction.
Es la acción que se debe realizar. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
commonWidgetAction

object (CommonWidgetAction)

Acción común del widget.
Fin de los campos mutuamente excluyentes.

Activador

Representa un activador.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "actionRuleId": string
}
Campos
actionRuleId

string

Es el identificador único de ActionRule.

CommonWidgetAction

Representa una acción que no es específica de un widget.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{

  "updateVisibilityAction": {
    object (UpdateVisibilityAction)
  }
}
Campos
Es la acción que se debe realizar. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
updateVisibilityAction

object (UpdateVisibilityAction)

Es la acción para actualizar la visibilidad de un widget.
Fin de los campos mutuamente excluyentes.

UpdateVisibilityAction

Representa una acción que actualiza la visibilidad de un widget.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "visibility": enum (Visibility)
}
Campos
visibility

enum (Visibility)

La nueva visibilidad.

CollapseControl

Representa un control de expansión y contracción.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
Campos
horizontalAlignment

enum (HorizontalAlignment)

Es la alineación horizontal del botón para expandir y contraer.
expandButton

object (Button)

Opcional. Define un botón personalizable para expandir la sección. Se deben establecer los campos expandButton y collapseButton. No se aplicará solo un conjunto de campos. Si no se establece este campo, se usa el botón predeterminado.
collapseButton

object (Button)

Opcional. Define un botón personalizable para contraer la sección. Se deben establecer los campos expandButton y collapseButton. No se aplicará solo un conjunto de campos. Si no se establece este campo, se usa el botón predeterminado.

DividerStyle

Es el estilo de divisor de una tarjeta. Actualmente, solo se usa para los divisores entre las secciones de las tarjetas.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Enums
DIVIDER_STYLE_UNSPECIFIED No usar. Sin especificar.
SOLID_DIVIDER Opción predeterminada. Renderiza un divisor sólido.
NO_DIVIDER Si se establece, no se renderiza ningún divisor. Este estilo quita por completo el divisor del diseño. El resultado es equivalente a no agregar un divisor.

CardAction

Una acción de tarjeta es la acción asociada a la tarjeta. Por ejemplo, una tarjeta de factura puede incluir acciones como borrar la factura, enviarla por correo electrónico o abrirla en un navegador.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.

Representación JSON 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
Campos
actionLabel

string

Es la etiqueta que se muestra como el elemento del menú de acciones.
onClick

object (OnClick)

La acción onClick para este elemento de acción.

CardFixedFooter

Un pie de página persistente (fijo) que aparece en la parte inferior de la tarjeta

Si configuras fixedFooter sin especificar un primaryButton o un secondaryButton, se produce un error.

En el caso de las apps de Chat, puedes usar pies de página fijos en los diálogos, pero no en los mensajes de tarjeta. Para ver un ejemplo en las apps de Google Chat, consulta Agrega un pie de página persistente.

Disponible para las apps de Google Chat y los complementos de Google Workspace.

Representación JSON 
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
Campos
primaryButton

object (Button)

Es el botón principal del pie de página fijo. El botón debe ser un botón de texto con texto y color establecidos.
secondaryButton

object (Button)

Es el botón secundario del pie de página fijo. El botón debe ser un botón de texto con texto y color establecidos. Si se establece secondaryButton, también debes establecer primaryButton.

DisplayStyle

En los complementos de Google Workspace, determina cómo se muestra una tarjeta.

Disponible para complementos de Google Workspace y no disponible para apps de Google Chat.

Enums
DISPLAY_STYLE_UNSPECIFIED No usar. Sin especificar.
PEEK El encabezado de la tarjeta aparece en la parte inferior de la barra lateral y cubre parcialmente la tarjeta superior actual de la pila. Si haces clic en el encabezado, la tarjeta se agregará a la pila de tarjetas. Si la tarjeta no tiene encabezado, se usa uno generado.
REPLACE Valor predeterminado La tarjeta se muestra reemplazando la vista de la tarjeta superior en la pila de tarjetas.

ExpressionData

Representa los datos que se usan para evaluar una expresión.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "id": string,
  "expression": string,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "eventActions": [
    {
      object (EventAction)
    }
  ]
}
Campos
id

string

Es el identificador único de ExpressionData.
expression

string

Es la expresión sin compilar.
conditions[]

object (Condition)

Es la lista de condiciones que se determinan según el resultado de la evaluación de la expresión.
eventActions[]

object (EventAction)

Es la lista de acciones en las que se puede usar ExpressionData.

Condición

Representa una condición que se puede usar para activar una acción.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "actionRuleId": string,

  "expressionDataCondition": {
    object (ExpressionDataCondition)
  }
}
Campos
actionRuleId

string

Es el identificador único de ActionRule.
La condición La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
expressionDataCondition

object (ExpressionDataCondition)

Es la condición que se determina por los datos de la expresión.
Fin de los campos mutuamente excluyentes.

ExpressionDataCondition

Representa una condición que se evalúa con CEL.

Disponible para los complementos de Google Workspace que extienden Google Workspace Studio. No está disponible para las apps de Google Chat.

Representación JSON 
{
  "conditionType": enum (ConditionType)
}
Campos
conditionType

enum (ConditionType)

Es el tipo de condición.

ConditionType

Es el tipo de condición.

Enums
CONDITION_TYPE_UNSPECIFIED Tipo de condición sin especificar.
EXPRESSION_EVALUATION_SUCCESS La evaluación de la expresión se realizó correctamente.
EXPRESSION_EVALUATION_FAILURE No se pudo evaluar la expresión.