LiveBroadcasts: insert

Interfejs API obsługuje teraz możliwość oznaczania transmisji na żywo jako „przeznaczonych dla dzieci”, a zasób liveBroadcast zawiera teraz właściwość, która określa stan tych transmisji na żywo. Warunki korzystania z usług YouTube oraz zasady dla deweloperów zostały zaktualizowane 10 stycznia 2020 r. Aby uzyskać więcej informacji, zapoznaj się z historiami zmian usługi YouTube Live Streaming API i Warunków korzystania z usług interfejsu API YouTube.

Tworzy transmisję.

Typowe przypadki użycia

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part spełnia 2 cele w tej operacji. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie uwzględniać odpowiedź interfejsu API.

Właściwości part, które możesz uwzględnić w wartości parametru, to id, snippet, contentDetails i status.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelni, musi być połączone z określonym właścicielem treści w YouTube.
onBehalfOfContentOwnerChannel string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Tego parametru można używać tylko w odpowiednim autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony tylko dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwnerChannel określa identyfikator kanału YouTube, do którego jest dodawany film. Ten parametr jest wymagany, gdy żądanie określa wartość parametru onBehalfOfContentOwner i można go używać tylko w połączeniu z tym parametrem. Dodatkowo żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści, które jest określone w parametrze onBehalfOfContentOwner. Na koniec kanał, który określa parametr onBehalfOfContentOwnerChannel, musi być powiązany z właścicielem treści, który jest określony przez parametr onBehalfOfContentOwner.

Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie raz i wykonywanie działań w imieniu kanału określonego w wartości parametru, bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna.

Treść żądania

Podaj zasób LiveBroadcast w treści żądania. Dla tego zasobu:

  • Musisz określić wartość tych właściwości:

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

  • Możesz ustawić wartości tych właściwości:

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart

    Uwaga: tabela usług dokumentuje wszelkie wartości domyślne ustawione dla wymienionych powyżej właściwości. Wartości domyślne zostaną przypisane w jednym z tych przypadków:
    • Nie musisz określać wartości tych właściwości.
    • Wartość parametru part w żądaniu nie określa części zawierającej te właściwości.

Odpowiedź

Jeśli operacja się powiedzie, metoda zwróci zasób LiveBroadcast w treści odpowiedzi.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
insufficientPermissions insufficientLivePermissions Prośba nie ma uprawnień do utworzenia transmisji na żywo.
insufficientPermissions livePermissionBlocked Użytkownik, który autoryzował żądanie, nie może obecnie transmitować na żywo filmów w YouTube. Szczegóły wyjaśniające, dlaczego użytkownik nie może strumieniować filmów na żywo, mogą być dostępne w ustawieniach kanału użytkownika na stronie https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Użytkownik, który autoryzował żądanie, nie ma dostępu do transmisji na żywo w YouTube. Więcej informacji użytkownik może znaleźć na stronie https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości contentDetails.enableAutoStart. Nie wszystkie transmisje obsługują to ustawienie.
invalidValue (400) invalidAutoStop Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości contentDetails.enableAutoStop. Nie można zmienić ustawienia enableAutoStop dotyczącego trwałej transmisji.
invalidValue (400) invalidDescription Zasób LiveBroadcast nie określił prawidłowej wartości właściwości snippet.description. Wartość właściwości może zawierać maksymalnie 5000 znaków.
invalidValue (400) invalidEmbedSetting Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości contentDetails.enable_embed. Nie możesz umieścić tej transmisji.
invalidValue (400) invalidLatencyPreferenceOptions Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości contentDetails.latencyPreference. Nie wszystkie ustawienia są obsługiwane w przypadku tego ustawienia czasu oczekiwania.
invalidValue (400) invalidPrivacyStatus Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości status.privacy_status.
invalidValue (400) invalidProjection Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości contentDetails.projection. Prognoza domyślna transmisji nie może być ustawiona na 360.
invalidValue (400) invalidScheduledEndTime Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości snippet.scheduledEndTime. Planowany czas zakończenia musi być zgodny z zaplanowanym czasem rozpoczęcia.
invalidValue (400) invalidScheduledStartTime Zasób LiveBroadcast zawiera nieprawidłową wartość właściwości snippet.scheduledStartTime. Planowana godzina rozpoczęcia musi przypadać w przyszłości i być wystarczająco zbliżona do aktualnej daty, w której można zaplanować transmisję na ten czas.
invalidValue (400) invalidTitle Zasób LiveBroadcast nie określił prawidłowej wartości właściwości snippet.title. Wartość właściwości musi mieć od 1 do 100 znaków.
limitExceeded userBroadcastsExceedLimit Użytkownik utworzył zbyt wiele transmisji na żywo lub zaplanowanych i musi zatrzymać lub usunąć niektóre z nich.
rateLimitExceeded userRequestsExceedRateLimit Użytkownik wysłał zbyt wiele żądań w danym okresie.
required (400) privacyStatusRequired Zasób LiveBroadcast musi mieć określony stan prywatności. Sprawdź prawidłowe wartości privacyStatus.
required (400) scheduledEndTimeRequired Zasób LiveBroadcast musi określać właściwość snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired Zasób LiveBroadcast musi określać właściwość snippet.scheduledStartTime.
required (400) titleRequired Zasób LiveBroadcast musi określać właściwość snippet.title.

Wypróbuj

Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.