Zmienia stan transmisji na żywo w YouTube i uruchamia procesy powiązane z nowym stanem. Gdy na przykład zmienisz stan transmisji na testing
, YouTube zacznie przesyłać wideo do strumienia monitorowania tej transmisji. Zanim wywołasz tę metodę, sprawdź, czy wartość właściwości status.streamStatus
strumienia przypisanego do transmisji wynosi active
.
Typowe przypadki użycia
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition
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 | ||
broadcastStatus |
string Parametr broadcastStatus wskazuje stan, w którym zmienia się transmisja. Pamiętaj, że aby można było przenieść transmisję do stanu testing lub live , status.streamStatus musi mieć wartość active dla strumienia, z którym jest powiązana.Akceptowane wartości to:
|
|
id |
string Parametr id określa unikalny identyfikator transmisji, który jest przenoszony do innego stanu. |
|
part |
string Parametr part określa rozdzieloną przecinkami listę co najmniej jednej właściwości zasobu liveBroadcast , która będzie uwzględniona w odpowiedzi interfejsu API. Nazwy parametrów part , które możesz umieszczać w wartościach parametrów, 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
Podczas wywoływania tej metody nie podawaj treści żądania.
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 |
---|---|---|
backendError |
errorExecutingTransition |
Podczas zmiany stanu transmisji wystąpił błąd. |
forbidden (403) |
errorStreamInactive |
Żądane przejście jest niedozwolone, gdy strumień powiązany z transmisją jest nieaktywny. |
forbidden (403) |
invalidTransition |
Nie można zmienić bieżącego stanu transmisji na żądany. |
forbidden (403) |
redundantTransition |
Transmisja na żywo jest już w żądanym stanie lub jest przetwarzana. |
insufficientPermissions |
insufficientLivePermissions |
Prośba nie ma uprawnień do przeniesienia 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. |
notFound (404) |
liveBroadcastNotFound |
Komunikat określony przez parametr id nie istnieje. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
Użytkownik wysłał zbyt wiele żądań w danym okresie. |
required (400) |
idRequired |
Wymagany parametr id musi identyfikować transmisję, której stan chcesz przenieść. |
required (400) |
statusRequired |
Żądanie do interfejsu API musi określać wartość parametru status . |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.