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 특정 채팅의 실시간 채팅 메시지를 나열합니다.

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로 전송한 후 시청자에게 동영상을 방송할 수 있습니다.
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 이벤트 나열

지원 중단된 리소스 유형

FanFundingEvents

fanFundingEvent 리소스는 YouTube 채널의 팬 후원 이벤트를 나타냅니다. 팬 후원은 YouTube 크리에이터를 금전적으로 후원할 수 있는 방법입니다. 팬 자금지원 이벤트는 사용자가 채널에 일회성으로 자발적으로 결제하면 발생합니다. 팬 후원에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요.

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

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3 기준 URI
list GET /fanFundingEvents 채널의 크리에이터 후원 이벤트를 나열합니다. API 요청은 채널 소유자의 승인을 받아야 합니다.

LiveCuepoints

liveCuepoint 리소스는 방송 동영상 스트림에서 광고 시점을 시작합니다.

참고: 큐 시점을 제어하는 API 명령어는 실제로 YouTube Content ID API의 일부이며 liveBroadcast 및 liveStream 리소스를 관리하기 위한 요청과는 다른 승인 요구사항이 있습니다.

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

메소드 HTTP 요청 설명
https://www.googleapis.com/ 기준 URI
insert POST /liveCuepoints 실시간 방송에 큐 시점을 삽입합니다. 현재 이 방법에 대한 요청은 YouTube 콘텐츠 소유자와 연결된 계정의 승인을 받아야 합니다.

스폰서

sponsor 리소스는 YouTube 채널의 스폰서를 나타냅니다. 스폰서는 크리에이터에게 구독 또는 멤버십 요금과 같은 금전적 지원을 반복적으로 제공하며 특별한 혜택을 받습니다. 예를 들어 크리에이터가 채팅에 VIP 전용 모드를 사용 설정하면 VIP가 채팅할 수 있습니다.

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

메소드 HTTP 요청 설명
https://www.googleapis.com/youtube/v3 기준 URI
list GET /sponsors 채널의 스폰서를 나열합니다. API 요청은 채널 소유자의 승인을 받아야 합니다.