LiveBroadcasts: insert

Interfejs API umożliwia teraz oznaczanie transmisji na żywo jako „przeznaczonych dla dzieci”. Zasób liveBroadcast zawiera teraz właściwość, która określa, czy transmisja na żywo jest „przeznaczona dla dzieci”. 10 stycznia 2020 r. zaktualizowaliśmy również Warunki korzystania z usług YouTube API oraz zasady dla deweloperów. Aby dowiedzieć się więcej, zapoznaj się z historiami zmian usługi YouTube Live Streaming API oraz Warunkami korzystania z usług interfejsu YouTube API.

Tworzy transmisję.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych 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 tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part służy w tej operacji do 2 celów. Określa właściwości, które ustawi operacja zapisu, a także właściwości uwzględnione w odpowiedzi 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
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.
onBehalfOfContentOwnerChannel string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwnerChannel określa identyfikator kanału w YouTube, do którego jest dodawany film. Ten parametr jest wymagany, gdy w żądaniu określona jest wartość parametru onBehalfOfContentOwner i można go używać tylko w połączeniu z tym parametrem. Prośba musi być dodatkowo autoryzowana za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwner. Kanał wskazany za pomocą parametru onBehalfOfContentOwnerChannel musi być połączony z właścicielem treści określonym w parametrze onBehalfOfContentOwner.

Ten parametr jest przeznaczony dla partnerów dostarczających treści do YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Pozwala właścicielom treści jednorazowo uwierzytelnić się i wykonywać działania 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

W treści żądania podaj zasób LiveBroadcast. W przypadku tego zasobu:

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

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

  • Możesz ustawić wartości dla 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 zawiera wszystkie wartości domyślne ustawione dla wymienionych powyżej usług. Wartości domyślne zostaną przypisane w jednym z tych przypadków:
    • Nie podajesz wartości tych właściwości.
    • Wartość parametru part w Twoim żądaniu nie wskazuje części zawierającej te właściwości.

Odpowiedź

Jeśli operacja się uda, 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
insufficientPermissions insufficientLivePermissions Żądanie nie ma uprawnień do utworzenia transmisji na żywo.
insufficientPermissions livePermissionBlocked Użytkownik, który autoryzował żądanie, nie może obecnie transmitować na żywo w YouTube. Szczegółowe informacje o tym, dlaczego użytkownik nie może transmitować 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 uprawnień do transmitowania na żywo w YouTube. Więcej informacji może znaleźć na stronie https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości contentDetails.enableAutoStart. Nie wszystkie transmisje obsługują to ustawienie.
invalidValue (400) invalidAutoStop Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości contentDetails.enableAutoStop. Nie można zmienić ustawienia enableAutoStop dla trwałej transmisji.
invalidValue (400) invalidDescription W zasobie liveBroadcast nie określono prawidłowej wartości właściwości snippet.description. Wartość właściwości może mieć do 5000 znaków.
invalidValue (400) invalidEmbedSetting Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości contentDetails.enable_embed. Nie można umieścić tej transmisji.
invalidValue (400) invalidLatencyPreferenceOptions Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości contentDetails.latencyPreference. Nie wszystkie ustawienia są obsługiwane przy takim ustawieniu opóźnienia.
invalidValue (400) invalidPrivacyStatus Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości status.privacy_status.
invalidValue (400) invalidProjection Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości contentDetails.projection. Domyślna projekcja transmisji nie może być ustawiona na 360.
invalidValue (400) invalidScheduledEndTime Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości snippet.scheduledEndTime. Zaplanowana godzina zakończenia musi być późniejsza niż zaplanowana godzina rozpoczęcia.
invalidValue (400) invalidScheduledStartTime Zasób LiveBroadcast zawierał nieprawidłową wartość we właściwości snippet.scheduledStartTime. Zaplanowana godzina rozpoczęcia musi przypadać w przyszłości i na tyle blisko bieżącej, aby można było skutecznie zaplanować transmisję na ten czas.
invalidValue (400) invalidTitle W zasobie liveBroadcast nie określono 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 transmisji i musi niektóre z nich zatrzymać lub usunąć.
rateLimitExceeded userRequestsExceedRateLimit Użytkownik wysłał zbyt wiele żądań w danym okresie.
required (400) privacyStatusRequired Zasób LiveBroadcast musi określać stan prywatności. Zobacz prawidłowe wartości parametru 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 interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.