Formatowanie wiadomości

Google Chat umożliwia dodawanie do wiadomości formatowania, na przykład:

Formatowanie wiadomości tekstowej

Google Chat pozwala dodawać do wiadomości tekstowych podstawowe formatowanie, takie jak pogrubienie, kursywa i przekreślenie, przy użyciu niewielkiego podzbioru składni języka Markdown. Inaczej formatujesz tekst w SMS-ach niż w kartach, ponieważ SMS-y są formatowane z użyciem tej samej składni, której używają użytkownicy Google Chat. Aby sformatować tekst na karcie, przeczytaj artykuł Formatowanie wiadomości karty.

Aby formatować SMS-y, użyj tej 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łów) „Cześć” hello
Blok o stałej szerokości ` ` ` (trzy cudzysłowy wsteczne) ```
Cześć
świecie
``		 Hello
World
Lista punktowana * lub - (łącznik), a po nich spacja

* To jest pierwszy element na liście

* To jest drugi element na liście.
  • To jest pierwszy element na liście
  • To jest drugi element na liście

Weź na przykład ten kod JSON:

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

Ten sformatowany SMS wyświetla w pokoju czatu te informacje:

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

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

Gdy użytkownik wysyła wiadomość, jej treść znajduje się w polu text. Część formatowania stosowana do wiadomości tekstowych za pomocą składni Markdowna znajduje się w polu text. W polu formattedText (tylko dane wyjściowe) znajduje się dodatkowe formatowanie, w tym:

  • Dodatkowa składnia języka Markdown dla tekstu
  • Wzmianki użytkownika
  • Niestandardowe hiperlinki
  • Niestandardowe emotikony

Weźmy na przykład taki tekst wysłany przez użytkownika:

Otrzymano wiadomość w Google Chat ze słowem

Jeśli wiadomość została sformatowana za pomocą menu Formatuj 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 hiperlinkiem, elementami na liście i pogrubionym słowem:

Wersja robocza wiadomości ze słowem

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

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

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 do tego tekstu na podany adres URL.

Aby podać alternatywny tekst linku, użyj następującej 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.

Dodaj wzmiankę 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, który jest w trybie importowania, ani o użytkownikach, którzy nie dołączyli do pokoju.

@wzmianki o konkretnych użytkownikach

Aby dodać @wzmiankę o konkretnym użytkowniku, dodaj do wiadomości tekst <users/{user}>, gdzie {user} to identyfikator tego użytkownika. Przyjrzyjmy się na przykład wiadomościom, w których 123456789012345678901 to identyfikator użytkownika Mahan S.

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

Oto co zobaczysz:

Aplikacja do obsługi czatu wspomina o osobie w SMS-ie.

Wartość users/{user} możesz określić na te sposoby:

  • 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 asynchroniczną wiadomość tekstową, możesz określić wartość users/{user} w jeden z tych sposobów:

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

@wzmianka o wszystkich użytkownikach

Aby utworzyć SMS-a ze @wzmianką o wszystkich osobach w pokoju, zastąp {user} tekstem all. Ten przykładowy kod JSON zawiera wzmiankę o wszystkich użytkownikach w wiadomości:

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

Formatowanie wiadomości na karcie

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

Za pomocą Kreatora kart możesz projektować karty JSON i wyświetlać ich podgląd na potrzeby aplikacji Google Chat:

Otwórz kreator kart

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

Format Przykład Wyrenderowany wynik
pogrubienia, "This is <b>bold</b>." Ten tekst jest pogrubiony.
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>." To jest 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>." Jest to 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.

Tabela poniżej zawiera listę wbudowanych ikon, które mogą być używane w przypadku wiadomości na karcie:

SAMOLOT BOOKMARK
BUS SAMOCHÓD
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 ikony Google Material Design

Widżety DecoratedText i ButtonList umożliwiają korzystanie z ikon materiałów Google, dzięki czemu możesz wybierać spośród ponad 2500 opcji ikon i dostosowywać ich grubość, wypełnienie i stopień.

Oto przykład karty z ikoną Google Material:

Dodawanie do karty niestandardowej ikony

Widżety DecoratedText i ButtonList umożliwiają używanie wbudowanych ikon lub definiowanie własnych ikon niestandardowych. Aby dodać do karty niestandardową ikonę, dołącz pole iconUrl i podaj odpowiedni adres URL ikony.

Oto przykład ikony niestandardowej: