Google Chat 메시지 개요

이 페이지에서는 문자 메시지와 카드 메시지의 차이점을 설명합니다.

Chat 앱에서 문자 메시지를 보내 기본 정보를 전달할 때 Google Chat에서 사용자가 작성하는 방식과 마찬가지로 메시지가 인라인으로 표시됩니다. 메시지를 보낼 수 있습니다 텍스트가 많지 않은 메시지를 작성하거나 메시지, 채팅 앱에서 사용자가 상호작용할 수 있는 카드를 입력합니다. 채팅 앱은 카드와 함께 문자 메시지를 추가할 수도 있습니다. 받는사람 사용자에게 양식 작성, 양식 작성, 문서 작성, 채팅 앱에서 다음과 같이 새 창에서 열리는 카드를 만들 수도 있습니다. 대화상자를 만듭니다.

문자 메시지 분석

Google Chat API에서 메시지는 JSON 객체로 표시됩니다. 메시지 내에서 문자 메시지는 text 드림 객체를 지정합니다.

다음에서 예: 채팅 앱이 스페이스에서 문자 메시지 생성 코드 동결이 다가오고 있는 소프트웨어 개발자팀을 위해 다음과 같이 조치해 주시기 바랍니다.

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

JSON은 다음 메시지를 반환합니다.

코드 동결을 알리는 Google Chat 문자 메시지의 예

카드 메시지 분석

Google Chat API에서 메시지는 JSON 객체로 표시됩니다. 메시지 내 카드는 cardsV2 드림 배열이며 다음으로 구성됩니다.

  • 하나 이상 CardWithId 객체.
  • cardId: 카드를 식별하는 데 사용되며 지정된 메시지 내에서 범위가 지정됩니다. (서로 다른 메시지에 있는 카드는 동일한 ID를 사용할 수 있습니다.)

  • card 객체로, 다음으로 구성됩니다.

    • header 객체 제목, 부제목, 아바타 스타일 이미지와 같은 것을 지정합니다.
    • 하나 이상 section 객체 각각 하나 이상의 위젯이 있어야 합니다.
    • 하나 이상 widget 객체. 각 위젯은 텍스트, 이미지, 텍스트, 이미지, 오디오, 버튼 및 기타 객체 유형을 사용할 수 있습니다.

예를 들어 다음 카드 메시지에는 header님, section 및 widget 객체:

Chat에서 설문조사를 실행하는 채팅 앱 카드를 사용한 스페이스 메시지

다음 코드는 카드 메시지의 JSON을 나타냅니다.

JSON

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
          "title": "Sasha",
          "subtitle": "Software Engineer",
          "imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
          "imageType": "CIRCLE",
          "imageAltText": "Avatar for Sasha"
        },
        "sections": [
          {
            "header": "Contact Info",
            "collapsible": true,
            "uncollapsibleWidgetsCount": 1,
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL"
                  },
                  "text": "sasha@example.com"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON"
                  },
                  "text": "<font color=\"#80e27e\">Online</font>"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE"
                  },
                  "text": "+1 (555) 555-1234"
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Share",
                      "onClick": {
                        "openLink": {
                          "url": "https://example.com/share"
                        }
                      }
                    },
                    {
                      "text": "Edit",
                      "onClick": {
                        "action": {
                          "function": "goToView",
                          "parameters": [
                            {
                              "key": "viewType",
                              "value": "EDIT"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

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

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