In Google Chat können Sie Nachrichten formatieren, z. B.:
- Grundlegende Textformatierungen wie fett, kursiv und durchgestrichen in Textnachrichten und Kartennachrichten.
- Verknüpfter Text:
- einen oder alle Nutzer in einem Chatbereich@erwähnen.
- Integrierte und benutzerdefinierte Symbole werden nur in Kartennachrichten eingefügt.
SMS formatieren
Mit Chat können Sie einer Textnachricht mithilfe einer kleinen Teilmenge der Markdown-Syntax grundlegende Formatierungen hinzufügen, einschließlich Fett-, Kursiv- und Durchgestrichen. Sie formatieren Text in Textnachrichten anders als in Kartennachrichten, da Textnachrichten mit derselben Syntax wie Chat-Nutzer formatiert sind. Informationen zum Formatieren von Text, der auf einer Karte angezeigt wird, findest du unter Kartennachricht formatieren.
Verwenden Sie zum Formatieren von Textnachrichten die folgende Syntax:
Format | Symbol | Beispielsyntax | In Google Chat angezeigter Text |
---|---|---|---|
Fett | * | *Hallo* | Hallo |
Kursiv | _ (Unterstrich) | _Hallo_ | Hallo |
Durchgestrichen | ~ | ~Hallo~ | |
Festbreitenschrift | ` (zurückes Anführungszeichen) | „Hallo“ | hello |
Festbreitenschrift | ` ` ` (drei Anführungszeichen) | ``` Hello World ``` |
Hello |
Liste mit Aufzählungszeichen | * oder - (Bindestrich), gefolgt von einem Leerzeichen | * Dies ist der erste Eintrag in der Liste. * Dies ist der zweite Eintrag in der Liste. |
|
Betrachten Sie zum Beispiel die folgende JSON-Datei:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
Diese formatierte Textnachricht zeigt in einem Chatbereich Folgendes an:
In einer Nachricht gesendete Textformatierungen ansehen
Wenn ein Nutzer eine Nachricht sendet, befindet sich der Nur-Text der Nachricht im Feld text
. Einige Formatierungen, die mithilfe der Markdown-Syntax auf die Textnachricht angewendet werden, befinden sich im Feld text
. Das reine Ausgabefeld formattedText
enthält zusätzliche Formatierungen, darunter:
- Zusätzliche Markdown-Syntax für Text
- Nutzererwähnung
- Benutzerdefinierte Hyperlinks
- Benutzerdefinierte Emojis
Betrachten Sie zum Beispiel den folgenden Text, der von einem Nutzer gesendet wurde:
Wenn die Nachricht über das Menü Format in der Chat-UI formatiert wurde, enthält das Feld text
nur den Text, während das Feld formattedText
die Markups, den Text und den Hyperlink enthält. Das folgende Beispiel zeigt den Entwurf einer Textnachricht mit einem Wort als Hyperlink, Elementen in einer Liste und einem Wort fett gedruckt:
Die Nachricht wird in folgendem Format empfangen:
{
"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*?",
}
Links formatieren
Wenn Sie im Nachrichtentext eine einfache Link-URL angeben, z. B. http://www.example.com/
, verwendet Google Chat diese als Linktext und verknüpft diesen Text automatisch mit der angegebenen URL.
Verwenden Sie die folgende Syntax, um alternativen Linktext für Ihren Link bereitzustellen:
Beispielsyntax | In Google Chat angezeigter Text |
---|---|
<https://example.com|Example website> |
Der senkrechte Strich und der Linktext sind optional, sodass <https://www.example.com/>
und https://www.example.com/
gleichwertig sind.
Nutzer in einer SMS erwähnen
Chat-Apps können SMS senden, in denen ein oder alle Nutzer in einem Chatbereich @erwähnt werden. Chat-Apps dürfen keine Nutzer in einem Projektbereich im Importmodus oder Nutzer erwähnen, die dem Gruppenbereich nicht beigetreten sind.
Bestimmte Nutzer @erwähnen
Wenn Sie einen bestimmten Nutzer @erwähnen möchten, fügen Sie der SMS <users/{user}>
hinzu, wobei {user}
die ID des Nutzers ist. Sehen Sie sich zum Beispiel die folgende Textnachricht an, in der 123456789012345678901
die ID für den Nutzer Mahan S. darstellt:
{
"text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}
Die Textnachricht wird wie folgt angezeigt:
Sie können den Wert users/{user}
auf folgende Arten angeben:
- Wenn Ihre Google Chat-App auf eine vom Nutzer gesendete Nachricht reagiert, können Sie das Feld
message.sender.name
des InteraktionsereignissesMESSAGE
verwenden. Wenn Ihre Google Chat-Anwendung eine asynchrone Textnachricht erstellt, können Sie den Wert für
users/{user}
auf folgende Arten angeben:- Verwenden Sie das Feld
name
der Google Chat-RessourceUser
, z. B.users/123456789012345678901
. - Verwenden Sie die E-Mail-Adresse des Nutzers als Alias für den
{user}
-Wert. Wenn die E-Mail-Adresse beispielsweisemahan@example.com
lautet, können Sie den Nutzer alsusers/mahan@example.com
angeben. Damit Sie einen E-Mail-Alias verwenden können, muss sich Ihre Google Chat-Anwendung als Nutzer authentifizieren.
- Verwenden Sie das Feld
Wenn Sie die People API verwenden, können Sie die User-ID auch mit der Methode
people.get
identifizieren.
Alle Nutzer @erwähnen
Wenn Sie eine SMS erstellen möchten, in der alle Personen in einem Gruppenbereich @erwähnt werden, ersetzen Sie {user}
durch all
. Im folgenden JSON-Beispiel werden alle Nutzer in einer Nachricht erwähnt:
{
"text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}
Nachrichten auf einer Karte formatieren
In Karten unterstützen die meisten Textfelder eine einfache Textformatierung, da nur eine kleine Gruppe von HTML-Tags verwendet wird. Sie formatieren Text in Kartennachrichten anders als in Textnachrichten, da Textnachrichten mit derselben Syntax wie Chat-Nutzer formatiert sind. Informationen zum Formatieren von Text in einer Textnachricht finden Sie unter Textnachricht formatieren.
Mit dem Card Builder kannst du JSON-Kartennachrichten für Chat-Apps entwerfen und als Vorschau ansehen:
Den Card Builder öffnenDie unterstützten Tags und ihr Zweck sind in der folgenden Tabelle aufgeführt:
Format | Beispiel | Gerendertes Ergebnis |
---|---|---|
Fett | "This is <b>bold</b>." |
Diese ist fett. |
Kursiv | "This is <i>italics</i>." |
Dieser Text ist kursiv. |
Unterstreichen | "This is <u>underline</u>." |
Dieser ist unterstrichen. |
Durchgestrichen | "This is <s>strikethrough</s>." |
Das ist |
Schriftfarbe | "This is <font color=\"#FF0000\">red font</font>." |
Sie hat rote Schrift. |
Hyperlink | "This is a <a href=\"https://www.google.com\">hyperlink</a>." |
Dies ist ein Hyperlink. |
Uhrzeit | "This is a time format: <time>2023-02-16 15:00</time>." |
Dies ist ein Zeitformat: . |
Zeilenvorschub | "This is the first line. <br> This is a new line. “ |
Das ist die erste Zeile. Dies ist eine neue Zeile. |
Einer Karte ein integriertes Symbol hinzufügen
Die Widgets DecoratedText
und ButtonList
unterstützen das Element icon
, mit dem eines der integrierten Symbole angegeben wird, die in Google Chat verfügbar sind.
In der folgenden Tabelle sind die integrierten Symbole aufgeführt, die für Kartennachrichten verfügbar sind:
FLUG | BOOKMARK | ||
BUS | Auto | ||
UHR | CONFIRMATION_NUMBER_ICON | ||
DESCRIPTION | Dollar | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HOTEL | HOTEL_ROOM_TYPE | ||
EINLADEN | MAP_PIN | ||
MITGLIEDSCHAFT | MULTIPLE_PEOPLE | ||
PERSON | SMARTPHONE | ||
RESTAURANT_ICON | SHOPPING_CART | ||
Stern | GESCHÄFT | ||
TICKET | TRAIN | ||
VIDEO_CAMERA | VIDEO_PLAY |
Hier ein Beispiel für eine Karte mit einem E-Mail-Symbol:
Google Material Design-Symbol zu einer Karte hinzufügen
Mit den Widgets DecoratedText
und ButtonList
können Sie die Material-Symbole von Google verwenden, sodass Sie aus mehr als 2.500 Symboloptionen auswählen und Gewicht, Füllung und Grad der Symbole anpassen können.
Hier ist ein Beispiel für eine Karte mit einem Google Material-Symbol:
Benutzerdefiniertes Symbol zu einer Karte hinzufügen
Mit den Widgets DecoratedText
und ButtonList
können Sie die integrierten Symbole verwenden oder eigene benutzerdefinierte Symbole definieren. Wenn Sie einer Karte ein benutzerdefiniertes Symbol hinzufügen möchten, schließen Sie das Feld iconUrl
ein und geben Sie die entsprechende URL des Symbols an.
Hier ein Beispiel für ein benutzerdefiniertes Symbol: