Formatmeldungen

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

  • RTF mit Hyperlinks oder @Erwähnungen für einen oder alle Nutzer in einem Chatbereich.
  • Text, der auf einer Kartenoberfläche angezeigt wird, z. B. als Absatztext oder UI-Text, der neben einem Symbol, z. B. einer Schaltfläche, angezeigt wird.

SMS formatieren

In Google Chat können Sie Textnachrichten grundlegend formatieren, z. B.: fett, kursiv und durchgestrichen dargestellt, indem Sie eine kleine Teilmenge der Markdown-Syntax verwenden. Ich Formatieren Sie Text in SMS anders als in Kartennachrichten, da Text haben Nachrichten dieselbe Syntax wie Google Chat die von den Nutzern verwendet wird.

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
Festbreitenschrift ` ` ` (drei Anführungszeichen) ```
Hello
World
```		 Hello
World
Aufzählungsliste * oder - (Bindestrich) gefolgt von einem Leerzeichen

* Dies ist das erste Element in der Liste.

* Dies ist das zweite Element in der Liste.
  • Dies ist das erste Element in der Liste
  • Dies ist das zweite Element in der Liste

Betrachten Sie beispielsweise den folgenden JSON-Code:

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

Diese formatierte Textnachricht enthält Folgendes in einem Chat Gruppenbereich:

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 text. Formatierungen, die mithilfe von Markdown auf die Textnachricht angewendet werden befindet sich im Feld text. Zusätzliche Formatierungen befinden sich in der reines Ausgabefeld formattedText, einschließlich der folgenden:

  • Zusätzliche Markdown-Syntax für Text
  • Nutzererwähnungen
  • 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ü Format im Chat-UI enthält das Feld text nur den Text, während das Feld formattedText enthält die Markups, den Text und den Hyperlink. Die Das folgende Beispiel zeigt den Entwurf einer Textnachricht mit einem als Hyperlink formatierten Wort, Elemente in einer Liste und ein Wort in Fettschrift:

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 einfache Link-URL in Ihren Nachrichtentext einfügen, z. B. http://www.example.com/ verwendet Google Chat dies 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/ sind gleichwertig.

Nutzer in einer SMS erwähnen

Chat-Apps können SMS senden einen oder alle Nutzer in einem Chatbereich @erwähnen. Chat-Apps dürfen keine Nutzer in einer der folgenden Sprachen erwähnen: Gruppenbereich im Importmodus oder Nutzer, die sind dem Gruppenbereich nicht beigetreten.

Bestimmte Nutzer @erwähnen

Wenn Sie einen bestimmten Nutzer @erwähnen möchten, fügen Sie der SMS dabei <users/{user}> hinzu. {user} ist die ID des Nutzers. Betrachten Sie zum Beispiel den folgenden Text -Nachricht, wobei 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:

Die Chat-App erwähnt eine Person in einer SMS.

Sie können den Wert users/{user} so angeben:

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

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

    • Das Feld name in Google Chat verwenden User-Ressource, z. B. users/123456789012345678901
    • Verwenden Sie die E-Mail-Adresse des Nutzers als Alias für den Wert {user}. Für Lautet die E-Mail-Adresse beispielsweise mahan@example.com, können Sie Nutzer als users/mahan@example.com. Wenn Sie einen E-Mail-Alias verwenden möchten, Die Google Chat App muss als Nutzer authentifizieren.

  • Wenn Sie die People API verwenden, können Sie auch die people.get-Methode um die User-ID zu 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} mit 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!"
}

Auf Karten angezeigten Text formatieren

Innerhalb von Karten unterstützen die meisten Textfelder eine einfache Textformatierung. Verwenden Sie dazu ein kleines eine Untergruppe von HTML-Tags. Sie formatieren Text in Kartennachrichten anders als im Text Nachrichten, da Textnachrichten mit der gleichen Syntax formatiert sind, Chat, den die Nutzer verwenden.

Mit dem Card Builder können Sie Nachrichten und Benutzeroberflächen für Chat-Apps entwerfen und als Vorschau anzeigen lassen:

Card Builder öffnen

Absatztext formatieren

Die unterstützten Tags und ihr Zweck sind im Folgenden aufgeführt. Tabelle:

Format Beispiel Gerendertes Ergebnis
Fett "This is <b>bold</b>." Fett.
Kursiv "This is <i>italics</i>." Dies ist kursiv.
Unterstrichen "This is <u>underline</u>." Dies ist Unterstrich.
Durchgestrichen "This is <s>strikethrough</s>." Dies ist durchgestrichen.
Schriftfarbe "This is <font color=\"#FF0000\">red font</font>." in roter 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 Zeitformat lautet: .
Zeilenvorschub „"This is the first line. <br> This is a new line.“ Das ist die erste Zeile.
Das ist eine neue Zeile.

Symbole zum Text hinzufügen

Um Symbole neben dem Text auf einer Karte anzuzeigen, können Sie die DecoratedText und ButtonList Widgets.

In den folgenden Abschnitten wird erläutert, wie Sie integrierte Symbole, oder benutzerdefinierte Symbole in hervorgehobenem Text oder auf Schaltflächen.

Symbole aus Google Chat verwenden

So verwenden Sie integrierte Symbole in Google Chat: Geben Sie eine der folgenden Optionen an:

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

FLUGZEUG Lesezeichen
BUS Automobil
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
STAR SHOP
TICKET TRAINING
VIDEO_CAMERA VIDEO_PLAY

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

Google Material-Symbole verwenden

Sie können Materialien von Google-Symbolen verwenden. stehen über 2500 Symboloptionen zur Auswahl und können Füllung und Grad der Symbole.

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, schließen Sie das Feld iconUrl ein und geben Sie die entsprechende URL.

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