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)

출력 전용입니다. 메시지를 작성한 사용자입니다. Chat 앱이 사용자로 인증되면 출력에 사용자 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)

선택사항입니다. 카드의 배열입니다.

Chat 앱만 카드를 만들 수 있습니다. Chat 앱이 사용자로 인증하는 경우 메일에 카드를 포함할 수 없습니다.

카드가 포함된 메시지를 만드는 방법은 메시지 보내기를 참고하세요.

카드 작성 도구로 카드를 디자인하고 미리보기를 확인합니다.

object (Annotation)

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

object (Thread)

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

object (Space)

출력 전용입니다. Chat 앱이 사용자로 인증되면 출력은 스페이스 name만 채웁니다.

string

선택사항입니다. 메시지 카드에 대한 일반 텍스트 설명으로, 실제 카드를 표시할 수 없는 경우에 사용됩니다(예: 모바일 알림).

object (ActionResponse)

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

string

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

object (SlashCommand)

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

object (Attachment)

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

object (MatchedUrl)

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

boolean

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

스페이스에서 대화목록의 답글을 지원하지 않는 경우 이 필드는 항상 false입니다.

string

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

object (EmojiReactionSummary)

출력 전용입니다. 메시지에 있는 그림 이모티콘 반응 요약 목록입니다.

object (User)

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

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

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

object (DeletionMetadata)

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

object (QuotedMessageMetadata)

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

object (AttachedGif)

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

object (AccessoryWidget)

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

액세서리 위젯을 사용하여 메시지를 만들려면 앱 인증이 필요합니다.