Google Chat ti consente di aggiungere la formattazione ai messaggi, ad esempio:
- Formattazione di base del testo, ad esempio grassetto, corsivo e barrato, in messaggi e messaggi della scheda.
- Testo collegato.
- @menzionare uno o tutti gli utenti in uno spazio di Chat.
- Aggiungi integrata e icone personalizzate solo nei messaggi delle schede.
Formattare un messaggio di testo
Chat consente di aggiungere la formattazione di base a un messaggio di testo, ad esempio: grassetto, corsivo e barrato utilizzando un piccolo sottoinsieme di sintassi Markdown. Tu formatta il testo in modo diverso nei messaggi rispetto ai messaggi scheda, perché il testo i messaggi vengono formattati con la stessa sintassi utilizzata da Chat utilizzati dagli utenti. Per formattare il testo visualizzato in una scheda, consulta: Formattare il messaggio di una scheda.
Per formattare i messaggi di testo, utilizza la seguente sintassi:
Formato | Simbolo | Sintassi di esempio | Testo visualizzato in Google Chat |
---|---|---|---|
Grassetto | * | *ciao* | 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 formattato mostra quanto segue in una chat spazio:
Visualizzare la formattazione del testo inviata in un messaggio
Quando un utente invia un messaggio, il corpo in testo normale del messaggio è incluso
campo text
. Alcune formattazioni che vengono applicate al messaggio di testo utilizzando Markdown
è nel campo text
. La formattazione aggiuntiva è
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 nella
UI di Chat, il campo text
contiene solo il testo, mentre il
Il campo formattedText
contiene i markup, il testo e il link ipertestuale. La
nell'esempio seguente viene mostrata la bozza di un messaggio con una parola collegata tramite link ipertestuale,
voci 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 esempio
http://www.example.com/
, Google Chat utilizza questo testo come testo del link e
automaticamente i link ipertestuali che indirizzano 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 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
Le app di chat possono invia SMS che @menzionano uno o tutti gli utenti in uno spazio di Chat. Le app di chat non possono menzionare utenti in una spazio in modalità di importazione o qualsiasi utente non partecipano allo spazio.
@menzionare utenti specifici
Per @menzionare un utente specifico, aggiungi <users/{user}>
al messaggio di testo in
{user}
è l'ID dell'utente. Ad esempio, considera il seguente testo
messaggio 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 dal
utente, puoi utilizzare il campo
message.sender.name
del Evento di interazioneMESSAGE
. Se la tua app Google Chat sta creando un'istanza messaggio di testo asincrono, puoi specificare il valore per
users/{user}
nei seguenti modi:- Utilizza il campo
name
di Google Chat RisorsaUser
, comeusers/123456789012345678901
. - Utilizza l'indirizzo email dell'utente come alias per il valore
{user}
. Per Ad esempio, se l'indirizzo email èmahan@example.com
, puoi specificare l'utente comeusers/mahan@example.com
. Per utilizzare un alias email, il tuo L'app Google Chat deve autenticarsi come utente.
- Utilizza il campo
Se utilizzi l'API People, puoi utilizzare anche Metodo
people.get
per identificare l'ID utente.
@menziona tutti gli utenti
Per creare un SMS che menzioni tutte le persone in uno spazio, sostituisci {user}
con all
. L'esempio JSON seguente menziona tutti gli utenti in un messaggio:
{
"text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}
Formattare 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 di tag HTML. Il formato del testo è diverso nei messaggi della scheda rispetto al testo messaggi di testo perché i messaggi sono formattati con la stessa sintassi Utilizzano la chat dagli utenti di Chat. Per formattare il testo visualizzato in un messaggio, procedi nel seguente modo: vedi Formattare un messaggio.
Utilizza Card Builder per progettare e visualizzare l'anteprima di messaggi delle schede JSON per le app di chat:
Apri il generatore di schedeI tag supportati e il loro scopo sono mostrati di seguito tabella:
Formato | Esempio | Risultato visualizzato |
---|---|---|
Grassetto | "This is <b>bold</b>." |
Questo campo è 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 campo è |
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. |
Ora | "This is a time format: <time>2023-02-16 15:00</time>." |
Questo è un formato di orario: . |
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
La
DecoratedText
e
ButtonList
i widget supportano l'elemento icon
utilizzata per specificare una delle icone integrate disponibili in Chat.
La tabella seguente elenca le icone integrate disponibili per i messaggi delle schede:
AEREO | SEGNAPOSTO | ||
BUS | AUTO | ||
OROLOGIO | CONFIRMATION_NUMBER_ICON | ||
DESCRIPTION | VALORE | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HOTEL | HOTEL_ROOM_TYPE | ||
INVITE | MAP_PIN | ||
ABBONAMENTO | MULTIPLE_PEOPLE | ||
PERSONA | TELEFONO | ||
RESTAURANT_ICON | SHOPPING_CART | ||
AGGIUNGI A SPECIALI | NEGOZIO | ||
BIGLIETTO | ADDESTRAMENTO | ||
VIDEO_CAMERA | VIDEO_PLAY |
La Ecco un esempio di scheda con l'icona di un'email:
Aggiungere un'icona di Google Material Design a una scheda
La
DecoratedText
e
ButtonList
i widget ti consentono di usare le icone di Google Material
per poter scegliere tra oltre 2500 opzioni di icone e personalizzare
peso, riempimento e livello delle icone.
Di seguito è riportato un esempio di scheda con un'icona Material Google:
Aggiungere un'icona personalizzata a una scheda
La
DecoratedText
e
ButtonList
i widget ti consentono di utilizzare le icone integrate o di definire le tue icone personalizzate. A
aggiungi un'icona personalizzata a una scheda, includi il campo iconUrl
e specifica
all'URL corrispondente.
Di seguito è riportato un esempio di icona personalizzata: