Formatowanie wiadomości

Google Chat pozwala dodawać do wiadomości formatowanie, w tym:

Formatowanie wiadomości tekstowej

Google Chat pozwala dodawać podstawowe formatowanie do SMS-ów, w tym pogrubienie, kursywę i przekreślenie, przy użyciu niewielkiej liczby elementów składni Markdown. Inaczej formatujesz tekst w SMS-ach niż w wiadomościach na kartach, ponieważ są one formatowane z użyciem tej samej składni, której używają użytkownicy Google Chat. Aby sformatować tekst na karcie, przeczytaj sekcję Formatowanie wiadomości karty.

Aby formatować SMS-y, użyj następującej składni:

Format Symbol Przykładowa składnia Tekst wyświetlany w Google Chat
pogrubienia, * *Cześć* Cześć
kursywy, _ (podkreślenie) _Cześć_ Cześć
Przekreślenie ~ ~Cześć~ Cześć
Stała szerokość znaków (cudzysłowy) „Cześć” hello
Blok o stałej szerokości „ ” ” (3 cudzysłowy) ```
Cześć
świecie
```		 Hello
World

Rozważ na przykład ten kod JSON:

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

Ten sformatowany komunikat tekstowy wyświetla w pokoju Google Chat te informacje:

Aplikacja Cymbal Pizza wysyła SMS-a, że dostawa została dostarczona.

Wyświetlanie formatowania tekstu wysłanego w wiadomości

Gdy użytkownik wysyła wiadomość, jej treść w postaci zwykłego tekstu znajduje się w polu text. Część formatowania stosowana do SMS-ów za pomocą składni Markdown znajduje się w polu text. W polu formattedText przeznaczonym tylko do danych wyjściowych znajduje się dodatkowe formatowanie, w tym:

  • Składnia znaczników w tekście
  • Wzmianki użytkownika
  • Niestandardowe hiperlinki
  • Niestandardowe emotikony

Przyjrzyjmy się na przykład temu tekstowi wysłanemu przez użytkownika:

W Google Chat odebrano wiadomość ze słowem

Jeśli wiadomość została sformatowana przy użyciu menu Format w interfejsie Google Chat, pole text zawiera tylko tekst, a pole formattedText zawiera znaczniki, tekst i hiperlink. Poniższy przykład pokazuje wersję roboczą wiadomości tekstowej z pogrubionym słowem:

Wiadomość ze słowem

Wiadomość jest odbierana w następującym formacie:

    {
      "text": "Be there at noon!",
      "formattedText": "Be <http://example.com|there> at *noon*",
    }

Jeśli w tekście wiadomości umieścisz zwykły adres URL linku, np. http://www.example.com/, Google Chat użyje go jako tekstu linku i automatycznie utworzy hiperlink z tego tekstu do określonego adresu URL.

Aby podać alternatywny tekst linku, użyj tej składni:

Przykładowa składnia Tekst wyświetlany w Google Chat
<https://example.com|Example website>

Kreska pionowa i tekst linku są opcjonalne, więc <https://www.example.com/> i https://www.example.com/ są równoważne.

Wzmianka o użytkownikach w SMS-ie

Aplikacje do obsługi czatu mogą wysyłać SMS-y zawierające @wzmiankę o jednym lub wszystkich użytkownikach w pokoju czatu. Aplikacje do obsługi czatu nie mogą dodawać wzmianek o użytkownikach w pokoju w trybie importowania.

Użytkownicy korzystający ze @wzmianek

Aby dodać @wzmiankę o konkretnym użytkowniku, dodaj <users/{user}> do SMS-a, gdzie {user} to identyfikator użytkownika. Przeanalizujmy przykładowy tekst wiadomości, w której 123456789012345678901 to identyfikator użytkownika Mahan S.

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Oto co możesz zobaczyć:

Aplikacja do obsługi czatu wspomni o osobie w wiadomości tekstowej.

Wartość users/{user} możesz określić na kilka sposobów:

  • Jeśli aplikacja Google Chat odpowiada na wiadomość wysłaną przez użytkownika, możesz użyć pola message.sender.name zdarzenia interakcji MESSAGE.

  • Jeśli aplikacja Google Chat tworzy asynchroniczne wiadomości tekstowe, możesz określić wartość users/{user} na te sposoby:

    • Użyj pola name zasobu Google Chat User, np. users/123456789012345678901.
    • Użyj adresu e-mail użytkownika jako aliasu wartości {user}. Jeśli na przykład adres e-mail to mahan@example.com, możesz określić użytkownika jako users/mahan@example.com. Aby można było używać aliasu e-mail, aplikacja Google Chat musi uwierzytelnić się jako użytkownik.

  • Jeśli korzystasz z interfejsu People API, możesz też zidentyfikować identyfikator użytkownika za pomocą metody people.get.

Dodawanie @wzmianek o wszystkich użytkownikach

Aby utworzyć SMS-a, w którym znajdą się @wzmianki o wszystkich osobach w pokoju, zastąp {user} wartością all. Ten przykładowy kod JSON zawiera wzmianki o wszystkich użytkownikach w wiadomości:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Formatowanie wiadomości na karcie

Większość pól tekstowych na kartach obsługuje podstawowe formatowanie tekstu za pomocą małego podzbioru tagów HTML. Inaczej formatujesz tekst w wiadomościach na kartach niż w SMS-ach, ponieważ SMS-y są formatowane z użyciem tej samej składni, której używają użytkownicy Google Chat. Aby sformatować tekst wyświetlany w SMS-ie, przeczytaj sekcję Formatowanie wiadomości tekstowej.

Obsługiwane tagi i ich przeznaczenie znajdziesz w tej tabeli:

Format Przykład Wyrenderowany wynik
pogrubienia, "This is <b>bold</b>." To jest pogrubione.
Kursywa "This is <i>italics</i>." To jest kursywa.
Podkreśl "This is <u>underline</u>." To podkreślenie.
Przekreślenie "This is <s>strikethrough</s>." Jest to przekreślenie.
Kolor czcionki "This is <font color=\"#FF0000\">red font</font>." Jest to czerwona czcionka.
Hiperlink "This is a <a href=\"https://www.google.com\">hyperlink</a>." To jest hiperlink.
Godzina "This is a time format: <time>2023-02-16 15:00</time>." Format godziny: .
Nowy wiersz "This is the first line. <br> This is a new line.′′ To jest pierwszy wiersz.
To jest nowy wiersz.

Dodawanie wbudowanej ikony do karty

Widżety DecoratedText i ButtonList obsługują element icon służący do określania jednej z wbudowanych ikon dostępnych w Google Chat.

W tabeli poniżej znajdziesz ikony wbudowane, które są dostępne w przypadku wiadomości na kartach:

SAMOLOT BOOKMARK
BUS SAMOCHODY
ZEGAR CONFIRMATION_NUMBER_ICON
DESCRIPTION KWOTA
E-MAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
REKLAMA HOTEL_ROOM_TYPE
ZAPROŚ MAP_PIN
CZŁONKOSTWO MULTIPLE_PEOPLE
OSOBA TELEFON
RESTAURANT_ICON SHOPPING_CART
GWIAZDKA SKLEP
BILET TRAIN
VIDEO_CAMERA VIDEO_PLAY

Oto przykład karty z ikoną e-maila:

Dodawanie do karty niestandardowej ikony

Widżety DecoratedText i ButtonList umożliwiają korzystanie z wbudowanych ikon lub definiowanie własnych ikon niestandardowych. Aby określić ikonę niestandardową, użyj elementu iconUrl w następujący sposób: