Formatmeldungen

In Google Chat können Sie Nachrichten formatieren, z. B.:

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~ Hallo
Festbreitenschrift ` (zurückes Anführungszeichen) „Hallo“ hello
Festbreitenschrift ` ` ` (drei Anführungszeichen) ```
Hello
World
```		 Hello
World
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.
  • 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:

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

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:

In Google Chat erhaltene Nachricht mit dem Wort

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:

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

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

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 Interaktionsereignisses MESSAGE 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-Ressource User, z. B. users/123456789012345678901.
    • Verwenden Sie die E-Mail-Adresse des Nutzers als Alias für den {user}-Wert. Wenn die E-Mail-Adresse beispielsweise mahan@example.com lautet, können Sie den Nutzer als users/mahan@example.com angeben. Damit Sie einen E-Mail-Alias verwenden können, muss sich Ihre Google Chat-Anwendung als Nutzer authentifizieren.

  • 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 öffnen

Die 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 durchgestrichen.
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
E-MAIL 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: