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:

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

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:

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

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:

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:

Absatztext formatieren

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

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:

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: