LiveChatMessages: insert

실시간 채팅에 메시지 또는 설문조사를 추가합니다.

일반적인 사용 사례

요청

HTTP 요청

POST https://www.googleapis.com/youtube/v3/liveChat/messages

승인

이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다. 인증 및 승인에 대해 자세히 알아보려면 OAuth 2.0 인증 구현을 참고하세요.

범위
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에서 반환할 수 있는 오류 메시지가 나와 있습니다. 자세한 내용은 YouTube Live Streaming 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 요청 및 응답을 확인합니다.