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로 전송할 수 있으며 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 채널의 스폰서를 나타냅니다. 스폰서는 크리에이터에게 구독료 또는 멤버십 요금과 같은 정기적인 금전적 지원을 제공하고 특별한 혜택을 받습니다. 예를 들어 크리에이터가 채팅에 스폰서 전용 모드를 사용 설정하면 스폰서가 채팅할 수 있습니다.

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

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