이 API 참조에서는 YouTube Live Streaming API를 사용하여 YouTube에서 실시간 방송과 동영상 스트림을 예약하는 방법을 설명합니다.
리소스 유형
실시간 방송
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 |
실시간 방송에 큐 포인트를 삽입합니다. 큐 포인트가 광고 시점을 트리거할 수 있습니다. |
실시간 채팅 차단
liveChatBan 리소스는 참여가 차단된 YouTube 사용자와 YouTube 실시간 채팅을 식별합니다.
이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.
| 메소드 | HTTP 요청 | 설명 |
|---|---|---|
https://www.googleapis.com/youtube/v3 기준 URI |
||
delete |
DELETE /liveChat/bans |
특정 사용자가 실시간 채팅에 참여하지 못하도록 차단하여 사용자가 채팅에 다시 참여할 수 있도록 합니다. 차단과 연결된 실시간 채팅의 채널 소유자나 운영자가 API 요청을 승인해야 합니다. |
insert |
POST /liveChat/bans |
특정 사용자가 실시간 채팅에 참여하지 못하도록 차단합니다. 차단과 연결된 실시간 채팅의 채널 소유자나 운영자가 API 요청을 승인해야 합니다. |
실시간 채팅 메시지
liveChatMessage 리소스는 YouTube 실시간 채팅의 채팅 메시지를 나타냅니다. 리소스에 새로 게시된 문자 메시지 또는 팬 자금지원 이벤트 등 여러 유형의 메시지에 대한 세부정보가 포함될 수 있습니다.
실시간 채팅 기능은 실시간 방송에서 기본적으로 사용 설정되어 있으며 실시간 이벤트가 진행되는 동안 사용할 수 있습니다. 이벤트가 종료된 후에는 해당 이벤트에서 실시간 채팅을 사용할 수 없습니다.
이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.
| 메소드 | HTTP 요청 | 설명 |
|---|---|---|
https://www.googleapis.com/youtube/v3 기준 URI |
||
delete |
DELETE /liveChat/messages |
채팅 메시지를 삭제합니다. 차단과 연결된 실시간 채팅의 채널 소유자나 운영자가 API 요청을 승인해야 합니다. |
insert |
POST /liveChat/messages |
실시간 채팅에 메시지를 추가합니다. |
list |
GET /liveChat/messages |
특정 채팅의 실시간 채팅 메시지를 표시합니다. |
실시간 채팅 운영자
liveChatModerator 리소스는 YouTube 실시간 채팅의 진행자를 나타냅니다. 채팅 운영자는 채팅에서 사용자를 차단 또는 차단 해제하고, 메시지를 삭제하고, 실시간 채팅에 대한 기타 관리 작업을 수행할 수 있습니다.
이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.
| 메소드 | HTTP 요청 | 설명 |
|---|---|---|
https://www.googleapis.com/youtube/v3 기준 URI |
||
delete |
DELETE /liveChat/moderators |
채팅 운영자를 삭제합니다. 실시간 방송의 채널 소유자가 요청을 승인해야 합니다. |
insert |
POST /liveChat/moderators |
채팅에 새 운영자를 추가합니다. 실시간 방송의 채널 소유자가 요청을 승인해야 합니다. |
list |
GET /liveChat/moderators |
실시간 채팅 운영자를 나열합니다. 실시간 방송의 채널 소유자가 요청을 승인해야 합니다. |
실시간 스트림
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 |
동영상 스트림을 업데이트합니다. 변경하려는 속성을 업데이트할 수 없는 경우 적절한 설정으로 새 스트림을 만들어야 합니다. |
스폰서
sponsor 리소스는 YouTube 채널의 스폰서를 나타냅니다. 스폰서는 크리에이터에게 구독이나 멤버십 수수료와 같은 반복적인 금전적 지원을 제공하고 특별한 혜택을 받습니다. 예를 들어 크리에이터가 채팅에 스폰서 전용 모드를 사용 설정하면 VIP가 채팅할 수 있습니다.
이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.
| 메소드 | HTTP 요청 | 설명 |
|---|---|---|
https://www.googleapis.com/youtube/v3 기준 URI |
||
list |
GET /sponsors |
채널의 스폰서를 나열합니다. API 요청은 채널 소유자의 승인을 받아야 합니다. |
Super Chat 이벤트
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 이벤트를 나열합니다. |
지원 중단된 리소스 유형
팬 자금지원 이벤트
fanFundingEvent 리소스는 YouTube 채널의 팬 자금지원 이벤트를 나타냅니다. 팬 자금지원은 YouTube 크리에이터를 금전적으로 후원할 수 있는 방법입니다. 팬 자금지원 이벤트는 사용자가 채널에 일회성으로 자발적으로 결제하면 발생합니다. 팬 자금지원에 대해 자세히 알아보려면 YouTube 고객센터를 참조하세요.
이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.
| 메소드 | HTTP 요청 | 설명 |
|---|---|---|
https://www.googleapis.com/youtube/v3 기준 URI |
||
list |
GET /fanFundingEvents |
채널의 팬 자금지원 이벤트 목록 API 요청은 채널 소유자의 승인을 받아야 합니다. |