- HTTP 요청
- 경로 매개변수
- 쿼리 파라미터
- 요청 본문
- 응답 본문
- 승인 범위
- MessageReplyOption
- CreateMessageNotificationOptions
- NotificationType
- 사용해 보기
Google Chat 스페이스에서 메시지를 만듭니다. 예시는 메시지 보내기를 참고하세요.
다음 유형의 인증을 지원합니다.
- 승인 범위가 있는 앱 인증:
https://www.googleapis.com/auth/chat.bot
- 다음 승인 범위 중 하나를 사용하는 사용자 인증:
https://www.googleapis.com/auth/chat.messages.createhttps://www.googleapis.com/auth/chat.messageshttps://www.googleapis.com/auth/chat.import(가져오기 모드 스페이스만 해당)
Chat은 요청에 사용하는 인증 유형에 따라 메시지 발신자를 다르게 지정합니다.
다음 이미지는 앱 인증을 사용할 때 Chat에서 메시지를 표시하는 방법을 보여줍니다. Chat에 채팅 앱이 메시지 발신자로 표시됩니다. 메시지 콘텐츠에는 텍스트(text), 카드(cardsV2), 부가기능 위젯(accessoryWidgets)이 포함될 수 있습니다.
다음 이미지는 사용자 인증을 사용할 때 Chat에서 메시지를 어떻게 표시하는지 보여줍니다. Chat은 사용자를 메시지 발신자로 표시하고 Chat 앱의 이름을 표시하여 메시지를 Chat 앱에 할당합니다. 메시지 콘텐츠에는 텍스트(text)만 포함할 수 있습니다.
메시지 콘텐츠를 포함한 최대 메시지 크기는 32,000바이트입니다.
웹훅 요청의 경우 응답에 전체 메시지가 포함되지 않습니다. 응답은 요청에 있던 정보 외에 name 및 thread.name 필드만 채웁니다.
HTTP 요청
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
parent |
필수 항목입니다. 메시지를 만들 스페이스의 리소스 이름입니다. 형식: |
쿼리 파라미터
| 파라미터 | |
|---|---|
threadKey |
선택사항입니다. 지원 중단됨: 대신 |
requestId |
선택사항입니다. 이 요청의 고유 ID입니다. 임의의 UUID를 사용하는 것이 좋습니다. 요청 ID를 지정하면 요청이 멱등성을 갖게 되므로 동일한 요청 ID를 가진 여러 개의 동일한 요청이 단일 메시지만 생성하게 됩니다. 요청된 세부정보가 현재 상태와 다르더라도 동일한 요청 ID를 사용하는 후속 요청은 기존 메시지를 반환하고 메시지를 업데이트하지 않습니다. 이 필드를 효과적으로 사용하려면 다음 안내를 따르세요.
|
messageReplyOption |
선택사항입니다. 메시지가 대화목록을 시작하는지 아니면 대화목록에 답장하는지 지정합니다. 이름이 지정된 스페이스에서만 지원됩니다. 사용자 상호작용에 응답할 때는 이 필드가 무시됩니다. 대화목록 내 상호작용의 경우 답장은 동일한 대화목록에 생성됩니다. 그렇지 않으면 답장이 새 대화목록으로 생성됩니다. |
messageId |
선택사항입니다. 메시지의 커스텀 ID입니다. Chat 앱이 메시지의 리소스 이름(메시지 이 필드의 값은 다음 요구사항을 충족해야 합니다.
자세한 내용은 메시지 이름 지정하기를 참고하세요. |
createMessageNotificationOptions |
선택사항입니다. 메시지가 게시될 때 알림 동작을 제어합니다. 자세한 내용은 알림 강제 전송 또는 무음 메시지 전송을 참고하세요. |
요청 본문
요청 본문에 Message의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Message의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/chat.bothttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.messageshttps://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 오류가 대신 반환됩니다. |
CreateMessageNotificationOptions
메시지가 게시될 때의 알림 동작 옵션입니다.
| JSON 표현 |
|---|
{
"notificationType": enum ( |
| 필드 | |
|---|---|
notificationType |
메시지의 알림 유형입니다. |
NotificationType
메시지의 알림 유형 옵션입니다.
| 열거형 | |
|---|---|
NOTIFICATION_TYPE_NONE |
기본 동작입니다. 알림 동작은 사용자가 Chat UI를 사용하여 메시지를 보낼 때와 유사합니다. 사용자 발신자에게는 알림이 전송되지 않습니다. |
NOTIFICATION_TYPE_INCLUDE_HUMAN_CREATOR |
메시지 작성자 사용자(예: 메시지를 만드는 데 인증이 사용된 사용자)에게 알림(푸시 알림, 이메일 알림 등)이 전송되고 메시지가 읽지 않음으로 표시됩니다. 이렇게 해도 스페이스의 기존 사용자 알림 설정은 재정의되지 않습니다. 예를 들어 사용자가 스페이스에 대한 알림을 받지 않도록 선택한 경우 이 옵션이 설정되어 있어도 알림이 전송되지 않습니다. 사용자 인증이 필요합니다. |
NOTIFICATION_TYPE_FORCE_NOTIFY |
수신자에게 강제로 알림을 보냅니다. 이렇게 하면 사용자의 스페이스 알림 설정과 Chat 방해 금지 모드 설정이 무시됩니다. 이 옵션은 기기 수준의 방해 금지 모드 설정을 우회하지 않습니다. 앱 인증이 필요합니다. |
NOTIFICATION_TYPE_SILENT |
수신자에게 알림을 보내지 않고 메일을 읽지 않음으로 표시하지 않습니다. 이는 사용자가 대화를 음소거하거나 Chat 방해 금지 모드를 사용 설정하는 것과 유사하게 작동합니다. 앱 인증이 필요합니다. |