Formatowanie wiadomości

Z tego artykułu dowiesz się, jak aplikacje Google Chat mogą formatować tekst, aby wysyłać wiadomości zawierające:

• Tekst sformatowany zawierający hiperlinki lub wzmianki @o jednym lub wszystkich użytkownikach w przestrzeni na czacie.
• Tekst wyświetlany w interfejsie karty, w tym tekst akapitu lub tekst interfejsu wyświetlany obok ikony, np. przycisku.

Formatowanie SMS-a

Chat umożliwia dodawanie podstawowego formatowania do wiadomości tekstowych, w tym pogrubienia, kursywy i przekreślenia, za pomocą niewielkiego podzbioru składni Markdown. Tekst w SMS-ach formatuje się inaczej niż w wiadomościach z kartami, ponieważ SMS-y są formatowane za pomocą tej samej składni, której używają użytkownicy Chatu.

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

Przyjrzyjmy się temu przykładowi JSON:

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

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

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

Gdy użytkownik wyśle wiadomość, jej treść w postaci zwykłego tekstu znajdzie się w polu text. Niektóre formatowania zastosowane do wiadomości tekstowej za pomocą składni Markdown znajdują się w polu text. Dodatkowe formatowanie znajduje się w polu formattedText tylko do odczytu, w tym:

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

Weźmy na przykład ten 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 z hiperlinkiem do słowa, elementami na liście i jednym słowem zapisanym pogrubioną czcionką:

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, np. http://www.example.com/, Google Chat użyje go jako tekstu linku i automatycznie utworzy link do tego tekstu.

Aby podać alternatywny tekst linku, użyj tej składni:

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

Używanie niestandardowych emotikonów w wiadomości tekstowej

Aplikacje do obsługi czatu mogą wysyłać wiadomości tekstowe z niestandardowymi emotikonami, aby personalizować wiadomości. Niestandardowe emotikony są dostępne tylko dla organizacji korzystających z Google Workspace, a administrator musi włączyć je w organizacji. Więcej informacji znajdziesz w artykułach Więcej informacji o niestandardowych emotikonach w Google Chat i Zarządzanie uprawnieniami do niestandardowych emotikonów.

Aby tworzyć wiadomości z niestandardowymi emoji, aplikacja musi korzystać z uwierzytelniania użytkowników. Niestandardowe emotikony nie są obsługiwane w wiadomościach utworzonych jako webhook ani w wiadomościach utworzonych z uwierzytelnianiem aplikacji.

Aby dodać niestandardowe emotikony do tekstu wiadomości, określ name lub emoji_name zasobu customEmoji:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

Aby użyć tego przykładu, zastąp CUSTOM_EMOJI_ID identyfikatorem emotikona niestandardowego. Znajdziesz go w polu name lub emoji_name zasobu customEmoji.

Wzmianki o użytkownikach w SMS-ach

Aplikacje Google Chat mogą wysyłać wiadomości tekstowe, w których używają wzmianki @, aby wspomnieć o jednym lub wszystkich użytkownikach w pokoju czatu. Aby wspomnieć o użytkownikach, którzy nie dołączyli do pokoju, lub o pokoju w trybie importowania, aplikacje do obsługi czatu muszą wysyłać wiadomości z uwierzytelnianiem użytkownika.

@wzmianka o konkretnych użytkownikach,

Aby @wzmiankować konkretnego użytkownika, dodaj do wiadomości tekstowej znak <users/{user}>, gdzie {user} to identyfikator użytkownika. Weźmy na przykład ten SMS, w którym 123456789012345678901 to identyfikator użytkownika Mahan S.:

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

SMS będzie wyglądać tak:

Wartość users/{user} możesz określić w ten sposób:

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

• Jeśli aplikacja Google Chat tworzy asynchroniczną wiadomość tekstową, możesz określić wartość parametru users/{user} w ten sposób:

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

• Jeśli używasz interfejsu 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} znakiem all. W tym przykładzie JSON w wiadomości są wymienieni wszyscy użytkownicy:

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

Formatowanie tekstu wyświetlanego na kartach

W kartach większość pól tekstowych obsługuje podstawowe formatowanie tekstu za pomocą niewielkiego podzbioru tagów HTML. Tekst w wiadomościach na kartach formatuje się inaczej niż w wiadomościach tekstowych, ponieważ wiadomości tekstowe są formatowane przy użyciu tej samej składni, której używają użytkownicy Chatu.

Użyj narzędzia do tworzenia kart, aby projektować i wyświetlać podgląd wiadomości oraz interfejsów użytkownika aplikacji Google Chat:

Formatowanie tekstu akapitu

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

Możesz też używać składni Markdown oraz tych tagów:

This is a code block.

Aby wybrać składnię, która ma być używana podczas formatowania treści akapitu tekstu, użyj pola Składnia tekstu.

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 dowiesz się, jak używać wbudowanych ikon, ikon Google Material lub ikon niestandardowych w tekście dekoracyjnym 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 wbudowane ikony dostępne w przypadku wiadomości w formie karty:

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

Używanie ikon Material Design od Google

Możesz użyć ikon Material Design od Google, aby wybrać spośród ponad 2500 opcji ikon i dostosować ich grubość, wypełnienie i poziom.

Oto przykład karty z ikoną Google Material:

Używanie ikon niestandardowych

Aby dodać niestandardową ikonę, uwzględnij pole iconUrl i określ odpowiedni adres URL ikony.

Oto przykład ikony niestandardowej: