Jak korzystać z interfejsu API

Ten dokument referencyjny interfejsu API wyjaśnia, jak planować transmisje na żywo i strumienie wideo w YouTube za pomocą interfejsu YouTube Live Streaming API.

Typy zasobów

LiveBroadcasts

Zasób liveBroadcast reprezentuje wydarzenie, które będzie transmitowane na żywo w YouTube.

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Łączy transmisję w YouTube ze strumieniem lub usuwa istniejące połączenie między transmisją a strumieniem. Transmisję można powiązać tylko z 1 strumieniem wideo, ale strumień wideo można powiązać z więcej niż 1 transmisją.
delete DELETE /liveBroadcasts Usuwa transmisję.
insert POST /liveBroadcasts tworzy transmisję.
list GET /liveBroadcasts Zwraca listę transmisji w YouTube, które pasują do parametrów żądania do interfejsu API.
transition POST /liveBroadcasts/transition Zmienia stan transmisji na żywo w YouTube i inicjuje procesy powiązane z nowym stanem. Na przykład, gdy zmienisz stan transmisji na testing, YouTube zacznie przesyłać wideo do strumienia monitora tej transmisji. Przed wywołaniem tej metody sprawdź, czy wartość właściwości status.streamStatus w przypadku strumienia powiązanego z transmisją wynosi active.
update PUT /liveBroadcasts Aktualizuje transmisję. Możesz na przykład zmienić ustawienia transmisji zdefiniowane w obiekcie contentDetails zasobu liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Wstawia punkt sygnałowy do transmisji na żywo. Punkt sygnałowy może wywołać przerwę na reklamę.

LiveChatBans

liveChatBan zasób identyfikuje użytkownika YouTube i czat na żywo w YouTube, na którym użytkownik ma zakaz uczestniczenia.

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Usuwa blokadę, która uniemożliwia konkretnemu użytkownikowi dodawanie treści na czacie na żywo, dzięki czemu może on ponownie dołączyć do czatu. Żądanie interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z banem.
insert POST /liveChat/bans Blokuje konkretnego użytkownika, uniemożliwiając mu udział w czacie na żywo. Żądanie interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z banem.

LiveChatMessages

liveChatMessage to zasób reprezentujący wiadomość na czacie na żywo w YouTube. Może on zawierać szczegóły dotyczące kilku rodzajów wiadomości, w tym nowo opublikowanej wiadomości tekstowej lub wydarzenia związanego z finansowaniem przez fanów.

Funkcja czatu na żywo jest domyślnie włączona w przypadku transmisji na żywo i jest dostępna, gdy wydarzenie na żywo jest aktywne. (Po zakończeniu wydarzenia czat na żywo nie jest już dostępny).

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Usuwa wiadomość z czatu. Żądanie interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z banem.
insert POST /liveChat/messages Dodaje wiadomość do czatu na żywo.
list GET /liveChat/messages Wyświetla wiadomości z czatu na żywo dla konkretnego czatu.
streamList Umożliwia połączenie strumieniowe z serwerem w celu odbierania wiadomości z czatu na żywo w przypadku konkretnego czatu z małym opóźnieniem.

LiveChatModerators

Zasób liveChatModerator reprezentuje moderatora czatu na żywo w YouTube. Moderator czatu może banować i odbanowywać użytkowników, usuwać wiadomości i wykonywać inne działania administracyjne na czacie na żywo.

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Usuwa moderatora czatu. Prośba musi zostać zatwierdzona przez właściciela kanału, na którym jest transmitowana transmisja na żywo.
insert POST /liveChat/moderators Dodaje nowego moderatora czatu. Prośba musi zostać zatwierdzona przez właściciela kanału, na którym jest transmitowana transmisja na żywo.
list GET /liveChat/moderators Wyświetla listę moderatorów czatu na żywo. Prośba musi zostać zatwierdzona przez właściciela kanału, na którym jest transmitowana transmisja na żywo.

LiveStreams

liveStream zawiera informacje o strumieniu wideo, który przesyłasz do YouTube. Strumień zawiera treści, które będą transmitowane do użytkowników YouTube. Po utworzeniu zasób liveStream można powiązać z co najmniej 1 zasobem liveBroadcast.

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Usuwa strumień wideo.
insert POST /liveStreams tworzy strumień wideo. Strumień umożliwia wysyłanie filmu do YouTube, który może następnie transmitować go do odbiorców.
list GET /liveStreams Zwraca listę strumieni wideo, które pasują do parametrów żądania do interfejsu API.
update PUT /liveStreams Aktualizuje strumień wideo. Jeśli właściwości, które chcesz zmienić, nie mogą zostać zaktualizowane, musisz utworzyć nowy strumień z odpowiednimi ustawieniami.

SuperChatEvents

Zasób superChatEvent reprezentuje wiadomość na superczacie kupioną przez fana podczas transmisji na żywo w YouTube. W czacie na żywo w YouTube superczaty wyróżniają się na 2 sposoby:

  • Superczaty są wyróżnione kolorem.
  • Superczaty pozostają przypięte na pasku aktywności przez określony czas.

Kolor superczatu, czas, przez jaki jest on przypięty na pasku aktywności, oraz maksymalna długość wiadomości zależą od kwoty zakupu. Więcej informacji o superczatach znajdziesz w Centrum pomocy YouTube.

Więcej informacji o tym zasobie znajdziesz w jego reprezentacji i na liście właściwości.

Metoda Żądanie HTTP Opis
Identyfikatory URI odnoszące się do elementu https://www.googleapis.com/youtube/v3
list GET /superChatEvents Wyświetlać listę wydarzeń związanych z superczatem z transmisji na żywo na kanale w ciągu ostatnich 30 dni.