Google Chat 스페이스에서 메시지를 만듭니다. 텍스트 및 카드를 포함한 최대 메시지 크기는 32,000바이트입니다. 예는 메시지 보내기를 참고하세요.
이 메서드를 호출하려면 authentication이 필요하며, 다음 인증 유형을 지원합니다.
- SMS의 경우 사용자 인증 또는 앱 인증이 지원됩니다.
- 카드 메시지의 경우 앱 인증만 지원됩니다. 채팅 앱만 카드 메시지를 만들 수 있습니다.
HTTP 요청
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: |
쿼리 매개변수
매개변수 | |
---|---|
threadKey |
선택사항입니다. 지원 중단됨: 대신 |
requestId |
선택사항입니다. 이 메시지의 고유한 요청 ID입니다. 기존 요청 ID를 지정하면 새 메시지를 만드는 대신 이 ID로 생성된 메시지가 반환됩니다. |
messageReplyOption |
선택사항입니다. 메시지가 대화목록을 시작할지 대화목록에 답장할지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. |
messageId |
선택사항입니다. 메시지의 커스텀 ID입니다. 채팅 앱이 메시지 리소스 이름에 시스템 할당 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 오류가 대신 반환됩니다. |