REST Resource: spaces.messages

{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}

string

메시지의 리소스 이름입니다.

형식: spaces/{space}/messages/{message}

여기서 {space}는 메시지가 게시되는 공간의 ID이고 {message}는 시스템에서 할당한 메시지의 ID입니다. spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB를 예로 들 수 있습니다.

메시지를 만들 때 맞춤 ID를 설정한 경우 이 ID를 사용하면 {message}를 clientAssignedMessageId 필드의 값으로 대체하여 요청에서 메시지를 지정할 수 있습니다. spaces/AAAAAAAAAAA/messages/client-custom-name를 예로 들 수 있습니다. 자세한 내용은 메시지 이름 지정하기를 참고하세요.

object (User)

출력 전용입니다. 메시지를 작성한 사용자입니다. 채팅 앱이 사용자로 인증되면 사용자 name 및 type이 출력됩니다.

string (Timestamp format)

선택사항입니다. 변경할 수 없습니다. Chat에서 만든 스페이스의 경우 메시지가 생성된 시간입니다. 이 필드는 가져오기 모드 공간에서 사용되는 경우를 제외하고 출력 전용입니다.

가져오기 모드 공간의 경우 원래 생성 시간을 보존하기 위해 이 필드를 소스에서 메시지가 생성된 이전 타임스탬프로 설정합니다.

string (Timestamp format)

출력 전용입니다. 사용자가 메시지를 마지막으로 수정한 시간입니다. 메시지를 수정한 적이 없는 경우 이 필드는 비어 있습니다.

string (Timestamp format)

출력 전용입니다. Google Chat에서 메시지가 삭제된 시간입니다. 메일이 삭제되지 않는 경우 이 필드는 비어 있습니다.

string

메일의 일반 텍스트 본문입니다. 이미지, 동영상 또는 웹페이지에 대한 첫 번째 링크는 미리보기 칩을 생성합니다. Google Chat 사용자를@멘션하거나 스페이스의 모든 사용자를 멘션할 수도 있습니다.

문자 메시지 작성에 대해 자세히 알아보려면 메시지 보내기를 참고하세요.

string

출력 전용입니다. 서식을 전달하기 위해 추가된 마크업이 있는 text 메시지를 포함합니다. 이 필드는 UI에 표시되는 모든 서식을 캡처하지 못할 수 있지만 다음을 포함합니다.

• 굵게, 기울임꼴, 취소선, 고정폭, 고정폭 블록, 글머리기호 목록의 마크업 구문

• <users/{user}> 형식을 사용한 사용자 멘션

• <{url}|{rendered_text}> 형식을 사용하는 맞춤 하이퍼링크. 여기서 첫 번째 문자열은 URL이고 두 번째 문자열은 렌더링된 텍스트입니다(예: <http://example.com|custom text>).

• :{emojiName}: 형식을 사용하는 맞춤 이모티콘입니다(예: :smile:). 이는 웃는 얼굴 이모티콘에 사용되는 U+1F600와 같은 유니코드 이모티콘에는 적용되지 않습니다.

자세한 내용은 메일에 포함된 텍스트 서식 보기를 참고하세요.

object (Card)

지원 중단됨: 대신 cardsV2를 사용하세요.

서식이 지정된 텍스트, 버튼, 클릭 가능한 이미지와 같은 UI 요소를 표시하는 데 사용할 수 있는 풍부한 포맷의 대화형 카드입니다. 카드는 일반적으로 메시지의 일반 텍스트 본문 아래에 표시됩니다. cards 및 cardsV2의 최대 크기는 32KB입니다.

object (CardWithId)

카드의 배열입니다.

채팅 앱에서만 카드를 만들 수 있습니다. 채팅 앱이 사용자로 인증되는 경우 메시지에 카드를 포함할 수 없습니다.

카드가 포함된 메시지를 만드는 방법을 알아보려면 메시지 보내기를 참고하세요.

카드 빌더로 카드를 디자인하고 미리 봅니다.

object (Annotation)

출력 전용입니다. 이 메시지의 text와 연결된 주석입니다.

object (Thread)

메시지가 속한 대화목록입니다. 사용 예시는 메시지 대화목록 시작 또는 답장하기를 참고하세요.

object (Space)

채팅 앱이 사용자로 인증되면 공백 name이 출력됩니다.

string

메시지 카드의 일반 텍스트 설명으로, 실제 카드를 표시할 수 없을 때 사용됩니다(예: 모바일 알림).

object (ActionResponse)

입력 전용입니다. 채팅 앱에서 응답 게시 방식을 구성하는 데 사용할 수 있는 매개변수입니다.

string

출력 전용입니다. 모든 채팅 앱 멘션이 삭제된 메시지의 일반 텍스트 본문입니다.

object (SlashCommand)

출력 전용입니다. 슬래시 명령어 정보(해당하는 경우)

object (Attachment)

사용자가 업로드한 첨부파일입니다.

object (MatchedUrl)

출력 전용입니다. 링크 미리보기 패턴과 일치하는 spaces.messages.text의 URL입니다. 자세한 내용은 미리보기 링크를 참고하세요.

boolean

출력 전용입니다. true인 경우 메시지는 답장 대화목록의 응답입니다. false인 경우 메시지가 스페이스의 최상위 대화에 대화목록의 첫 번째 메시지 또는 대화목록 답장이 없는 메시지로 표시됩니다.

스페이스에서 대화목록 내 답장을 지원하지 않는 경우 이 입력란은 항상 false입니다.

string

선택사항입니다. 메시지의 커스텀 ID입니다. 필드를 사용하여 메시지를 식별하거나, 메시지를 가져오거나, 삭제하거나, 업데이트할 수 있습니다. 맞춤 ID를 설정하려면 메시지를 만들 때 messageId 필드를 지정합니다. 자세한 내용은 메시지 이름 지정하기를 참고하세요.

object (EmojiReactionSummary)

출력 전용입니다. 메시지의 이모티콘 반응 요약 목록입니다.

object (User)

변경할 수 없습니다. 메시지 만들기를 위한 입력입니다. 그렇지 않으면 출력 전용입니다. 메시지를 볼 수 있는 사용자입니다. 설정하면 메시지가 비공개로 설정되며 지정된 사용자와 채팅 앱에만 표시됩니다. 요청에 이 필드를 포함하려면 앱 인증을 사용하여 Chat API를 호출하고 다음을 생략해야 합니다.

• 첨부파일
• 액세서리 위젯

자세한 내용은 비공개로 메시지 보내기를 참고하세요.

object (DeletionMetadata)

출력 전용입니다. 삭제된 메일에 관한 정보입니다. deleteTime가 설정되면 메시지가 삭제됩니다.

object (QuotedMessageMetadata)

출력 전용입니다. 스페이스에서 Google Chat 사용자가 인용한 메시지에 관한 정보입니다. Google Chat 사용자는 메시지를 인용하여 답장할 수 있습니다.

object (AttachedGif)

출력 전용입니다. 메일에 첨부된 GIF 이미지

object (AccessoryWidget)

메시지 하단에 표시되는 하나 이상의 대화형 위젯입니다. 텍스트나 카드 또는 텍스트와 카드가 모두 포함된 메시지에 액세서리 위젯을 추가할 수 있습니다. 대화상자가 포함된 메시지에는 지원되지 않습니다. 자세한 내용은 메일 하단에 대화형 위젯 추가를 참고하세요.

액세서리 위젯으로 메시지를 만들려면 앱 인증이 필요합니다.