Formatmeldungen

Auf dieser Seite wird erläutert, wie Google Chat-Apps Text formatieren können, um Nachrichten zu senden, die Folgendes enthalten:

• Rich-Text mit Hyperlinks oder @Erwähnungen von einem oder allen Nutzern in einem Chatbereich
• Text, der in einer Kartenoberfläche angezeigt wird, einschließlich Absatztext oder UI-Text, der neben einem Symbol wie einer Schaltfläche angezeigt wird.

SMS formatieren

In Google Chat können Sie einer Nachricht mithilfe einer kleinen Auswahl an Markdown-Syntax grundlegende Formatierungen hinzufügen, z. B. fett, kursiv oder durchgestrichen. In SMS wird Text anders formatiert als in Kartennachrichten, da SMS mit derselben Syntax wie Chatnachrichten formatiert werden.

Verwenden Sie die folgende Syntax, um Nachrichten zu formatieren:

Format	Symbol	Beispielsyntax	In Google Chat angezeigter Text
Fett	*	*Hallo*	Hallo
Kursiv	_ (Unterstrich)	_Hallo_	Hallo
Durchgestrichen	~	~Hallo~	Hallo
Festbreitenschrift	` (Backquote)	„hallo“	hello
Block mit monospace-Schrift	` ` ` (drei Backticks)	``` Hallo Welt ```	Hello World
Aufzählungsliste	* oder - (Bindestriche) gefolgt von einem Leerzeichen	* Das ist das erste Element in der Liste. * Dies ist das zweite Element in der Liste.	Dies ist der erste Eintrag in der Liste. Dies ist der zweite Punkt in der Liste.

Betrachten Sie beispielsweise das folgende JSON-Objekt:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

In dieser formatierten Textnachricht wird in einem Chatbereich Folgendes angezeigt:

In einer Nachricht gesendete Textformatierung ansehen

Wenn ein Nutzer eine Nachricht sendet, befindet sich der Textkörper der Nachricht im Feld text. Einige Formatierungen, die mithilfe der Markdown-Syntax auf die SMS angewendet werden, befinden sich im Feld text. Das Feld formattedText ist nur für die Ausgabe vorgesehen und enthält zusätzliche Formatierungen, darunter:

• Zusätzliche Markdown-Syntax für Text
• Erwähnungen von Nutzern
• Benutzerdefinierte Hyperlinks
• Benutzerdefinierte Emojis

Betrachten wir beispielsweise den folgenden Text, der von einem Nutzer gesendet wurde:

Wenn die Nachricht über das Menü Format in der Chat-Benutzeroberfläche formatiert wurde, enthält das Feld text nur den Text, während das Feld formattedText die Markups, den Text und den Hyperlink enthält. Im folgenden Beispiel ist der Entwurf einer SMS zu sehen, in der ein Wort mit einem Hyperlink versehen, Elemente in einer Liste aufgeführt und ein Wort fett formatiert ist:

Die Nachricht wird im folgenden 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 eine reine Link-URL wie http://www.example.com/ in den Text Ihrer Nachricht einfügen, verwendet Google Chat diese als Linktext und erstellt automatisch einen Hyperlink zu der angegebenen URL.

Verwenden Sie die folgende Syntax, um einen alternativen Linktext für Ihren Link anzugeben:

Beispielsyntax	In Google Chat angezeigter Text
<https://example.com|Example website>	Example website

Die Pipe und der Linktext sind optional, sodass <https://www.example.com/> und https://www.example.com/ gleichwertig sind.

Nutzer in einer SMS erwähnen

Mit Chat-Apps können Textnachrichten gesendet werden, in denen ein oder alle Nutzer in einem Chatbereich @erwähnt werden. Wenn Sie Nutzer erwähnen möchten, die dem Gruppenbereich noch nicht beigetreten sind, oder einen Gruppenbereich, der sich im Importmodus befindet, müssen Chat-Apps die Nachricht mit Nutzerauthentifizierung senden.

Bestimmte Nutzer @erwähnen

Wenn Sie einen bestimmten Nutzer @erwähnen möchten, fügen Sie der SMS die Zeichenfolge <users/{user}> hinzu, wobei {user} die ID des Nutzers ist. Betrachten Sie beispielsweise die folgende SMS, 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 SMS wird so angezeigt:

Sie können den users/{user}-Wert auf folgende Weise angeben:

• Wenn Ihre Google Chat App auf eine vom Nutzer gesendete Nachricht reagiert, können Sie das Feld message.sender.name des Interaktionsereignisses MESSAGE verwenden.

• Wenn Ihre Google Chat-App eine asynchrone SMS erstellt, können Sie den Wert für users/{user} auf folgende Arten angeben:

  • Verwenden Sie das Feld name der Google Chat-Ressource User, z. B. users/123456789012345678901.
  • Verwenden Sie die E-Mail-Adresse des Nutzers als Alias für den Wert {user}. Wenn die E-Mail-Adresse beispielsweise [e-mail] lautet, können Sie den Nutzer als users/[e-mail] angeben. Wenn Sie einen E-Mail-Alias verwenden möchten, muss sich Ihre Google Chat App als Nutzer authentifizieren.

• Wenn Sie die People API verwenden, können Sie auch die Methode people.get verwenden, um die Nutzer-ID zu ermitteln.

Alle Nutzer @erwähnen

Wenn Sie eine Nachricht erstellen möchten, in der alle Mitglieder eines Gruppenbereichs @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!"
}

Text auf Karten formatieren

In Karten unterstützen die meisten Textfelder die grundlegende Textformatierung mithilfe einer kleinen Auswahl an HTML-Tags. In Kartennachrichten wird Text anders formatiert als in SMS, da SMS mit derselben Syntax wie Chatnachrichten formatiert werden.

---

Mit dem Card Builder können Sie Nachrichten und Benutzeroberflächen für Chat-Apps entwerfen und in der Vorschau ansehen:

Karten-Tool öffnen

---

Absatztext formatieren

Die unterstützten Tags und ihre Funktion sind in der folgenden Tabelle aufgeführt:

Format	Beispiel	Gerendertes Ergebnis
Fett	"This is <b>bold</b>."	Dieser Text ist fett.
Kursiv	"This is <i>italics</i>."	Das ist kursiv.
Unterstrichen	"This is <u>underline</u>."	Das ist unterstrichen.
Durchgestrichen	"This is <s>strikethrough</s>."	Dies ist durchgestrichen.
Schriftfarbe	"This is <font color=\"#FF0000\">red font</font>."	Dies ist eine rote Schrift.
Hyperlink	"This is a <a href=\"https://www.google.com\">hyperlink</a>."	Dies ist ein Hyperlink.
Zeit	"This is a time format: <time>2023-02-16 15:00</time>."	Das ist ein Zeitformat: 2023-02-16 15:00.
Zeilenvorschub	"This is the first line. <br> This is a new line."	Dies ist die erste Zeile.  Dies ist eine neue Zeile.

Textsymbole hinzufügen

Wenn Sie Symbole neben Text auf einer Karte anzeigen möchten, können Sie die Widgets DecoratedText und ButtonList verwenden.

In den folgenden Abschnitten wird erläutert, wie Sie integrierte Symbole, Google Material-Symbole oder benutzerdefinierte Symbole in Text oder Schaltflächen verwenden.

Symbole aus Google Chat verwenden

Wenn Sie ein in Google Chat integriertes Symbol verwenden möchten, geben Sie Folgendes an:

In der folgenden Tabelle sind die vordefinierten Symbole aufgeführt, die für Kartennachrichten verfügbar sind:

	FLUGZEUG		LESEZEICHEN SETZEN
	BUS		CAR
	UHR		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		DM
	EMAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	EINLADEN		MAP_PIN
	MITGLIEDSCHAFT		MULTIPLE_PEOPLE
	PERSON		SMARTPHONE
	RESTAURANT_ICON		SHOPPING_CART
	STAR		SPEICHERN
	TICKET		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

Im Folgenden sehen Sie ein Beispiel für eine Karte mit einem E-Mail-Symbol:

Google Material-Symbole verwenden

Mit den Google Material-Symbolen können Sie aus über 2.500 Symboloptionen auswählen und das Gewicht, die Füllung und den Farbton der Symbole anpassen.

Im Folgenden finden Sie ein Beispiel für eine Karte mit einem Google Material-Symbol:

Benutzerdefinierte Symbole verwenden

Wenn Sie ein benutzerdefiniertes Symbol hinzufügen möchten, fügen Sie das Feld iconUrl ein und geben Sie die entsprechende URL des Symbols an.

Im Folgenden finden Sie ein Beispiel für ein benutzerdefiniertes Symbol: