형식 메시지

이 페이지에서는 Google Chat 앱이 다음과 같은 메시지를 보내기 위해 텍스트 서식을 지정하는 방법을 설명합니다. 다음 중 하나를 포함해야 합니다.

  • Chat 스페이스.
  • 카드 인터페이스에 표시되는 텍스트(단락 텍스트, 버튼과 같이 아이콘과 함께 표시되는 UI 텍스트입니다.

문자 메시지 서식 지정

채팅을 사용하면 문자 메시지에 다음과 같은 기본 서식을 추가할 수 있습니다. 굵게, 기울임꼴, 취소선을 적용할 수 있습니다. 나 문자 메시지의 서식을 카드 메시지와 다르게 지정할 수 있기 때문입니다. 메시지는 Chat과 동일한 구문으로 서식이 지정됩니다. 알 수 있습니다.

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

형식 기호 예시 문법 Google Chat에 표시되는 텍스트
굵게 * *안녕하세요* 안녕하세요
기울임꼴 _ (밑줄) _hello_ 안녕하세요
취소선 ~ ~안녕하세요~ 안녕하세요
고정폭 ` (역따옴표) '안녕하세요' hello
고정폭 블록 ` ` ` (백따옴표 3개) ```
Hello
World
```		 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*?",
    }

메일 텍스트에 다음과 같은 일반 링크 URL을 포함하는 경우 http://www.example.com/, Google Chat에서는 이 텍스트를 링크 텍스트로 사용합니다. 해당 텍스트를 지정된 URL에 자동으로 하이퍼링크로 연결합니다.

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

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

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

문자 메시지에서 사용자 멘션

채팅 앱에서 할 수 있는 작업 문자 메시지 보내기 Chat 스페이스의 한 명 또는 모든 사용자를 @멘션해야 합니다. 채팅 앱은 가져오기 모드에 있는 공백 또는 님이 스페이스에 참여하지 않았습니다.

특정 사용자 @멘션

특정 사용자를 @멘션하려면 <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.sender.name 필드를 사용하여 MESSAGE 상호작용 이벤트.

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

    • Google Chat의 name 필드 사용 User 리소스. 예: 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!"
}

카드에 표시되는 텍스트 서식 지정

카드 내부의 대부분의 텍스트 필드는 작은 하위 집합입니다. 카드 메시지와 텍스트에서 텍스트 서식을 다르게 지정하는 경우 문자 메시지가 사용자가 사용하는 Chat

카드 빌더를 사용하여 채팅 앱의 메시지와 사용자 인터페이스를 디자인하고 미리 봅니다.

카드 빌더 열기 <ph type="x-smartling-placeholder">
</ph>

단락 텍스트 서식 지정

지원되는 태그와 그 목적은 다음과 같습니다. 표:

형식 예 렌더링된 결과
굵게 "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 있습니다.

다음 섹션에서는 기본 제공 아이콘, Google Material 아이콘, 장식된 텍스트 또는 버튼에 있는 맞춤 아이콘

Chat에서 아이콘 사용하기

Chat에서 제공되는 기본 제공 아이콘을 사용하려면 다음 단계를 따르세요. 다음 중 하나를 지정하세요.

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

비행기 북마크
버스 자동차
시계 CONFIRMATION_NUMBER_ICON
DESCRIPTION 달러
이메일 EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
호텔 HOTEL_ROOM_TYPE
초대 MAP_PIN
멤버십 MULTIPLE_PEOPLE
이름 전화
RESTAURANT_ICON SHOPPING_CART
STAR 스토어
티켓 학습
VIDEO_CAMERA VIDEO_PLAY

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

Google 머티리얼 아이콘 사용

Google 머티리얼 아이콘을 사용하여 2,500개가 넘는 아이콘 옵션 중에서 선택하고, 원하는 대로 두께, 채우기, 등급도 지정할 수 있습니다.

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

맞춤 아이콘 사용

맞춤 아이콘을 추가하려면 iconUrl 필드를 포함하고 아이콘의 확인할 수 있습니다.

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