Cards v1

Carta

Una scheda è un elemento UI che può contenere widget UI come testo e immagini.

Rappresentazione JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Campi
header

object (CardHeader)

L'intestazione della scheda. Un'intestazione di solito contiene un titolo e un'immagine.

sections[]

object (Section)

Le sezioni sono separate da una linea di divisione.

cardActions[]

object (CardAction)

Le azioni di questa scheda.

name

string

Nome della carta.

CardHeader

Rappresentazione JSON 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
Campi
title

string

È necessario specificare il titolo. L'intestazione ha un'altezza fissa: se vengono specificati sia un titolo che un sottotitolo, ciascuno occupa una riga. Se viene specificato solo il titolo, questo occupa entrambe le righe.

subtitle

string

Il sottotitolo dell'intestazione della scheda.

imageStyle

enum (ImageStyle)

Il tipo di immagine (ad esempio, bordo quadrato o bordo circolare).

imageUrl

string

L'URL dell'immagine nell'intestazione della scheda.

ImageStyle

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Bordo quadrato.
AVATAR Bordo circolare.

Sezione

Una sezione contiene una raccolta di widget che vengono visualizzati (verticalmente) nell'ordine in cui sono specificati. Su tutte le piattaforme, le schede hanno una larghezza fissa ridotta, quindi al momento non sono necessarie proprietà di layout (ad esempio, float).

Rappresentazione JSON 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
Campi
header

string

L'intestazione della sezione. Il testo formattato è supportato. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

widgets[]

object (WidgetMarkup)

Una sezione deve contenere almeno un widget.

WidgetMarkup

Un widget è un elemento UI che presenta testo e immagini.

Rappresentazione JSON 
{
  "buttons": [
    {
      object (Button)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
Campi
buttons[]

object (Button)

Un elenco di pulsanti. Anche Buttons è oneof data e deve essere impostato solo uno di questi campi.

Un WidgetMarkup può avere solo uno dei seguenti elementi. Puoi utilizzare più campi WidgetMarkup per visualizzare più elementi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textParagraph

object (TextParagraph)

Visualizza un paragrafo di testo in questo widget.

image

object (Image)

Visualizza un'immagine in questo widget.

keyValue

object (KeyValue)

Visualizza un elemento chiave-valore in questo widget.

Fine dei campi che si escludono a vicenda.

TextParagraph

Un paragrafo di testo. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Immagine

Un'immagine specificata da un URL e che può avere un'azione onclick .

Rappresentazione JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
Campi
imageUrl

string

L'URL dell'immagine.

onClick

object (OnClick)

L'azione onclick.

aspectRatio

number

Le proporzioni di questa immagine (larghezza e altezza). Questo campo ti consente di riservare l'altezza corretta per l'immagine in attesa del caricamento. Non è destinato a sostituire le proporzioni integrate dell'immagine. Se non è impostato, il server lo compila eseguendo il precaricamento dell'immagine.

OnClick

Un'azione onclick (ad esempio, l'apertura di un link).

Rappresentazione JSON 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
action

object (FormAction)

Un'azione del modulo viene attivata da questa azione onclick, se specificata.

Fine dei campi che si escludono a vicenda.

FormAction

Un'azione del modulo descrive il comportamento quando il modulo viene inviato. Ad esempio, puoi richiamare Apps Script per gestire il modulo.

Rappresentazione JSON 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
Campi
actionMethodName

string

Il nome del metodo viene utilizzato per identificare la parte del modulo che ha attivato l'invio del modulo. Queste informazioni vengono restituite all'app di Chat nell'ambito dell'evento di clic sulla scheda. Puoi utilizzare lo stesso nome di metodo per più elementi che attivano un comportamento comune.

parameters[]

object (ActionParameter)

Elenco dei parametri dell'azione.

ActionParameter

Elenco di parametri di stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, considera tre pulsanti di posticipo: posticipa ora, posticipa di un giorno, posticipa alla prossima settimana. Puoi utilizzare action method = snooze(), passando il tipo di posticipo e l'ora di posticipo nell'elenco dei parametri di stringa.

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

string

Il nome del parametro per lo script dell'azione.

value

string

Il valore del parametro.

KeyValue

Un elemento UI contiene una chiave (etichetta) e un valore (contenuto). Questo elemento può anche contenere alcune azioni, ad esempio il pulsante onclick.

Rappresentazione JSON 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
Campi
topLabel

string

Il testo dell'etichetta superiore. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

content

string

Il testo dei contenuti. Il testo formattato è supportato e sempre obbligatorio. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

contentMultiline

boolean

Se i contenuti devono essere su più righe.

bottomLabel

string

Il testo dell'etichetta inferiore. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

onClick

object (OnClick)

L'azione onclick. Solo l'etichetta superiore, l'etichetta inferiore e l'area dei contenuti sono cliccabili.

È necessario definire almeno uno tra icons, top_label e bottom_label. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
icon

enum (Icon)

Un valore enum che viene sostituito dall'API Chat con l'immagine dell'icona corrispondente.

iconUrl

string

L'icona specificata da un URL.

Fine dei campi che si escludono a vicenda.
Un widget di controllo. Puoi impostare button o switch_widget, ma non entrambi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
button

object (Button)

Un pulsante su cui è possibile fare clic per attivare un'azione.

Fine dei campi che si escludono a vicenda.

Icona

L'insieme di icone supportate.

Enum
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

Pulsante

Pulsante A. Può essere un pulsante di testo o un pulsante immagine.

Rappresentazione JSON 
{

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textButton

object (TextButton)

Un pulsante con testo e azione onclick.

imageButton

object (ImageButton)

Un pulsante con immagine e azione onclick.

Fine dei campi che si escludono a vicenda.

TextButton

Un pulsante con testo e azione onclick.

Rappresentazione JSON 
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
Campi
text

string

Il testo del pulsante.

onClick

object (OnClick)

L'azione onclick del pulsante.

ImageButton

Un pulsante immagine con un'azione onclick.

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

  "icon": enum (Icon),
  "iconUrl": string
}
Campi
onClick

object (OnClick)

L'azione onclick.

name

string

Il nome di questo imageButton utilizzato per l'accessibilità. Se questo nome non viene specificato, viene fornito il valore predefinito.

L'icona può essere specificata da un Icon enum o da un URL. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
icon

enum (Icon)

L'icona specificata da un enum che rimanda a un'icona fornita dall'API Chat.

iconUrl

string

L'icona specificata da un URL.

Fine dei campi che si escludono a vicenda.

CardAction

Un'azione della scheda è l'azione associata alla scheda. Per una scheda di fattura, un'azione tipica potrebbe essere: eliminare la fattura, inviarla via email o aprirla nel browser.

Non supportato dalle app di Google Chat.

Rappresentazione JSON 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
Campi
actionLabel

string

L'etichetta utilizzata per la visualizzazione nella voce del menu Azioni.

onClick

object (OnClick)

L'azione onclick per questa attività.