Questa pagina spiega in che modo le app Google Chat possono formattare il testo per inviare messaggi che contengono uno dei seguenti elementi:
- Testo avanzato contenente link ipertestuali o menzioni @ di uno o tutti gli utenti in uno spazio Chat.
- Testo visualizzato nell'interfaccia di una scheda, ad esempio testo di paragrafo o testo dell'interfaccia utente visualizzato accanto a un'icona, ad esempio un pulsante.
Formattare un messaggio
Chat consente di aggiungere formattazione di base a un messaggio di testo, inclusi grassetto, corsivo e barrato, utilizzando un piccolo sottoinsieme di sintassi Markdown. Il testo viene visualizzato in modo diverso nei messaggi di testo rispetto ai messaggi della scheda perché i messaggi di testo sono formattati con la stessa sintassi utilizzata dagli utenti di Chat.
Per formattare i messaggi, utilizza la seguente sintassi:
Formato | Simbolo | Sintassi di esempio | Testo visualizzato in Google Chat |
---|---|---|---|
Grassetto | * | *hello* | ciao |
Corsivo | _ (trattino basso) | _hello_ | ciao |
Barrato | ~ | ~ciao~ | |
Monospace | ' (citazione inversa) | "ciao" | hello |
Blocco monospaziale | ` ` ` (tre virgolette) | ``` Hello World ``` |
Hello |
Elenco puntato | * o - (trattino) seguito da uno spazio | * Questo è il primo elemento dell'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 mostra quanto segue in uno spazio 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 campotext
. Alcune formattazioni applicate al messaggio utilizzando la sintassi Markdown si trovano nel campo text
. La formattazione aggiuntiva è presente nel campo formattedText
solo di output, tra cui:
- 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 di testo con una parola collegata tramite link ipertestuale, gli elementi di 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 normale nel testo del messaggio, ad esempiohttp://www.example.com/
, Google Chat lo utilizza come testo del link e lo collega automaticamente all'URL specificato.
Per fornire il testo alternativo del link, utilizza la seguente sintassi:
Sintassi di esempio | Testo visualizzato in Google Chat |
---|---|
<https://example.com|Example website> |
La barra e il testo del link sono facoltativi, quindi <https://www.example.com/>
e
https://www.example.com/
sono equivalenti.
Menzionare gli utenti in un messaggio
Le app di chat possono inviare messaggi che menzionano uno o tutti gli utenti di uno spazio di Chat. Le app di Chat non possono menzionare gli utenti di un spazio in modalità di importazione o gli utenti che non hanno aderito allo spazio.
@menzionare utenti specifici
Per menzionare un utente specifico, aggiungi <users/{user}>
al messaggio, dove {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 l'app Google Chat risponde a un messaggio inviato dall'utente, puoi utilizzare il campo
message.sender.name
dell'evento di interazioneMESSAGE
. Se l'app Google Chat crea un messaggio di testo asincrono, puoi specificare il valore per
users/{user}
nei seguenti modi:- Utilizza il campo
name
della risorsaUser
di Google Chat, ad esempiousers/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 autenticarsi come utente.
- Utilizza il campo
Se utilizzi l'API People, puoi anche utilizzare il metodo
people.get
per identificare l'ID utente.
@menziona tutti gli utenti
Per creare un messaggio che menzioni tutti i membri di uno spazio, sostituisci {user}
con all
. Il seguente esempio JSON menziona tutti gli utenti in un messaggio:
{
"text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}
Formattare il testo visualizzato nelle schede
All'interno delle schede, la maggior parte dei campi di testo supporta la formattazione di base del testo utilizzando un piccolo insieme di tag HTML. Il formato del testo è diverso nei messaggi delle schede rispetto ai messaggi perché i messaggi sono formattati con la stessa sintassi utilizzata dagli utenti di Chat.
Utilizza lo strumento per la creazione di schede per progettare e visualizzare l'anteprima di interfacce utente e messaggistica per le app di chat:
Apri lo strumento per la creazione di schedeFormatta il testo del paragrafo
I tag supportati e il loro scopo sono riportati nella tabella seguente:
Formato | Esempio | Risultato visualizzato |
---|---|---|
Grassetto | "This is <b>bold</b>." |
Questo testo è in grassetto. |
Corsivo | "This is <i>italics</i>." |
È in corsivo. |
Sottolineato | "This is <u>underline</u>." |
Questo è sottolineato. |
Barrato | "This is <s>strikethrough</s>." |
Questo è il |
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>." |
Si tratta di un link ipertestuale. |
Ora | "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. |
Aggiungi icone al testo
Per visualizzare le icone accanto al testo in una scheda, puoi utilizzare i widget DecoratedText
e ButtonList
.
Le seguenti sezioni spiegano come utilizzare icone integrate, icone Google Material o icone personalizzate in testi o pulsanti decorati.
Utilizzare le icone di Chat
Per utilizzare le icone integrate disponibili in Chat, specifica una delle seguenti opzioni:
La tabella seguente elenca le icone integrate disponibili per i messaggi delle schede:
AIRPLANE | SEGNAPOSTO | ||
BUS | AUTO | ||
OROLOGIO | CONFIRMATION_NUMBER_ICON | ||
DESCRIPTION | DOLLARO | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HOTEL | HOTEL_ROOM_TYPE | ||
INVITA | MAP_PIN | ||
ABBONAMENTO | MULTIPLE_PEOPLE | ||
PERSON | TELEFONO | ||
RESTAURANT_ICON | SHOPPING_CART | ||
STAR | NEGOZIO | ||
TICKET | ADDESTRAMENTO | ||
VIDEO_CAMERA | VIDEO_PLAY |
Di seguito è riportato un esempio di scheda con un'icona email:
Utilizzare le icone di Google Material
Puoi utilizzare le icone di Material Design di Google per scegliere tra oltre 2500 opzioni di icone e personalizzare spessore, riempimento e qualità delle icone.
Di seguito è riportato un esempio di scheda con un'icona di Materiale Google:
Utilizzare icone personalizzate
Per aggiungere un'icona personalizzata, includi il campo iconUrl
e specifica l'URL
corrispondente all'icona.
Di seguito è riportato un esempio di icona personalizzata: