Immagine

Il widget Image mostra un'immagine .png o .jpg ospitata su un URL HTTPS. L'immagine visualizzata riempie l'intera larghezza della scheda visualizzata e la sua altezza viene regolata per mantenere le proporzioni dell'immagine.

Il widget Image supporta le azioni onclick che si verificano quando gli utenti fanno clic sull'immagine. Ecco alcuni esempi di azioni onclick:

• Apri un link ipertestuale con OpenLink, ad esempio un link ipertestuale alla documentazione per gli sviluppatori di Google Chat, https://developers.google.com/chat.
• Eseguire un'azione che esegue una funzione personalizzata, ad esempio chiamare un'API.

Esempio: un'immagine cliccabile

La seguente immagine mostra una scheda composta da un widget Image. Viene visualizzata l'immagine della pagina di destinazione della documentazione per gli sviluppatori di Google Chat. Quando gli utenti fanno clic sull'immagine, la documentazione per gli sviluppatori di Google Chat si apre in una nuova scheda.

Figura 1: un messaggio relativo alle schede in Google Chat che mostra un widget Image.

Ecco il codice JSON della scheda:

JSON

{
  "cardsV2": [
    {
      "cardId": "exampleCard",
      "card": {
        "sections": [
          {
            "widgets": [
              {
                "image": {
                  "imageUrl": "https://developers.google.com/chat/images/chat-app-hero-image_1440.png",
                  "onClick": {
                    "openLink": {
                      "url": "https://developers.google.com/chat",
                    }
                  },
                  "altText": "The Google Chat developer documentation landing page image."
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Image Rappresentazione e campi JSON

Rappresentazione JSON
{ "imageUrl": string, "onClick": { object (OnClick) }, "altText": string }

Campi
imageUrl	string L'URL https che ospita l'immagine. Ad esempio: https://developers.google.com/chat/images/quickstart-app-avatar.png
onClick	object ( OnClick ) Quando un utente fa clic sull'immagine, il clic attiva questa azione.
altText	string Il testo alternativo di questa immagine, usato per l'accessibilità.

Onclick

Rappresenta come rispondere quando gli utenti fanno clic su un elemento interattivo su una scheda, ad esempio un pulsante.

Rappresentazione 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. }

Campi
Campo Union data . data può essere solo uno dei seguenti:
action	object ( Action ) Se specificato, un'azione viene attivata da onClick .
openLink	object ( OpenLink ) Se specificato, onClick attiva un'azione di link aperta.
openDynamicLinkAction	object ( Action ) Un componente aggiuntivo attiva questa azione quando deve aprire un link. È diverso da openLink riportato sopra per il fatto che deve comunicare con il server per ottenere il link. Quindi è necessario che il client web esegua alcune operazioni di preparazione prima che la risposta all'azione del link aperto ritorni.
card	object ( Card ) Se selezionata, viene eseguito il push di una nuova scheda nell'elenco di schede dopo aver fatto clic. Supportato dai componenti aggiuntivi di Google Workspace, ma non dalle app di chat.

Action

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

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

Campi
function	string Una funzione personalizzata da richiamare quando viene fatto clic sull'elemento contenitore o attivato in modo orizzontale. Ad esempio, consulta Creare schede interattive .
parameters[]	object ( ActionParameter ) Elenco dei parametri delle azioni.
loadIndicator	enum ( LoadIndicator ) Specifica l'indicatore di caricamento visualizzato dall'azione durante l'invito all'azione.
persistValues	boolean Indica se i valori del modulo persistono dopo l'azione. Il valore predefinito è false . Se true , i valori del modulo rimangono dopo l'attivazione dell'azione. Quando utilizzi LoadIndicator.NONE per le azioni, è consigliabile persistValues = true e assicurare che eventuali modifiche apportate dall'utente dopo l'invio del modulo o le azioni di modifica al server non vengano sovrascritte dalla risposta. Se false , i valori del modulo vengono cancellati quando viene attivata l'azione. Se persistValues è impostato su false , è vivamente consigliato utilizzare la scheda LoadIndicator.SPINNER per tutte le azioni, poiché questa operazione blocca la UI per garantire che l'utente non apporti modifiche durante l'elaborazione. Funzionalità non supportata dalle app di chat.
interaction	enum ( Interaction ) (Facoltativo) Obbligatorio quando apri una finestra di dialogo . Che cosa fare in risposta a un'interazione con un utente, ad esempio se un utente fa clic sul pulsante nel messaggio di una scheda. Se non specificati, l'app risponde eseguendo un action (come l'apertura di un link o eseguendo una funzione) come di consueto. Se specifichi un interaction , l'app può rispondere in modi speciali e interattivi. Ad esempio, impostando interaction su OPEN_DIALOG , l'app può aprire una finestra di dialogo . Se specificato, non viene mostrato un indicatore di caricamento. Supportato dalle app di chat, ma non dai componenti aggiuntivi di Google Workspace. Se si specifica un componente aggiuntivo, si rimuove l'intera scheda e non viene mostrato nulla nel client.

ActionParameter

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

Per scoprire di più, consulta CommonEventObject .

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

Campi
key	string Il nome del parametro per lo script di azione.
value	string Il valore del parametro.

LoadIndicator

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

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

Interaction

(Facoltativo) Obbligatorio quando apri una finestra di dialogo .

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

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

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

Se specificato, non viene mostrato un indicatore di caricamento.

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

Enum
INTERACTION_UNSPECIFIED	Valore predefinito. action viene eseguito normalmente.
OPEN_DIALOG	Consente di aprire una finestra di dialogo , un'interfaccia con finestra basata su schede che le app di chat utilizzano per interagire con gli utenti. Supportato solo dalle app di Chat in risposta ai clic sui pulsanti nei messaggi delle schede. Non supportati dai componenti aggiuntivi di Google Workspace. Se si specifica un componente aggiuntivo, si rimuove l'intera scheda e non viene mostrato nulla nel client.

OpenLink

Rappresenta un evento onClick che apre un link ipertestuale.

Rappresentazione JSON
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

Campi
url	string L'URL da aprire.
openAs	enum ( OpenAs ) Come aprire un link: Funzionalità non supportata dalle app di chat.
onClose	enum ( OnClose ) Indica se il client dimentica un link dopo averlo aperto o se lo osserva fino alla chiusura della finestra. Funzionalità non supportata dalle app di chat.

Limiti e considerazioni

• Sono supportate solo immagini .png e .jpg.
• L'URL host deve essere HTTPS.
• Per garantire prestazioni ottimali, la dimensione massima consigliata per l'immagine è 2 MB.