Method: spaces.messages.create

Google Chat 스페이스에 메시지를 만듭니다. 예를 보려면 메시지 보내기를 참고하세요.

create() 메서드에는 사용자 인증 또는 앱 인증이 필요합니다. Chat은 요청에 사용하는 인증 유형에 따라 메시지 발신자를 다르게 표시합니다.

다음 이미지는 앱 인증을 사용할 때 Chat에서 메시지를 표시하는 방법을 보여줍니다. Chat에서 채팅 앱을 메시지 발신자로 표시합니다. 메시지 내용은 텍스트 (text), 카드 (cardsV2), 액세서리 위젯 (accessoryWidgets)을 포함할 수 있습니다.

앱 인증으로 전송된 메시지

다음 이미지는 사용자 인증을 사용할 때 Chat에서 메시지를 표시하는 방법을 보여줍니다. Chat은 사용자를 메시지 발신자로 표시하고 Chat 앱의 이름을 표시하여 메시지에 Chat 앱의 속성을 부여합니다. 메시지 콘텐츠에는 텍스트(text)만 포함할 수 있습니다.

사용자 인증으로 전송된 메일

메일 내용을 포함한 최대 메일 크기는 32,000바이트입니다.

Webhook 요청의 경우 응답에 전체 메시지가 포함되지 않습니다. 응답은 요청에 포함된 정보 외에 name 및 thread.name 필드만 채웁니다.

HTTP 요청

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다.

형식: spaces/{space}

쿼리 매개변수

매개변수
threadKey
(deprecated)

string

선택사항입니다. 지원 중단됨: 대신 thread.thread_key를 사용하세요. 대화목록의 ID입니다. 최대 4,000자(영문 기준)까지 지원됩니다. 대화목록을 시작하거나 대화목록에 추가하려면 메시지를 만들고 threadKey 또는 thread.name를 지정합니다. 사용 예는 메시지 대화목록 시작 또는 답장을 참고하세요.
requestId

string

선택사항입니다. 이 메시지의 고유한 요청 ID입니다. 기존 요청 ID를 지정하면 새 메시지를 만드는 대신 해당 ID로 생성된 메시지가 반환됩니다.
messageReplyOption

enum (MessageReplyOption)

선택사항입니다. 메시지가 대화목록을 시작하는지 또는 대화목록에 답장하는지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다.

사용자 상호작용에 응답할 때는 이 필드가 무시됩니다. 대화목록 내 상호작용의 경우 답장은 동일한 대화목록에 생성됩니다. 그렇지 않으면 답장이 새 대화목록으로 생성됩니다.
messageId

string

선택사항입니다. 메시지의 맞춤 ID입니다. Chat 앱이 메시지의 리소스 이름(메시지 name 필드에 표시됨)에 시스템 할당 ID를 저장하지 않고도 메시지를 가져오거나 업데이트하거나 삭제할 수 있도록 합니다.

이 필드의 값은 다음 요구사항을 충족해야 합니다.

  • client-로 시작합니다. 예를 들어 client-custom-name는 유효한 맞춤 ID이지만 custom-name는 그렇지 않습니다.
  • 최대 63자(영문 기준)이며 소문자, 숫자, 하이픈만 포함할 수 있습니다.
  • 스페이스 내에서 고유합니다. 채팅 앱은 여러 메시지에 동일한 맞춤 ID를 사용할 수 없습니다.

자세한 내용은 메시지 이름 지정하기를 참고하세요.

요청 본문

요청 본문에 Message의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Message의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

자세한 내용은 승인 가이드를 참고하세요.

MessageReplyOption

메시지에 답장하는 방법을 지정합니다. 향후 더 많은 주가 추가될 수 있습니다.

열거형
MESSAGE_REPLY_OPTION_UNSPECIFIED 기본값입니다. 새 대화목록을 시작합니다. 이 옵션을 사용하면 포함된 thread ID 또는 threadKey가 무시됩니다.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD thread ID 또는 threadKey로 지정된 대화목록에 대한 답장으로 메시지를 만듭니다. 실패하면 메시지가 대신 새 대화목록을 시작합니다.
REPLY_MESSAGE_OR_FAIL thread ID 또는 threadKey로 지정된 대화목록에 대한 답장으로 메시지를 만듭니다. 새 threadKey가 사용되면 새 스레드가 생성됩니다. 메시지 생성이 실패하면 대신 NOT_FOUND 오류가 반환됩니다.