Formattare i messaggi

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

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:

L'app Cymbal Pizza ti invia un messaggio per informarti che la consegna è arrivata.

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:

Messaggio ricevuto in Chat con la parola

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:

Bozza di messaggio con la parola

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*?",
    }

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>

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:

L&#39;app di chat menziona una persona in un messaggio.

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 è mahan@example.com, puoi specificare l'utente come users/mahan@example.com. 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.


Progetta e visualizza l'anteprima delle schede con Card Builder.

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: .
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 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: