Method: spaces.messages.create

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

이 메서드를 호출하려면 authentication이 필요하며, 다음 인증 유형을 지원합니다.

  • SMS의 경우 사용자 인증 또는 앱 인증이 지원됩니다.
  • 카드 메시지의 경우 앱 인증만 지원됩니다. 채팅 앱만 카드 메시지를 만들 수 있습니다.

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입니다. 채팅 앱이 메시지 리소스 이름에 시스템 할당 ID (메시지 name 필드에 표시됨)를 저장하지 않고도 메시지를 가져오거나 업데이트하거나 삭제할 수 있도록 합니다.

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

  • 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 오류가 대신 반환됩니다.