Google Chat을 사용하면 메시지에 다음과 같은 서식을 추가할 수 있습니다.
- SMS 및 카드 메시지의 기본 텍스트 서식(예: 굵게, 기울임꼴, 취소선)
- 링크된 텍스트.
- Chat 스페이스에서 한 명 또는 모든 사용자를@멘션합니다.
- 카드 메시지에만 내장 및 맞춤 아이콘을 추가합니다.
문자 메시지 서식 지정
Chat에서는 마크다운 구문의 작은 하위 집합을 사용하여 굵게, 기울임꼴, 취소선을 포함한 기본 서식을 문자 메시지에 추가할 수 있습니다. 문자 메시지의 형식은 Chat 사용자가 사용하는 것과 동일한 구문으로 지정되므로 문자 메시지의 형식은 카드 메시지와 다릅니다. 카드에 표시되는 텍스트의 서식을 지정하려면 카드 메시지 서식 지정을 참고하세요.
문자 메시지의 서식을 지정하려면 다음 구문을 사용합니다.
형식 | 기호 | 예시 구문 | Google Chat에 표시되는 텍스트 |
---|---|---|---|
굵게 | * | *안녕하세요* | 안녕하세요 |
기울임꼴 | _ (밑줄) | _안녕하세요_ | 안녕하세요 |
취소선 | ~ | ~안녕하세요~ | |
고정폭 | ` (역따옴표) | '안녕하세요' | hello |
고정폭 블록 | ` ` ` (역따옴표 3개) | ``` 안녕하세요 여러분 ``` |
Hello |
글머리 기호 목록 | * 또는 - (하이픈) 다음에 공백이 표시됩니다. | * 목록의 첫 번째 항목입니다. * 목록의 두 번째 항목입니다. |
|
예를 들어 다음 JSON을 고려해 보세요.
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
이 형식이 지정된 텍스트 메시지는 Chat 공간에 다음을 표시합니다.
메시지로 전송된 텍스트 서식 보기
사용자가 메시지를 보내면 메시지의 일반 텍스트 본문은 text
필드에 있습니다. 마크다운 구문을 사용하여 텍스트 메시지에 적용되는 일부 형식은 text
필드에 있습니다. 추가 형식은 다음을 포함하여 출력 전용 formattedText
필드에 있습니다.
- 텍스트의 추가 마크다운 구문
- 사용자 멘션
- 맞춤 하이퍼링크
- 맞춤 그림 이모티콘
예를 들어 사용자가 보낸 다음 텍스트를 생각해 보세요.
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}
값을 지정할 수 있습니다.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을 지정합니다.
다음은 맞춤 아이콘의 예입니다.