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 rozmów.
• Tekst wyświetlany w interfejsie karty, w tym akapit lub tekst interfejsu wyświetlany obok ikony, np. przycisku.

Formatowanie wiadomości tekstowej

Czat 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 czatu.

Aby sformatować wiadomości tekstowe, użyj tej składni:

Format	Symbol	Przykładowa składnia	Tekst wyświetlany w Google Chat
Pogrubienie	*	*cześć*	Cześć
Kursywa	_ (podkreślenie)	_Cześć_	Cześć
Przekreślenie	~	~hello~	Cześć
Stała szerokość znaków	` (backquote)	`hello`	hello
Blok o stałej szerokości znaków	` ` ` (trzy cudzysłowe)	``` Cześć Świecie ```	Hello World
Lista punktowana	* lub - (kreska) poprzedzone spacją	* To pierwszy element na liście * To jest drugi element na liście	To pierwszy element na liście To jest drugi element na liście

Weź pod uwagę ten przykładowy obiekt 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, które jest stosowane do wiadomości tekstowej za pomocą składni Markdown, znajduje się w polu text. Dodatkowe formatowanie znajduje się w polu formattedText tylko do wyświetlania, m.in.:

• 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 przedstawia wersję roboczą wiadomości tekstowej z hiperlinkiem do słowa, elementami na liście i jednym słowem pogrubionym:

Wiadomość jest odbierana w takim 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, np. http://www.example.com/, Google Chat użyje go jako tekstu linku i automatycznie utworzy hiperlink do wskazanego 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

Tekst w nawiasach klamrowych i link jest opcjonalny, więc <https://www.example.com/> i https://www.example.com/ są równoważne.

Wzmianki o użytkownikach w SMS-ach

Aplikacje do czatu mogą wysyłać wiadomości tekstowe, w których @mentionowani są wszyscy użytkownicy pokoju czatu lub jeden z nich. Aby wymienić użytkowników, którzy nie dołączyli do pokoju lub pokoju w trybie importowania, aplikacje Google Chat muszą wysyłać wiadomości z uwierzytelnianiem użytkownika.

@wzmianka konkretnych użytkowników

Aby wspomnieć o konkretnym użytkowniku, dodaj do wiadomości tekstowej <users/{user}>, gdzie {user} to identyfikator 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ż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 w zdarzeniu interakcji MESSAGE.

• Jeśli aplikacja Google Chat tworzy asynchoniczną wiadomość tekstową, możesz określić wartość parametru users/{user} na jeden z tych sposobów:

  • Użyj pola name zasobu Google Chat User, na przykład 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 podać użytkownika jako users/[e-mail]. Aby używać aliasu e-mail, aplikacja Google Chat musi uwierzytelnić się jako użytkownik.

• Jeśli korzystasz z People API, możesz też użyć metody people.get, aby zidentyfikować identyfikator użytkownika.

@wzmianka o wszystkich użytkownikach

Aby utworzyć wiadomość tekstową z @wzmianką o wszystkich osobach w pokoju, zastąp {user} wartością 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 z kartami jest formatowany inaczej niż w wiadomościach tekstowych, ponieważ w tych ostatnich używa się tej samej składni, której używają użytkownicy czatu.

---

Korzystając z Kreatora kart, możesz projektować i przeglądać interfejsy użytkownika oraz wiadomości w aplikacji Google Chat:

Otwórz kreatora kart

---

Formatowanie tekstu akapitu

Obsługiwane tagi i ich przeznaczenie:

Format	Przykład	Wyrenderowany wynik
Pogrubienie	"This is <b>bold</b>."	Ten tekst jest pogrubiony.
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>."	Ten tekst jest przekreślony.
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>."	Format czasu: 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 następnych sekcjach dowiesz się, jak używać wbudowanych ikon, ikon Google Material lub ikon niestandardowych w tekstach ozdobionych 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 tabeli poniżej znajdziesz listę wbudowanych ikon, które są dostępne w przypadku wiadomości na karcie:

	SAMOLOT		ZAZNACZENIE
	BUS		CAR
	CLOCK		CONFIRMATION_NUMBER_ICON
	DESCRIPTION		DOLLAR
	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		SKLEP
	BILET		TRAIN
	VIDEO_CAMERA		VIDEO_PLAY

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

Używanie 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ą, użyj pola iconUrl i wskaż odpowiedni URL ikony.

Oto przykład ikony niestandardowej: