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~ | |
Monospace | " (virgolette indietro) | "ciao" | hello |
Blocco monospazio | ' ' ' (tre virgolette) | ``` Hello World ``` |
Hello |
Elenco puntato | * o - (trattino) seguito da uno spazio | * 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> |
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 interazioneMESSAGE
. 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 risorsaUser
di Google Chat, comeusers/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 comeusers/mahan@example.com
. Per utilizzare un alias email, l'app Google Chat deve eseguire l'autenticazione come utente.
- Utilizza il campo
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 BuilderI 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 |
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 | ||
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: