Se usó la API de Cloud Translation para traducir esta página.

Imagen

El widget Image muestra una imagen .png o .jpg alojada en una URL HTTPS. El ancho de la imagen abarca todo el ancho de la tarjeta que se muestra y su altura se ajusta para mantener la relación de aspecto de la imagen.

El widget Image admite acciones onclick que ocurren cuando los usuarios hacen clic en la imagen. Estos son algunos ejemplos de acciones de clic:

Abre un hipervínculo con OpenLink, como https://developers.google.com/chat.
Ejecutar una acción que ejecute una función personalizada, como llamar a una API

La siguiente es una tarjeta que consta de un widget Image. Muestra la imagen de la página de destino de la documentación para desarrolladores de Google Chat. Cuando los usuarios hacen clic en la imagen, se abre la documentación para desarrolladores de Google Chat en una pestaña nueva.

Representación de JSON y campos

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

Campos

Campos
`imageUrl`	`string` La URL HTTPS que aloja la imagen. Por ejemplo: `https://developers.google.com/chat/images/quickstart-app-avatar.png`
`onClick`	`object (OnClick)` Cuando un usuario hace clic en la imagen, se activa esta acción.
`altText`	`string` El texto alternativo de esta imagen que se usa con fines de accesibilidad.

imageUrl

string

La URL HTTPS que aloja la imagen.

Por ejemplo:

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

onClick

object (OnClick)

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

altText

string

El texto alternativo de esta imagen que se usa con fines de accesibilidad.

OnClick

Representa cómo responder cuando los usuarios hacen clic en un elemento interactivo en una tarjeta, como un botón.

Representación JSON

Representación JSON
{ // Union field `data` can be only one of the following: "action": { object (`Action`) }, "openLink": { object (`OpenLink`) }, "openDynamicLinkAction": { object (`Action`) }, "card": { object (`Card`) } // End of list of possible types for union field `data`. }

{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  }
  // End of list of possible types for union field data.
}

Campos
Campo de unión `data`. `data` solo puede ser una de las siguientes opciones:
`action`	`object (Action)` Si se especifica, esta `onClick` activa una acción.
`openLink`	`object (OpenLink)` Si se especifica, `onClick` activa una acción de vínculo abierto.
`openDynamicLinkAction`	`object (Action)` Un complemento activa esta acción cuando la acción necesita abrir un vínculo. Esto difiere del `openLink` anterior en que debe comunicarse con el servidor para obtener el vínculo. Por lo tanto, se requiere un poco de trabajo de preparación para que el cliente web lo haga antes de que regrese la respuesta de acción de vínculo abierto. Son compatibles con los complementos de Google Workspace, pero no con las apps de Google Chat.
`card`	`object (Card)` Si se especifica, se envía una nueva tarjeta a la pila de tarjetas después de hacer clic. Son compatibles con los complementos de Google Workspace, pero no con las apps de Google Chat.

Acción

Una acción que describe el comportamiento cuando se envía el formulario. Por ejemplo, puedes invocar una secuencia de comandos de Apps Script para controlar el formulario. Si se activa la acción, los valores del formulario se envían al servidor.

Representación JSON
{ "function": string, "parameters": [ { object (`ActionParameter`) } ], "loadIndicator": enum (`LoadIndicator`), "persistValues": boolean, "interaction": enum (`Interaction`) }

Campos
`function`	`string` Es una función personalizada que se invoca cuando se hace clic en el elemento contenedor o se activa de otro modo. Para ver ejemplos de uso, consulta Cómo crear tarjetas interactivas.
`parameters[]`	`object (ActionParameter)` Lista de parámetros de acción.
`loadIndicator`	`enum (LoadIndicator)` Especifica el indicador de carga que muestra la acción mientras se realiza la llamada a la acción.
`persistValues`	`boolean` Indica si los valores del formulario persisten después de la acción. El valor predeterminado es `false`. Si es `true`, los valores del formulario permanecen después de que se activa la acción. Para permitir que el usuario realice cambios mientras se procesa la acción, configura `LoadIndicator` como `NONE`. Para los mensajes de tarjetas en las apps de Chat, también debes configurar el `ResponseType` de la acción en `UPDATE_MESSAGE` y usar el mismo `cardId` de la tarjeta que contenía la acción. Si es `false`, los valores del formulario se borran cuando se activa la acción. Para evitar que el usuario haga cambios mientras se procesa la acción, establece `LoadIndicator` en `SPINNER`.
`interaction`	`enum (Interaction)` Opcional. Es obligatorio al abrir un diálogo. Qué hacer en respuesta a una interacción con un usuario, como cuando un usuario hace clic en un botón en un mensaje de tarjeta. Si no se especifica, la app responde con la ejecución normal de un elemento `action`, como abrir un vínculo o ejecutar una función. Cuando se especifica un `interaction`, la app puede responder de maneras interactivas especiales. Por ejemplo, si estableces `interaction` en `OPEN_DIALOG`, la app podrá abrir un diálogo. Cuando se especifica, no se muestra un indicador de carga. Son compatibles con las apps de Chat, pero no los complementos de Google Workspace. Si se especifica para un complemento, se quitará toda la tarjeta y no se mostrará nada en el cliente.

ActionParameter

Lista de parámetros de cadena que se deben proporcionar cuando se invoca el método de acción. Por ejemplo, considera tres botones para posponer: Posponer ahora, Posponer un día o Posponer la próxima semana. Puedes usar action method = snooze() y pasar el tipo y el tiempo de posposición en la lista de parámetros de cadena.

Para obtener más información, consulta CommonEventObject.

Representación JSON
{ "key": string, "value": string }

Campos

Campos
`key`	`string` El nombre del parámetro de la secuencia de comandos de acción.
`value`	`string` El valor del parámetro.

key

string

El nombre del parámetro de la secuencia de comandos de acción.

value

string

El valor del parámetro.

LoadIndicator

Especifica el indicador de carga que muestra la acción mientras se realiza la llamada a la acción.

Enumeradores
`SPINNER`	Muestra un ícono giratorio para indicar que se está cargando el contenido.
`NONE`	No se muestra nada.

Interacción

Opcional. Es obligatorio al abrir un diálogo.

Qué hacer en respuesta a una interacción con un usuario, como cuando un usuario hace clic en un botón en un mensaje de tarjeta.

Si no se especifica, la app responde con la ejecución normal de un elemento action, como abrir un vínculo o ejecutar una función.

Cuando se especifica un interaction, la app puede responder de maneras interactivas especiales. Por ejemplo, si estableces interaction en OPEN_DIALOG, la app podrá abrir un diálogo.

Cuando se especifica, no se muestra un indicador de carga.

Son compatibles con las apps de Chat, pero no los complementos de Google Workspace. Si se especifica para un complemento, se quitará toda la tarjeta y no se mostrará nada en el cliente.

Enumeradores

INTERACTION_UNSPECIFIED Valor predeterminado action se ejecuta con normalidad.

Enumeradores
`INTERACTION_UNSPECIFIED`	Valor predeterminado `action` se ejecuta con normalidad.
`OPEN_DIALOG`	Abre un diálogo, una interfaz con ventanas y basadas en tarjetas que usan las apps de Chat para interactuar con los usuarios. Solo es compatible con apps de Chat en respuesta a clics en botones en mensajes de tarjetas. No es compatible con los complementos de Google Workspace. Si se especifica para un complemento, se quitará toda la tarjeta y no se mostrará nada en el cliente.

OPEN_DIALOG

Abre un diálogo, una interfaz con ventanas y basadas en tarjetas que usan las apps de Chat para interactuar con los usuarios.

Solo es compatible con apps de Chat en respuesta a clics en botones en mensajes de tarjetas.

No es compatible con los complementos de Google Workspace. Si se especifica para un complemento, se quitará toda la tarjeta y no se mostrará nada en el cliente.

OpenLink

Representa un evento onClick que abre un hipervínculo.

Representación JSON
{ "url": string, "openAs": enum (`OpenAs`), "onClose": enum (`OnClose`) }

Campos

Campos
`url`	`string` La URL que se abrirá.
`openAs`	`enum (OpenAs)` Cómo abrir un vínculo No es compatible con las apps de Chat.
`onClose`	`enum (OnClose)` Indica si el cliente se olvida de un vínculo después de abrirlo o si lo observa hasta que se cierra la ventana. No es compatible con las apps de Chat.

url

string

La URL que se abrirá.

openAs

enum (OpenAs)

Cómo abrir un vínculo No es compatible con las apps de Chat.

onClose

enum (OnClose)

Indica si el cliente se olvida de un vínculo después de abrirlo o si lo observa hasta que se cierra la ventana. No es compatible con las apps de Chat.

Límites y consideraciones

Solo se admiten imágenes .png y .jpg.
La URL del host debe ser HTTPS.
Para garantizar que las tarjetas tengan un buen rendimiento, el tamaño máximo de la imagen recomendado es de 2 MB.

Solución de problemas

Cuando una app o tarjeta de Google Chat devuelve un error, la interfaz de Chat muestra un mensaje que dice “Se produjo un error” o “No se pudo procesar tu solicitud”. A veces, la IU de Chat no muestra ningún mensaje de error, pero la app o la tarjeta de Chat producen un resultado inesperado; por ejemplo, es posible que no aparezca un mensaje de tarjeta.

Aunque es posible que no se muestre un mensaje de error en la IU de Chat, hay mensajes de error descriptivos y datos de registro disponibles para ayudarte a corregir errores cuando se activa el registro de errores de las apps de chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar y corregir errores de Google Chat.