Google Chat umożliwia dodawanie do wiadomości formatowania, na przykład:
- Podstawowe formatowanie tekstu, np. pogrubienie, kursywa i przekreślenie, w wiadomościach tekstowych i wiadomościach na kartach.
- Tekst linku.
- Dodaj@wzmiankę o jednym lub wszystkich użytkownikach w pokoju czatu.
- Dodawaj ikony wbudowane i niestandardowe ikony tylko w wiadomościach na kartach.
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ść~ | |
Stała szerokość znaków | ` (cudzysłów) | „Cześć” | hello |
Blok o stałej szerokości | ` ` ` (trzy cudzysłowy wsteczne) | ``` Cześć świecie `` |
Hello |
Lista punktowana | * lub - (łącznik), a po nich spacja | * 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:
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:
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:
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*?",
}
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 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:
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 interakcjiMESSAGE
. 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 ChatUser
, np.users/123456789012345678901
. - Użyj adresu e-mail użytkownika jako aliasu wartości
{user}
. Jeśli na przykład adres e-mail tomahan@example.com
, możesz określić użytkownika jakousers/mahan@example.com
. Aby można było używać aliasu e-mail, aplikacja Google Chat musi uwierzytelnić się jako użytkownik.
- Użyj pola
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 kartObsł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 |
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 | ||
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: