Formatowanie wiadomości

Na tej stronie wyjaśniamy, jak aplikacje Google Chat mogą formatować tekst, aby wysyłać wiadomości zawierające:

• tekst sformatowany zawierający hiperlinki lub @wzmianki do jednego lub wszystkich użytkowników w pokoju czatu;
• Tekst widoczny w interfejsie karty, np. jako tekst akapitu lub tekst interfejsu wyświetlany obok ikony, np. przycisk.

Formatowanie wiadomości tekstowej

Google Chat umożliwia dodawanie do wiadomości tekstowych podstawowego formatowania, w tym pogrubienia, kursywy i przekreślenia, za pomocą niewielkiego podzbioru składni Markdown. Tekst w wiadomościach tekstowych jest formatowany inaczej niż w wiadomościach na karcie, ponieważ w przypadku tych pierwszych używa się tej samej składni, której używają użytkownicy Google Chat.

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	~	~hello~	Cześć
Stała szerokość znaków	` (cudzysłów)	`hello`	hello
Blok o stałej szerokości znaków	` ` ` (trzy cudzysłowy)	``` Cześć Świecie ```	Hello World
Lista punktowana	* lub - (łącznik), po którym następuje spację	* To 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!_"
    }

Ta sformatowana wiadomość tekstowa wyświetla się w pokoju Google Chat:

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. Niektóre formatowanie zastosowane do wiadomości tekstowej za pomocą składni Markdown znajduje się w polu text. W polu formattedText tylko z danymi wyjściowymi znajdują się dodatkowe formatowanie, takie jak:

• Dodatkowa składnia Markdown dla tekstu
• Wzmianki użytkowników
• Niestandardowe hiperlinki
• Niestandardowe emotikony

Weź pod uwagę przykładowy tekst wysłany przez użytkownika:

Jeśli wiadomość została sformatowana za pomocą menu Format w interfejsie czatu, pole text zawiera tylko tekst, a pole formattedText zawiera znaczniki, tekst i hiperlink. Poniższy przykład pokazuje wersję roboczą wiadomości tekstowej ze słowem w formie hiperlinku, elementami na liście i pogrubionym 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*?",
    }

Formatowanie linków

Jeśli w tekście wiadomości umieścisz zwykły adres URL linku, na przykład http://www.example.com/, Google Chat użyje go jako tekstu linku i automatycznie utworzy hiperlink 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>	Example website

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

Wzmianki o użytkownikach w wiadomościach tekstowych

Aplikacje do obsługi czatu mogą wysyłać SMS-y ze @wzmianką o jednym lub wszystkich użytkownikach w pokoju czatu. Aplikacje do czatu nie mogą wymieniać użytkowników w pokoju w trybie importowania ani użytkowników, którzy nie dołączyli do pokoju.

dodawanie @wzmianek o konkretnych użytkownikach,

Aby dodać @wzmiankę o konkretnym użytkowniku, dodaj <users/{user}> do SMS-a, w którym {user} to identyfikator tego użytkownika. Weź pod uwagę tę wiadomość tekstową, w której 123456789012345678901 to identyfikator użytkownika Mahan S.:

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

Wiadomość tekstowa wygląda tak:

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 zdarzenia interakcji MESSAGE.

• Jeśli Twoja 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 [e-mail], możesz określić użytkownika jako users/[e-mail]. 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ż identyfikować identyfikator użytkownika za pomocą metody people.get.

Dodaj @wzmiankę o wszystkich użytkownikach

Aby utworzyć wiadomość tekstową ze @wzmianką o wszystkich w pokoju, zastąp {user} elementem all. W tym przykładzie kodu JSON w wiadomości są wymienieni wszyscy użytkownicy:

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

Formatowanie tekstu na kartach

Większość pól tekstowych na kartach obsługuje podstawowe formatowanie tekstu za pomocą niewielkiego podzbioru tagów HTML. Tekst w wiadomościach w formie kart jest inaczej formatowany niż w SMS-ach, ponieważ mają one taką samą składnię jak użytkownicy Google Chat.

---

Za pomocą Kreatora kart możesz projektować i przeglądać podglądy wiadomości oraz interfejsów aplikacji czatu:

Otwórz kreatora kart

---

Formatowanie tekstu akapitu

Obsługiwane tagi i ich przeznaczenie znajdziesz w tabeli:

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>."	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: 2023-02-16 15:00.
Nowy wiersz	"This is the first line. <br> This is a new line."	To jest pierwszy wiersz. To jest nowy wiersz.

Dodawanie ikon do tekstu

Aby wyświetlać ikony obok tekstu na karcie, możesz użyć widżetów DecoratedText i ButtonList.

W sekcjach poniżej wyjaśniamy, jak używać wbudowanych ikon, ikon Google Material i ikon niestandardowych w ozdobnym tekście lub przyciskach.

Używanie ikon z Google Chat

Aby użyć wbudowanych ikon dostępnych w Google Chat, określ jedną z tych opcji:

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

	SAMOLOT		ZAZNACZENIE
	BUS		CAR
	CLOCK		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		KWOTA
	E-MAIL		EVENT_SEAT
	FLIGHT_ARRIVAL		FLIGHT_DEPARTURE
	HOTEL		HOTEL_ROOM_TYPE
	ZAPROŚ		MAP_PIN
	CZŁONKOSTWO		MULTIPLE_PEOPLE
	PERSON		TELEFON
	RESTAURANT_ICON		SHOPPING_CART
	GWIAZDKA		STORE
	BILET		POCIĄG
	VIDEO_CAMERA		VIDEO_PLAY

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

Używaj ikon Google Material

Możesz użyć ikon Google Material, aby wybrać spośród ponad 2500 opcji ikon i spersonalizować ich wagę, wypełnienie i stopień.

Oto przykład karty z ikoną Google Material:

Używanie ikon niestandardowych

Aby dodać ikonę niestandardową, uwzględnij pole iconUrl i podaj adres URL ikony.

Oto przykład ikony niestandardowej: