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 |
필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: |
쿼리 매개변수
매개변수 | |
---|---|
threadKey |
선택사항입니다. 지원 중단됨: 대신 |
request |
선택사항입니다. 이 메시지의 고유한 요청 ID입니다. 기존 요청 ID를 지정하면 새 메시지를 만드는 대신 해당 ID로 생성된 메시지가 반환됩니다. |
message |
선택사항입니다. 메시지가 대화목록을 시작하는지 또는 대화목록에 답장하는지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. 사용자 상호작용에 응답할 때는 이 필드가 무시됩니다. 대화목록 내 상호작용의 경우 답장은 동일한 대화목록에 생성됩니다. 그렇지 않으면 답장이 새 대화목록으로 생성됩니다. |
message |
선택사항입니다. 메시지의 맞춤 ID입니다. Chat 앱이 메시지의 리소스 이름(메시지 이 필드의 값은 다음 요구사항을 충족해야 합니다.
자세한 내용은 메시지 이름 지정하기를 참고하세요. |
요청 본문
요청 본문에 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 오류가 반환됩니다. |