형식 메시지

Google Chat을 사용하면 메시지에 다음과 같은 서식을 추가할 수 있습니다.

문자 메시지 서식 지정

Chat에서는 마크다운 구문의 작은 하위 집합을 사용하여 굵게, 기울임꼴, 취소선을 포함한 기본 서식을 문자 메시지에 추가할 수 있습니다. 문자 메시지의 형식은 Chat 사용자가 사용하는 것과 동일한 구문으로 지정되므로 문자 메시지의 형식은 카드 메시지와 다릅니다. 카드에 표시되는 텍스트의 서식을 지정하려면 카드 메시지 서식 지정을 참고하세요.

문자 메시지의 서식을 지정하려면 다음 구문을 사용합니다.

형식 기호 예시 구문 Google Chat에 표시되는 텍스트
굵게 * *안녕하세요* 안녕하세요
기울임꼴 _ (밑줄) _안녕하세요_ 안녕하세요
취소선 ~ ~안녕하세요~ 안녕하세요
고정폭 ` (역따옴표) '안녕하세요' hello
고정폭 블록 ` ` ` (역따옴표 3개) ```
안녕하세요
여러분
```		 Hello
World
글머리 기호 목록 * 또는 - (하이픈) 다음에 공백이 표시됩니다.

* 목록의 첫 번째 항목입니다.

* 목록의 두 번째 항목입니다.
  • 목록의 첫 번째 항목입니다.
  • 목록의 두 번째 항목입니다.

예를 들어 다음 JSON을 고려해 보세요.

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

이 형식이 지정된 텍스트 메시지는 Chat 공간에 다음을 표시합니다.

Cymbal Pizza 앱에서 배달이 도착했다는 문자 메시지를 보냅니다.

메시지로 전송된 텍스트 서식 보기

사용자가 메시지를 보내면 메시지의 일반 텍스트 본문은 text 필드에 있습니다. 마크다운 구문을 사용하여 텍스트 메시지에 적용되는 일부 형식은 text 필드에 있습니다. 추가 형식은 다음을 포함하여 출력 전용 formattedText 필드에 있습니다.

  • 텍스트의 추가 마크다운 구문
  • 사용자 멘션
  • 맞춤 하이퍼링크
  • 맞춤 그림 이모티콘

예를 들어 사용자가 보낸 다음 텍스트를 생각해 보세요.

Chat에서 다음 단어가 포함된 메시지 수신

Chat UI의 형식 메뉴를 사용하여 메시지 형식을 지정했다면 text 필드에는 텍스트만 포함되고 formattedText 필드에는 마크업, 텍스트, 하이퍼링크가 포함됩니다. 다음 예는 단어가 하이퍼링크로 연결되고, 목록의 항목이 있으며, 한 단어가 굵게 표시된 텍스트 메시지 초안을 보여줍니다.

다음 단어가 포함된 메시지 초안

메시지는 다음과 같은 형식으로 수신됩니다.

    {
      "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*?",
    }

메시지 텍스트에 http://www.example.com/와 같은 일반 링크 URL을 포함하면 Google Chat에서 이 URL을 링크 텍스트로 사용하고 텍스트를 지정된 URL로 자동으로 하이퍼링크로 연결합니다.

링크에 대한 대체 링크 텍스트를 제공하려면 다음 구문을 사용합니다.

예시 구문 Google Chat에 표시되는 텍스트
<https://example.com|Example website>

파이프 및 링크 텍스트는 선택사항이므로 <https://www.example.com/>와 https://www.example.com/는 동일합니다.

문자 메시지로 사용자 멘션하기

채팅 앱은 Chat 스페이스에서 한 명 또는 모든 사용자를 @멘션하는 SMS를 전송할 수 있습니다. 채팅 앱은 가져오기 모드인 스페이스의 사용자 또는 스페이스에 참여하지 않은 사용자를 멘션할 수 없습니다.

특정 사용자 @멘션

특정 사용자를 @멘션하려면 문자 메시지에 <users/{user}>를 추가합니다. 여기서 {user}는 사용자의 ID입니다. 예를 들어 123456789012345678901가 사용자 Mahan S의 ID를 나타내는 다음 텍스트 메시지를 살펴보겠습니다.

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

문자 메시지는 다음과 같이 표시됩니다.

채팅 앱이 문자 메시지에서 사람을 언급합니다.

다음과 같은 방법으로 users/{user} 값을 지정할 수 있습니다.

  • Google Chat 앱이 사용자가 보낸 메시지에 응답하는 경우 MESSAGE 상호작용 이벤트의 message.sender.name 필드를 사용할 수 있습니다.

  • Google Chat 앱에서 비동기 문자 메시지를 만드는 경우 다음과 같은 방법으로 users/{user} 값을 지정할 수 있습니다.

    • Google Chat User 리소스의 name 필드를 사용합니다(예: users/123456789012345678901).
    • 사용자의 이메일 주소를 {user} 값의 별칭으로 사용합니다. 예를 들어 이메일 주소가 mahan@example.com이면 사용자를 users/mahan@example.com로 지정할 수 있습니다. 이메일 별칭을 사용하려면 Google Chat 앱을 사용자로 인증해야 합니다.

  • People API를 사용하는 경우 people.get 메서드를 사용하여 사용자 ID를 식별할 수도 있습니다.

모든 사용자 @멘션

스페이스의 모든 사용자를 @멘션하는 문자 메시지를 만들려면 {user}를 all로 바꿉니다. 다음 JSON 예는 메시지에서 모든 사용자를 멘션합니다.

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

카드 메시지 서식 지정

카드 내에서 대부분의 텍스트 필드는 작은 HTML 태그 하위 집합을 사용하여 기본 텍스트 형식을 지원합니다. 문자 메시지의 형식은 Chat 사용자가 사용하는 것과 동일한 구문으로 지정되므로 카드 메시지의 텍스트 형식은 문자 메시지와 다릅니다. 텍스트 메시지에 표시되는 텍스트의 서식을 지정하려면 텍스트 메시지 서식 지정을 참조하세요.

카드 빌더를 사용하여 채팅 앱용 JSON 카드 메시지를 디자인하고 미리 볼 수 있습니다.

카드 빌더 열기

다음 표에는 지원되는 태그와 그 용도가 나와 있습니다.

형식 예 렌더링된 결과
굵게 "This is <b>bold</b>." 이 항목은 굵게 표시되어 있습니다.
기울임꼴 "This is <i>italics</i>." 기울임꼴입니다.
밑줄 "This is <u>underline</u>." 밑줄입니다.
취소선 "This is <s>strikethrough</s>." 취소선입니다.
글꼴 색상 "This is <font color=\"#FF0000\">red font</font>." 빨간색 글꼴입니다.
하이퍼링크 "This is a <a href=\"https://www.google.com\">hyperlink</a>." 이는 하이퍼링크입니다.
시간 "This is a time format: <time>2023-02-16 15:00</time>." 시간 형식은 입니다.
줄바꿈 "This is the first line. <br> This is a new line." 첫 번째 줄입니다.
줄바꿈입니다.

카드에 내장 아이콘 추가

DecoratedText 및 ButtonList 위젯은 Chat에서 사용할 수 있는 기본 제공 아이콘 중 하나를 지정하는 데 사용되는 icon 요소를 지원합니다.

다음 표에는 카드 메시지에 사용할 수 있는 기본 제공 아이콘이 나열되어 있습니다.

비행기 BOOKMARK
BUS 자동차
시계 CONFIRMATION_NUMBER_ICON
DESCRIPTION 달러
이메일 EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
호텔 HOTEL_ROOM_TYPE
초대 MAP_PIN
멤버십 MULTIPLE_PEOPLE
사람 전화
RESTAURANT_ICON SHOPPING_CART
별표 스토어
티켓 TRAIN
VIDEO_CAMERA VIDEO_PLAY

다음은 이메일 아이콘이 있는 카드의 예입니다.

카드에 Google Material Design 아이콘 추가

DecoratedText 및 ButtonList 위젯을 사용하면 Google 머티리얼 아이콘을 사용할 수 있으므로 2,500개 이상의 아이콘 옵션 중에서 선택하고 아이콘의 두께, 채우기, 등급을 맞춤설정할 수 있습니다.

다음은 Google 머티리얼 아이콘이 있는 카드의 예입니다.

카드에 맞춤 아이콘 추가

DecoratedText 및 ButtonList 위젯을 사용하면 내장된 아이콘을 사용하거나 자체 맞춤 아이콘을 정의할 수 있습니다. 카드에 맞춤 아이콘을 추가하려면 iconUrl 필드를 포함하고 아이콘의 해당 URL을 지정합니다.

다음은 맞춤 아이콘의 예입니다.