Formattare i messaggi

In questa pagina viene spiegato in che modo le app di Google Chat possono formattare il testo per inviare messaggi che contenere uno qualsiasi dei seguenti elementi:

• RTF che contiene link ipertestuali o @menzioni di uno o tutti gli utenti in un Spazio di Chat.
• Testo visualizzato nell'interfaccia di una scheda, ad esempio come testo di paragrafo o Testo dell'interfaccia utente che viene visualizzato accanto a un'icona, ad esempio un pulsante.

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 i messaggi di testo, utilizza la seguente sintassi:

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:

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 interazione MESSAGE.

• 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 Risorsa User, come users/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 come users/mahan@example.com. Per utilizzare un alias email, il tuo L'app Google Chat deve autenticarsi come utente.

• 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 testo visualizzato nelle schede

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.

Utilizza Card Builder per progettare e visualizzare l'anteprima dei messaggi e delle interfacce utente delle app di chat:

Formatta il testo del paragrafo

I tag supportati e il loro scopo sono mostrati di seguito tabella:

Aggiungi icone al testo

Per visualizzare le icone insieme al testo in una scheda, puoi utilizzare la DecoratedText e ButtonList widget.

Le seguenti sezioni spiegano come utilizzare le icone integrate, Google Material icone o icone personalizzate in testi o pulsanti decorati.

Utilizzare le icone di Chat

Per utilizzare le icone integrate disponibili in Chat, specificare una delle seguenti opzioni:

La tabella seguente elenca le icone integrate disponibili per i messaggi delle schede:

La Ecco un esempio di scheda con l'icona di un'email:

Utilizza le icone di Google Material

Puoi utilizzare le icone di Google Material per 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:

Utilizzare icone personalizzate

Per aggiungere un'icona personalizzata, includi il campo iconUrl e specifica il nome dell'icona all'URL corrispondente.

Di seguito è riportato un esempio di icona personalizzata: