Formattare i messaggi

Google Chat ti consente di aggiungere la formattazione ai messaggi, tra cui:

• Formattazione di base del testo, come grassetto, corsivo e barrato, nei messaggi e nei messaggi delle schede.
• Testo collegato.
• @menziona uno o tutti gli utenti in uno spazio di Chat.
• Aggiungi icone integrate e icone personalizzate solo nei messaggi delle schede.

Formattare un messaggio

Chat consente di aggiungere la formattazione di base a un messaggio, tra cui grassetto, corsivo e barrato, utilizzando un piccolo sottoinsieme di sintassi Markdown. Il formato del testo dei messaggi è diverso rispetto a quello dei messaggi di scheda, perché il formato dei messaggi è la stessa utilizzata dagli utenti di Chat. Per formattare il testo di una scheda, consulta Formattare un messaggio della scheda.

Per formattare gli SMS, utilizza la seguente sintassi:

Formato	Simbolo	Sintassi di esempio	Testo visualizzato in Google Chat
Grassetto	*	*ciao*	ciao
Corsivo	_ (trattino basso)	_ciao_	ciao
Barrato	~	~ciao~	ciao
Monospace	" (virgolette indietro)	"ciao"	hello
Blocco monospazio	' ' ' (tre virgolette)	``` Hello World ```	Hello World
Elenco puntato	* o - (trattino) seguito da uno spazio	* Questo è il primo elemento nell'elenco * Questo è il secondo elemento dell'elenco	Questo è il primo elemento nell'elenco Questo è il secondo elemento dell'elenco

Ad esempio, considera il seguente JSON:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Questo messaggio di testo formattato visualizza quanto segue in uno spazio di Chat:

Visualizzare la formattazione del testo inviata in un messaggio

Quando un utente invia un messaggio, il corpo in testo normale del messaggio si trova nel campo text. Una parte di formattazione applicata al messaggio utilizzando la sintassi Markdown si trova nel campo text. Una formattazione aggiuntiva è nel campo formattedText solo di output, che include quanto segue:

• Sintassi Markdown aggiuntiva per il testo
• Menzioni degli utenti
• Link ipertestuali personalizzati
• Emoji personalizzate

Ad esempio, considera il seguente testo inviato da un utente:

Se il messaggio è stato formattato utilizzando il menu Formato nell'interfaccia utente di Chat, il campo text contiene solo il testo, mentre il campo formattedText contiene i markup, il testo e il link ipertestuale. L'esempio seguente mostra la bozza di un messaggio con link ipertestuale a una parola, elementi in un elenco e una parola in grassetto:

Il messaggio viene ricevuto nel seguente formato:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Formattare i link

Se includi un URL di link semplice nel testo del messaggio, ad esempio http://www.example.com/, Google Chat lo utilizza come testo del link e lo collega automaticamente tramite link ipertestuale all'URL specificato.

Per fornire un testo alternativo per il link, utilizza la seguente sintassi:

Sintassi di esempio	Testo visualizzato in Google Chat
<https://example.com|Example website>	Example website

La barra verticale e il testo del link sono facoltativi, pertanto <https://www.example.com/> e https://www.example.com/ sono equivalenti.

Menziona gli utenti in un messaggio di testo

Le app di chat possono inviare SMS che @menzionano uno o tutti gli utenti in uno spazio di Chat. Le app di chat non possono menzionare utenti in uno spazio in modalità di importazione o utenti che non sono entrati nello spazio.

@menziona utenti specifici

Per @menzionare un utente specifico, aggiungi <users/{user}> al messaggio in cui {user} è l'ID dell'utente. Ad esempio, considera il seguente messaggio di testo in cui 123456789012345678901 rappresenta l'ID dell'utente Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Il messaggio viene visualizzato come segue:

Puoi specificare il valore users/{user} nei seguenti modi:

• Se la tua app Google Chat risponde a un messaggio inviato dall'utente, puoi utilizzare il campo message.sender.name dell'evento di interazione MESSAGE.

• Se la tua app Google Chat crea un messaggio di testo asincrono, puoi specificare il valore di users/{user} nei seguenti modi:

  • Utilizza il campo name della risorsa User di Google Chat, come users/123456789012345678901.
  • Utilizza l'indirizzo email dell'utente come alias per il valore {user}. Ad esempio, se l'indirizzo email è [e-mail], puoi specificare l'utente come users/[e-mail]. Per utilizzare un alias email, l'app Google Chat deve eseguire l'autenticazione come utente.

• Se utilizzi l'API People, puoi anche utilizzare il metodo people.get per identificare lo User-ID.

@menziona tutti gli utenti

Per creare un SMS che esegua una @menzione per tutti i membri di uno spazio, sostituisci {user} con all. Il seguente esempio JSON menziona tutti gli utenti di un messaggio:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Formatta il messaggio di una scheda

All'interno delle schede, la maggior parte dei campi di testo supporta la formattazione di base del testo utilizzando un piccolo sottoinsieme di tag HTML. Il formato dei messaggi è diverso da quello degli SMS perché i messaggi sono formattati con la stessa sintassi utilizzata dagli utenti di Chat. Per formattare il testo di un messaggio, vedi Formattare un messaggio di testo.

---

Utilizza Card Builder per progettare e visualizzare l'anteprima dei messaggi delle schede JSON per le app di chat:

Apri Card Builder

---

I tag supportati e il loro scopo sono mostrati nella seguente tabella:

Formato	Esempio	Risultato visualizzato
Grassetto	"This is <b>bold</b>."	Questo è in grassetto.
Corsivo	"This is <i>italics</i>."	Questo è in corsivo.
Sottolineato	"This is <u>underline</u>."	Questa è una sottolineato.
Barrato	"This is <s>strikethrough</s>."	Si tratta di un barrato.
Colore carattere	"This is <font color=\"#FF0000\">red font</font>."	Questo è un carattere rosso.
Link ipertestuale	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Questo è un link ipertestuale.
Tempo	"This is a time format: <time>2023-02-16 15:00</time>."	Questo è un formato dell'ora: 2023-02-16 15:00.
Nuova riga	"This is the first line. <br> This is a new line.	Questa è la prima riga. Questa è una nuova riga.

Aggiungere un'icona integrata a una scheda

I widget DecoratedText e ButtonList supportano l'elemento icon utilizzato per specificare una delle icone integrate disponibili in Chat.

Nella tabella seguente sono elencate le icone integrate disponibili per i messaggi delle schede:

	AEREO		BOOKMARK
	BUS		AUTO
	OROLOGIO		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		VALUTA
	EMAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	INVITA		MAP_PIN
	ABBONAMENTO		MULTIPLE_PEOPLE
	PERSONA		TELEFONO
	RESTAURANT_ICON		SHOPPING_CART
	AGGIUNGI A SPECIALI		NEGOZIO
	BIGLIETTO		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

Di seguito è riportato un esempio di scheda con un'icona email:

Aggiungere un'icona di Google Material Design a una scheda

I widget DecoratedText e ButtonList ti consentono di utilizzare le icone Google Material per scegliere tra oltre 2500 opzioni di icone e personalizzare la ponderazione, il riempimento e la valutazione delle icone.

Di seguito è riportato un esempio di carta con un'icona Google Material:

Aggiungere un'icona personalizzata a una scheda

I widget DecoratedText e ButtonList ti consentono di utilizzare le icone integrate o di definire icone personalizzate. Per aggiungere un'icona personalizzata a una scheda, includi il campo iconUrl e specifica l'URL corrispondente dell'icona.

Di seguito è riportato un esempio di icona personalizzata: