API 참조

이 API 참조에서는 YouTube Live Streaming API를 사용하여 YouTube에서 라이브 방송과 동영상 스트림을 예약하는 방법을 설명합니다.

리소스 유형

LiveBroadcasts

liveBroadcast 리소스는 YouTube에서 라이브 동영상을 통해 스트리밍되는 이벤트를 나타냅니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
bind POST /liveBroadcasts/bind YouTube 방송을 스트림에 바인딩하거나 방송과 스트림 간의 기존 바인딩을 삭제합니다. 동영상 스트림은 여러 방송에 바인드될 수 있지만 방송은 하나의 동영상 스트림에만 바인드될 수 있습니다.
delete DELETE /liveBroadcasts 브로드캐스트를 삭제합니다.
insert POST /liveBroadcasts 브로드캐스트를 만듭니다.
list GET /liveBroadcasts API 요청 매개변수와 일치하는 YouTube 방송 목록을 반환합니다.
transition POST /liveBroadcasts/transition YouTube 라이브 방송의 상태를 변경하고 새 상태와 연결된 프로세스를 시작합니다. 예를 들어 방송의 상태를 testing로 전환하면 YouTube에서 해당 방송의 모니터 스트림으로 동영상을 전송하기 시작합니다. 이 메서드를 호출하기 전에 방송에 바인딩된 스트림의 status.streamStatus 속성 값이 active인지 확인해야 합니다.
update PUT /liveBroadcasts 브로드캐스트를 업데이트합니다. 예를 들어 liveBroadcast 리소스의 contentDetails 객체에 정의된 브로드캐스트 설정을 수정할 수 있습니다.
cuepoint POST /liveBroadcasts/cuepoint 라이브 방송에 큐 포인트를 삽입합니다. 큐 포인트가 광고 시점을 트리거할 수 있습니다.

LiveChatBans

liveChatBan 리소스는 YouTube 사용자와 사용자가 참여할 수 없도록 차단된 YouTube 실시간 채팅을 식별합니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
delete DELETE /liveChat/bans 특정 사용자가 실시간 채팅에 참여하지 못하도록 하는 차단을 삭제하여 사용자가 채팅에 다시 참여할 수 있도록 합니다. API 요청은 채널 소유자 또는 차단과 연결된 라이브 채팅의 운영자가 승인해야 합니다.
insert POST /liveChat/bans 특정 사용자가 실시간 채팅에 참여하지 못하도록 차단합니다. API 요청은 채널 소유자 또는 차단과 연결된 라이브 채팅의 운영자가 승인해야 합니다.

LiveChatMessages

liveChatMessage 리소스는 YouTube 실시간 채팅의 채팅 메시지를 나타냅니다. 리소스에는 새로 게시된 텍스트 메시지 또는 팬 후원 이벤트 등 여러 유형의 메시지에 관한 세부정보가 포함될 수 있습니다.

라이브 채팅 기능은 라이브 방송에 기본적으로 사용 설정되어 있으며 라이브 이벤트가 활성 상태일 때 사용할 수 있습니다. (이벤트가 종료되면 해당 이벤트에 더 이상 실시간 채팅을 사용할 수 없습니다.)

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
delete DELETE /liveChat/messages 채팅 메시지를 삭제합니다. API 요청은 채널 소유자 또는 차단과 연결된 라이브 채팅의 운영자가 승인해야 합니다.
insert POST /liveChat/messages 실시간 채팅에 메시지를 추가합니다.
list GET /liveChat/messages 특정 채팅의 실시간 채팅 메시지를 나열합니다.
streamList 지연 시간이 짧은 특정 채팅의 실시간 채팅 메시지를 수신하기 위한 서버 스트리밍 연결을 사용 설정합니다.

LiveChatModerators

liveChatModerator 리소스는 YouTube 실시간 채팅의 운영자를 나타냅니다. 채팅 운영자는 채팅에서 사용자를 차단하거나 차단 해제하고, 메시지를 삭제하고, 실시간 채팅에 대한 기타 관리 작업을 수행할 수 있습니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
delete DELETE /liveChat/moderators 채팅 운영자를 삭제합니다. 요청은 라이브 방송 채널의 소유자가 승인해야 합니다.
insert POST /liveChat/moderators 채팅의 새 관리자를 추가합니다. 요청은 라이브 방송 채널의 소유자가 승인해야 합니다.
list GET /liveChat/moderators 실시간 채팅의 운영자를 나열합니다. 요청은 라이브 방송 채널의 소유자가 승인해야 합니다.

LiveStreams

liveStream 리소스에는 YouTube로 전송하는 동영상 스트림에 관한 정보가 포함됩니다. 스트림은 YouTube 사용자에게 방송될 콘텐츠를 제공합니다. liveStream 리소스가 생성되면 하나 이상의 liveBroadcast 리소스에 바인딩될 수 있습니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
delete DELETE /liveStreams 동영상 스트림을 삭제합니다.
insert POST /liveStreams 동영상 스트림을 만듭니다. 스트림을 사용하면 동영상을 YouTube로 전송할 수 있으며, YouTube는 이 동영상을 시청자에게 브로드캐스트할 수 있습니다.
list GET /liveStreams API 요청 매개변수와 일치하는 동영상 스트림 목록을 반환합니다.
update PUT /liveStreams 동영상 스트림을 업데이트합니다. 변경하려는 속성을 업데이트할 수 없는 경우 적절한 설정으로 새 스트림을 만들어야 합니다.

SuperChatEvents

superChatEvent 리소스는 YouTube 라이브 스트림 중에 팬이 구매한 Super Chat 메시지를 나타냅니다. YouTube 실시간 채팅 스트림에서 Super Chat은 다른 메시지에 비해 두 가지 면에서 눈에 띕니다.

  • Super Chat은 색상으로 강조 표시됩니다.
  • Super Chat은 일정 시간 동안 티커에 고정됩니다.

Super Chat의 색상, 티커에 고정되는 기간, 최대 메시지 길이는 모두 구매 금액에 따라 결정됩니다. Super Chat에 대해 자세히 알아보려면 YouTube 고객센터를 참고하세요.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3을 기준으로 하는 URI
list GET /superChatEvents 지난 30일 동안 채널의 라이브 스트림에서 발생한 Super Chat 이벤트를 나열합니다.