LiveChatMessages: insert

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

일반적인 사용 사례

요청

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 요청 및 응답을 확인합니다.