Google Chat 스페이스에서 메시지를 만듭니다. 예를 보려면 메시지 보내기를 참고하세요.
create()
메서드에는 사용자 인증 또는 앱 인증이 필요합니다. Chat에서는 요청에 사용하는 인증 유형에 따라 메시지 발신자를 다르게 표시합니다.
다음 이미지는 앱 인증을 사용할 때 Chat에서 메시지를 표시하는 방법을 보여줍니다. Chat에서 채팅 앱을 메시지 발신자로 표시합니다. 메시지 내용은 텍스트 (text
), 카드 (cardsV2
), 액세서리 위젯 (accessoryWidgets
)을 포함할 수 있습니다.
다음 이미지는 사용자 인증을 사용할 때 Chat에서 메시지를 표시하는 방법을 보여줍니다. Chat은 사용자를 메시지 발신자로 표시하고 채팅 앱의 이름을 표시함으로써 메시지가 메시지에 기인한 것으로 간주합니다. 메시지 내용은 텍스트 (text
)만 포함할 수 있습니다.
메시지 내용을 포함하여 최대 메시지 크기는 32,000바이트입니다.
HTTP 요청
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: |
쿼리 매개변수
매개변수 | |
---|---|
threadKey |
선택사항입니다. 지원 중단됨: 대신 |
requestId |
선택사항입니다. 이 메시지의 고유한 요청 ID입니다. 기존 요청 ID를 지정하면 새 메시지가 생성되는 대신 해당 ID로 생성된 메시지가 반환됩니다. |
messageReplyOption |
선택사항입니다. 메시지가 대화목록을 시작하는지 아니면 대화목록에 답장할지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. |
messageId |
선택사항입니다. 메시지의 커스텀 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 또는 는 무시됩니다. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
thread ID 또는 로 지정된 스레드에 대한 답장으로 메시지를 만듭니다. 실패하면 메시지가 대신 새 대화목록을 시작합니다. |
REPLY_MESSAGE_OR_FAIL |
thread ID 또는 로 지정된 스레드에 대한 답장으로 메시지를 만듭니다. 새 threadKey 가 사용되면 새 스레드가 생성됩니다. 메시지 생성에 실패하면 NOT_FOUND 오류가 대신 반환됩니다. |