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.