Cards v1

Scheda

Una scheda è un elemento dell'interfaccia utente che può contenere widget dell'interfaccia utente 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 un divisore di riga.

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

Il titolo deve essere specificato. L'intestazione ha un'altezza fissa: se vengono specificati sia un titolo che un sottotitolo, entrambi occupano 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 fissa, quindi al momento non sono necessarie le proprietà di layout (ad esempio, mobile).

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, vedi 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 dell'interfaccia utente che presenta testo e immagini.

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

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
Campi
buttons[]

object (Button)

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

Campo unione data. Un WidgetMarkup può avere solo uno dei seguenti elementi. Puoi utilizzare più campi WidgetMarkup per visualizzare più elementi. data può essere solo uno dei seguenti:
textParagraph

object (TextParagraph)

Mostra un paragrafo di testo in questo widget.

image

object (Image)

Visualizza un'immagine in questo widget.

keyValue

object (KeyValue)

Mostra un elemento chiave-valore in questo widget.

TextParagraph

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

Rappresentazione JSON
{
  "text": string
}
Campi
text

string

Immagine

Un'immagine che è specificata da un URL e 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 dell'immagine (larghezza e altezza). Questo campo ti consente di riservare l'altezza giusta per l'immagine in attesa del suo caricamento. Non ha lo scopo di sostituire le proporzioni predefinite dell'immagine. Se il criterio non viene configurato, il server lo riempie precaricando l'immagine.

OnClick

Un'azione onclick (ad esempio, aprire un link).

Rappresentazione JSON
{

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

Campo unione data.

data può essere solo uno dei seguenti:

action

object (FormAction)

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

FormAction

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

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

string

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

parameters[]

object (ActionParameter)

Elenco dei parametri di azione.

ActionParameter

Elenco di parametri stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, considera tre pulsanti per posticiparla: Posticipa ora, Posticipa un giorno e Posticipa la prossima settimana. Puoi utilizzare action method = snooze(), per trasmettere il tipo e il tempo di posticipazione nell'elenco dei parametri stringa.

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

string

Il nome del parametro per l'action script.

value

string

Il valore del parametro.

KeyValue

Un elemento UI contiene una chiave (etichetta) e un valore (contenuti). Questo elemento può anche contenere alcune azioni come il pulsante onclick.

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

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
Campi
topLabel

string

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

content

string

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

contentMultiline

boolean

Se i contenuti devono essere su più righe.

bottomLabel

string

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

onClick

object (OnClick)

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

Campo unione icons. È necessario definire almeno una delle icone, top_label e bottom_label. icons può essere solo uno dei seguenti:
icon

enum (Icon)

Un valore enumerato sostituito dall'API Chat con l'immagine dell'icona corrispondente.

iconUrl

string

L'icona specificata da un URL.

Campo unione control. Un widget di controllo. Puoi impostare button o switch_widget, ma non entrambe. control può essere solo uno dei seguenti:
button

object (Button)

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

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

Un pulsante. Può essere un pulsante di testo o un pulsante immagine.

Rappresentazione JSON
{

  // Union field type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
Campi

Campo unione type.

type può essere solo uno dei seguenti:

textButton

object (TextButton)

Un pulsante con testo e onclick un'azione.

imageButton

object (ImageButton)

Un pulsante con immagine e azione onclick.

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'onclick azione del pulsante.

ImageButton

Un pulsante immagine con un'azione onclick.

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

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Campi
onClick

object (OnClick)

L'azione onclick.

name

string

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

Campo unione icons. L'icona può essere specificata tramite un Icon enum o un URL. icons può essere solo uno dei seguenti:
icon

enum (Icon)

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

iconUrl

string

L'icona specificata da un URL.

CardAction

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

Non supportata dalle app Google Chat.

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

string

In precedenza, l'etichetta veniva visualizzata nell'elemento del menu Azione.

onClick

object (OnClick)

L'azione YAML per questa attività.