Formatmeldungen

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

  • RTF mit Hyperlinks oder @Erwähnungen für einen oder alle Nutzer 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. Fettdruck, Kursivschrift und Durchstreichen. In SMS wird Text anders formatiert als in Kartennachrichten, da SMS mit derselben Syntax wie Chat-Nutzer formatiert werden.

Verwenden Sie die folgende Syntax, um Textnachrichten zu formatieren:

Format Symbol Beispielsyntax In Google Chat angezeigter Text
Fett * *Hallo* Hallo
Kursiv _ (Unterstrich) _hello_ Hallo
Durchgestrichen ~ ~hallo~ Hallo
Festbreitenschrift ` (Backquote) „hallo“ hello
Block mit monospace-Schrift ` ` ` (drei Anführungszeichen) ```
Hello
World
```		 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 das zweite Element 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:

Die Cymbal-Pizza-App sendet eine SMS, dass die Lieferung eingetroffen ist.

In einer Nachricht gesendete Textformatierung 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 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 Sie zum Beispiel den folgenden Text, der von einem Nutzer gesendet wurde:

In Google Chat empfangene Nachricht mit dem Wort

Wenn die Nachricht über das Menü Formatieren 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 sehen Sie den Entwurf einer SMS mit einem verlinkten Wort, Elementen in einer Liste und einem fett formatierten Wort:

Nachrichtenentwurf mit dem Wort

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*?",
    }

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>

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. In Chat-Apps können keine Nutzer in einem Gruppenbereich im Importmodus oder Nutzer, die dem Gruppenbereich nicht beigetreten sind, erwähnt werden.

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. 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:

In einer Chat-App wird eine Person in einer Nachricht erwähnt.

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 mahan@example.com lautet, können Sie den Nutzer als users/mahan@example.com 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 identifizieren.

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

Innerhalb von Karten unterstützen die meisten Textfelder eine einfache Textformatierung, da nur eine kleine Menge von HTML-Tags verwendet wird. 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:

Card Builder ö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>." Dies 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: .
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 DOLLAR
EMAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
EINLADEN MAP_PIN
MITGLIEDSCHAFT MULTIPLE_PEOPLE
PERSON SMARTPHONE
RESTAURANT_ICON SHOPPING_CART
STAR STORE
TICKET TRAINING
VIDEO_CAMERA VIDEO_PLAY

Im folgenden Beispiel ist eine Karte mit einem E-Mail-Symbol zu sehen:

Google Material-Symbole verwenden

Mithilfe von Google-Material-Symbolen können Sie aus mehr als 2.500 Symboloptionen auswählen und die Gewichtung, Füllung und Stufe 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.

Hier sehen Sie ein Beispiel für ein benutzerdefiniertes Symbol: