LiveChatMessages: insert

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

할당량 영향: 이 메서드를 호출하면 할당량 비용이 20단위 발생합니다.

일반적인 사용 사례

요청

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.questionText (문자열): 설문조사의 기본 질문입니다.
    • snippet.pollDetails.metadata.options (배열): 옵션 객체 목록입니다.
    • 요구사항: 항목을 2개 이상 4개 이하로 포함해야 합니다.
    • 순서 지정: 항목은 나열된 순서대로 순차적으로 표시됩니다.
    • 배열의 각 객체에는 다음이 포함되어야 합니다.
      • optionText (문자열): 특정 설문조사 선택 항목에 표시되는 텍스트입니다.

응답

요청에 성공할 경우 이 메서드는 응답 본문에 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 요청 및 응답을 확인합니다.