Formatowanie wiadomości

Google Chat umożliwia formatowanie wiadomości, w tym:

Formatowanie wiadomości tekstowej

Google Chat pozwala dodawać do SMS-ów podstawowe formatowanie, w tym pogrubienie, kursywę lub przekreślenie, używając niewielkiego podzbioru składni języka Markdown. Ty formatować go inaczej w SMS-ach niż w wiadomościach na karcie, wiadomości są sformatowane przy użyciu tej samej składni co Google Chat. przez użytkowników. Aby dowiedzieć się, jak sformatować tekst wyświetlany na karcie, zobacz Formatowanie wiadomości w formie karty

Aby sformatować SMS-y, użyj tej składni:

Format Symbol Przykładowa składnia Tekst wyświetlany w Google Chat
Pogrubienie * *Cześć* cześć
Kursywa _ (podkreślenie) _hello_ Cześć
Przekreślenie ~ ~Cześć~ cześć
Stała szerokość znaków ` (cudzysłów) „Cześć” hello
Blok o stałej szerokości ` ` ` (trzy cudzysłowy) ```
Hello
World
```		 Hello
World
Lista punktowana * lub - (łącznik), po którym następuje spację

* 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

Możesz na przykład rozważyć taki kod JSON:

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

Ten sformatowany SMS zawiera te informacje w Google Chat spacja:

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

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

Gdy użytkownik wysyła wiadomość, jej zwykły tekst znajduje się w text. Niektóre formatowanie zastosowane do wiadomości tekstowej za pomocą formatu Markdown jest w polu text. Dodatkowe formatowanie jest w sekcji formattedText tylko z danymi wyjściowymi, 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:

Otrzymana wiadomość ze słowem w Google Chat

Jeśli wiadomość została sformatowana za pomocą menu Formatuj w sekcji UI Google Chat, pole text zawiera tylko tekst, a pole text Pole formattedText zawiera znaczniki, tekst i hiperlink. przykład poniżej pokazuje wersję roboczą wiadomości tekstowej ze słowem w hiperlinku, elementy na liście i jedno słowo pogrubione:

Wersja robocza wiadomości ze słowem

Wiadomość jest odbierana w tym 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 tworzy hiperlinki do 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łanie SMS-ów @wzmianki o jednym lub wszystkich użytkownikach w pokoju czatu. Aplikacje do obsługi czatu nie mogą wspominać o użytkownikach na pokoju w trybie importowania oraz użytkowników, którzy nie dołączyli do pokoju.

dodawanie @wzmianek o konkretnych użytkownikach,

Aby dodać @wzmiankę o konkretnym użytkowniku, dodaj do SMS-a adres <users/{user}>, gdzie {user} to identyfikator użytkownika. Weźmy na przykład następujący tekst: gdzie 123456789012345678901 reprezentuje identyfikator użytkownika Mahan S.:

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

Komunikat wyświetli się tak:

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

Wartość users/{user} można określić na następujące sposoby:

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

  • Jeśli aplikacja Google Chat tworzy asynchroniczny komunikat tekstowy, można określić wartość users/{user} na następujące sposoby:

    • Korzystanie z pola name w Google Chat User zasobu, takiego jak users/123456789012345678901.
    • Użyj adresu e-mail użytkownika jako aliasu wartości {user}. Dla: np. mahan@example.com, możesz określić użytkownika jako users/mahan@example.com. Aby używać aliasu e-mail, Aplikacja Google Chat musi: uwierzytelnić się jako użytkownik.

  • Jeśli używasz interfejsu People API, możesz też użyć interfejsu Metoda people.get aby identyfikować użytkowników.

Dodaj @wzmiankę o wszystkich użytkownikach

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

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

Formatowanie wiadomości dotyczącej karty

Większość pól tekstowych na kartach obsługuje podstawowe formatowanie tekstu przy użyciu podzbioru tagów HTML. Tekst w wiadomościach na karcie jest formatowany inaczej niż w tekście SMS-y, bo są sformatowane z użyciem tej samej składni Używane przez użytkowników czatu. Aby sformatować tekst wyświetlany w SMS-ie: zobacz Formatowanie SMS-a

Za pomocą kreatora kart możesz zaprojektować i wyświetlić podgląd wiadomości kart JSON przeznaczonych do aplikacji Google Chat:

Otwórz kreator kart

Obsługiwane tagi i ich przeznaczenie znajdziesz poniżej tabela:

Format Przykład Wyrenderowany wynik
Pogrubienie "This is <b>bold</b>." Ta treść jest pogrubiona.
Kursywa "This is <i>italics</i>." To jest kursywa.
Podkreślenie "This is <u>underline</u>." To jest podkreślenie.
Przekreślenie "This is <s>strikethrough</s>." To jest przekreślenie.
Kolor czcionki "This is <font color=\"#FF0000\">red font</font>." 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>." 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

DecoratedText oraz ButtonList widżety obsługują element icon. służy do wskazania jednej z wbudowanych ikon dostępnych w Google Chat.

W poniższej tabeli znajdziesz wbudowane ikony dostępne dla wiadomości na karcie:

SAMOLOT ZAKŁADKA
autobus Samochód
ZEGAR CONFIRMATION_NUMBER_ICON
DESCRIPTION KWOTA
E-MAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HOTEL HOTEL_ROOM_TYPE
INVITE MAP_PIN
WSPIERANIE MULTIPLE_PEOPLE
OSOBA TELEFON
RESTAURANT_ICON SHOPPING_CART
GWIAZDKA SKLEP
BILET POCIĄG
VIDEO_CAMERA VIDEO_PLAY

poniżej znajdziesz przykład karty z ikoną e-maila:

Dodawanie ikony Google Material Design do karty

DecoratedText oraz ButtonList widżetów pozwalają używać ikon Google Material dzięki czemu można wybierać spośród ponad 2500 opcji ikon i dostosowywać wagi, wypełnienia i gradacji ikon.

Oto przykład karty z ikoną Google Material:

Dodawanie ikony niestandardowej do karty

DecoratedText oraz ButtonList z wbudowanych ikon lub zdefiniowaniem własnych. Do dodaj do karty ikonę niestandardową, dołącz pole iconUrl i określ odpowiadający adresowi URL.

Oto przykład ikony niestandardowej: