실시간 채팅에 메시지 또는 설문조사를 추가합니다.
일반적인 사용 사례
요청
HTTP 요청
POST https://www.googleapis.com/youtube/v3/liveChat/messages
승인
이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)
범위 |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
매개변수
다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.
매개변수 | ||
---|---|---|
필수 매개변수 | ||
part |
string part 매개변수의 용도는 두 가지입니다. 쓰기 연산에서 설정하는 속성과 API 응답에서 포함하는 속성을 식별합니다. 매개변수 값을 snippet 로 설정합니다. |
요청 본문
요청 본문에 liveChatMessage 리소스를 제공합니다. 해당 리소스의 경우 속성 값을 지정해야 합니다.
snippet.liveChatId
snippet.type
-textMessageEvent
또는pollEvent
옵션 중 하나를 선택합니다.- 유형이
textMessageEvent
인 경우snippet.textMessageDetails.messageText
를 포함합니다. - 유형이
pollEvent
이면 다음 값과 함께snippet.pollDetails
를 포함합니다.snippet.pollDetails.metadata.options.questionText
snippet.pollDetails.metadata.options.optionText
의 목록입니다. 항목은 최소 2개에서 5개까지 입력해야 합니다. 항목은 나열된 순서대로 순차적으로 표시됩니다.
응답
요청에 성공할 경우 이 메서드는 응답 본문에 liveChatMessage 리소스를 반환합니다.
오류
다음 표에서는 이 메서드에 대한 호출에 대한 응답으로 API가 반환할 수 있는 오류 메시지를 식별합니다. 자세한 내용은 오류 메시지 설명서를 참조하세요.
오류 유형 | 오류 세부정보 | 설명 |
---|---|---|
forbidden (403) |
forbidden |
지정한 메시지를 만드는 데 필요한 권한이 없습니다. |
forbidden (403) |
liveChatDisabled |
소유자가 지정된 실시간 채팅을 사용 중지했으므로 메시지를 채팅에 추가할 수 없습니다. |
forbidden (403) |
liveChatEnded |
지정된 실시간 채팅이 더 이상 진행되지 않습니다. |
invalidValue (400) |
messageTextInvalid |
메시지 텍스트 (snippet.textMessageDetails.messageText )가 잘못되었습니다. |
notFound (404) |
liveChatNotFound |
API 요청에서 식별된 실시간 채팅이 존재하지 않습니다. 이 오류는 소유자가 채팅을 삭제한 경우에 발생합니다. |
required (400) |
liveChatIdRequired |
liveChatMessage 리소스는 snippet.liveChatId 속성 값을 포함하고 지정해야 합니다. |
required (400) |
messageTextRequired |
liveChatMessage 리소스는 snippet.textMessageDetails.messageText 속성 값을 포함하고 지정해야 합니다. |
required (400) |
typeRequired |
liveChatMessage 리소스는 snippet.type 속성 값을 포함하고 지정해야 합니다. 매개변수 값을 text 로 설정합니다. |
required (400) |
preconditionCheckFailed |
고정된 활성 설문조사가 이미 있습니다. |
rateLimitExceeded |
rateLimitExceeded |
사용자가 지정된 기간에 채팅 메시지를 너무 많이 게시했습니다. |
사용해 보기
APIs Explorer를 사용하여 이 API를 호출하고 API 요청 및 응답을 확인합니다.