Dokumentacja API

Z tego artykułu dowiesz się, jak zaplanować transmisje na żywo w YouTube za pomocą interfejsu YouTube Live Streaming API.

Typy zasobów

LiveBroadcasts

Zasób liveBroadcast reprezentuje wydarzenie, które będzie transmitowane w YouTube w formie transmisji 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 względem obiektu https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Wiąże transmisję YouTube ze strumieniem lub usuwa istniejące powiązanie między transmisją a strumieniem. Transmisję można powiązać tylko z jednym strumieniem wideo, natomiast strumień wideo może być powiązany z więcej niż jedną transmisją.
delete DELETE /liveBroadcasts Usuwa transmisję.
insert POST /liveBroadcasts Tworzy transmisję.
list GET /liveBroadcasts Zwraca listę komunikató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 związane z nim procesy. Jeśli na przykład zmienisz stan transmisji na testing, YouTube zacznie przesyłać wideo do strumienia monitorowania tej transmisji. Przed wywołaniem tej metody upewnij się, że wartość właściwości status.streamStatus strumienia powiązanego z transmisją wynosi active.
update PUT /liveBroadcasts Aktualizuje transmisję. Można na przykład zmienić ustawienia emisji zdefiniowane w obiekcie contentDetails zasobu liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint Wstawia punkt wstawienia do transmisji na żywo. Punkt wstawienia reklamy może wywołać przerwę na reklamę.

LiveChatBans

Zasób liveChatBan identyfikuje użytkownika YouTube i czat na żywo w YouTube, w którym użytkownik nie może uczestniczyć.

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

Metoda Żądanie HTTP Opis
Identyfikatory URI względem obiektu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Powoduje usunięcie blokady, która uniemożliwia konkretnemu użytkownikowi współtworzenie czatu na żywo i pozwala mu ponownie dołączyć do czatu. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z blokadą.
insert POST /liveChat/bans Blokuje konkretnemu użytkownikowi możliwość uczestniczenia w czacie na żywo. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z blokadą.

LiveChatMessages

Zasób liveChatMessage reprezentuje wiadomość na czacie na żywo w YouTube. Zasób może zawierać szczegółowe informacje na temat kilku typów wiadomości, w tym nowo opublikowanego SMS-a 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 podczas trwania wydarzenia na żywo. (Po zakończeniu wydarzenia czat na żywo nie będzie 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 względem obiektu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Usuwa wiadomość z czatu. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub moderatora czatu na żywo powiązanego z blokadą.
insert POST /liveChat/messages Dodaje wiadomość do czatu na żywo.
list GET /liveChat/messages Wyświetla listę wiadomości z czatu na żywo z konkretnego czatu.

LiveChatModerators

Zasób liveChatModerator reprezentuje moderatora czatu na żywo w YouTube. Moderator czatu może blokować i odblokowywać użytkowników, usuwać wiadomości i wykonywać inne czynności administracyjne dotyczące czatu 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 względem obiektu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators usuwa moderatora czatu. Prośba musi być zatwierdzona przez właściciela kanału transmisji na żywo.
insert POST /liveChat/moderators Dodaje nowego moderatora czatu. Prośba musi być zatwierdzona przez właściciela kanału transmisji na żywo.
list GET /liveChat/moderators Wyświetla listę moderatorów czatu na żywo. Prośba musi być zatwierdzona przez właściciela kanału transmisji na żywo.

LiveStreams

Zasób liveStream zawiera informacje o strumieniu wideo, który przesyłasz do YouTube. Strumień zawiera treści, które będą transmitowane dla 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 względem obiektu https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Usuwa strumień wideo.
insert POST /liveStreams Tworzy strumień wideo. Strumień umożliwia przesłanie filmu do YouTube, gdzie zostanie on rozpowszechniony wśród odbiorców.
list GET /liveStreams Zwraca listę strumieni wideo pasujących do parametrów żądania do interfejsu API.
update PUT /liveStreams Aktualizuje strumień wideo. Jeśli nie możesz zaktualizować właściwości, które chcesz zmienić, musisz utworzyć nowy strumień z odpowiednimi ustawieniami.

SuperChatEvents

Zasób superChatEvent to wiadomość superczatu zakupiona przez fana podczas transmisji na żywo w YouTube. Podczas transmisji na żywo w YouTube superczaty wyróżniają się na tle innych wiadomości na 2 sposoby:

  • Superczaty są wyróżnione kolorem.
  • Superczaty są 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. Aby dowiedzieć się więcej o superczacie, zajrzyj do 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 względem obiektu https://www.googleapis.com/youtube/v3
list GET /superChatEvents wyświetlać listę zdarzeń Superczatu podczas transmisji na żywo na kanale w ciągu ostatnich 30 dni.

Wycofane typy zasobów

FanFundingEvents

Zasób fanFundingEvent oznacza wydarzenie związane z finansowaniem przez fanów na kanale YouTube. Finansowanie przez fanów to sposób na finansowe wsparcie twórców YouTube. Finansowanie przez fanów ma miejsce, gdy użytkownik dokonuje jednorazowej, dobrowolnej wpłaty na rzecz kanału. Więcej informacji o finansowaniu przez fanów 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 względem obiektu https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Wyświetla listę zdarzeń związanych z finansowaniem przez fanów na kanale. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału.

LiveCuepoints

Zasób liveCuepoint rozpoczyna przerwę na reklamę w transmisji wideo.

Uwaga: polecenie interfejsu API służące do kontrolowania punktów wstawienia reklamy jest w rzeczywistości częścią interfejsu YouTube Content ID API i ma inne wymagania dotyczące autoryzacji niż żądania dotyczące zarządzania zasobami liveBroadcast i liveStream.

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

Metoda Żądanie HTTP Opis
Identyfikatory URI względem obiektu https://www.googleapis.com/
insert POST /liveCuepoints Wstawia punkt wstawienia do transmisji na żywo. Obecnie żądania wysyłane za pomocą tej metody muszą być autoryzowane przez konto powiązane z właścicielem treści YouTube.

Sponsorzy

Zasób sponsor reprezentuje sponsora kanału w YouTube. Sponsor zapewnia twórcom cykliczne wsparcie finansowe, np. subskrypcję lub opłatę za subskrypcję, i otrzymuje specjalne korzyści. Na przykład sponsorzy mogą rozmawiać na czacie, gdy twórca włączy tryb tylko dla sponsorów.

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

Metoda Żądanie HTTP Opis
Identyfikatory URI względem obiektu https://www.googleapis.com/youtube/v3
list GET /sponsors Wyświetla listę sponsorów kanału. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału.