LiveBroadcasts: transition

Zmienia stan transmisji na żywo w YouTube i inicjuje wszelkie procesy związane z nowym stanem. Gdy na przykład zmienisz stan transmisji na testing, YouTube zacznie przesyłać film do strumienia monitorowania tej transmisji. Przed wywołaniem tej metody musisz potwierdzić, że wartość właściwości status.streamStatus dla strumienia powiązanego z Twoim przekazem wynosi active.

Typowe zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzacji znajdziesz w artykule Wdrażanie uwierzytelniania OAuth 2.0.

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

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
broadcastStatus string
Parametr broadcastStatus określa stan, do którego zmienia się transmisja. Pamiętaj, że aby przełączyć transmisję do stanu testing lub live, musisz ustawić wartość parametru status.streamStatus na active w przypadku strumienia, do którego jest ona powiązana.

Dopuszczalne wartości to:
  • complete – transmisja została zakończona. YouTube przestaje przesyłać film.
  • live – transmisja jest widoczna dla odbiorców. YouTube przesyła film do strumienia monitorowania i strumienia transmisji.
  • testing – rozpocznij testowanie transmisji. YouTube przesyła film do strumienia monitorowania transmisji. Pamiętaj, że transmisję możesz przełączyć w stan testing tylko wtedy, gdy jej właściwość contentDetails.monitorStream.enableMonitorStream ma wartość true.
id string
Parametr id określa unikalny identyfikator transmisji, która przechodzi do innego stanu.
part string
Parametry part określają listę oddzielonych przecinkami co najmniej 1 właściwości zasobu liveBroadcast, które będą uwzględnione w odpowiedzi interfejsu API. Nazwy 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 partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzacji żądania identyfikują użytkownika systemu CMS 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 treści w YouTube, którzy są właścicielami wielu kanałów YouTube i zarządzają nimi. Umożliwia ona właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube.
onBehalfOfContentOwnerChannel string
Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu.

Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści YouTube.

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

Ten parametr jest przeznaczony dla partnerów treści w YouTube, którzy są właścicielami wielu kanałów YouTube i nimi zarządzają. Umożliwia właścicielom treści jednorazowe uwierzytelnianie się i wykonywanie działań w imieniu kanału określonego w wartości parametru bez konieczności podawania danych uwierzytelniających dla każdego osobnego kanału.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się powiedzie, zwróci ona w treści odpowiedzi zasob liveBroadcast.

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 artykule Błędy interfejsu YouTube Live Streaming API.

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 Transmisja na żywo nie może przejść z obecnego stanu do stanu żądanego.
forbidden (403) redundantTransition Transmisja na żywo jest już w stanie Requested (Prośba) lub jest przetwarzana do tego stanu.
insufficientPermissions insufficientLivePermissions Prośba nie jest autoryzowana do przeniesienia transmisji na żywo.
insufficientPermissions livePermissionBlocked Użytkownik, który zatwierdził prośbę, nie może obecnie transmitować strumieniowo filmów na żywo w YouTube. Szczegółowe informacje o tym, dlaczego użytkownik nie może prowadzić transmisji na żywo, znajdziesz w ustawieniach jego kanału w sekcji Dostępność funkcji.
insufficientPermissions liveStreamingNotEnabled Użytkownik, który zatwierdził prośbę, nie ma uprawnień do transmisji wideo na żywo w YouTube. Więcej informacji znajdziesz w sekcji Kryteria uczestnictwa w przypadku funkcji.
notFound (404) liveBroadcastNotFound Transmisja określona przez parametr id nie istnieje.
rateLimitExceeded (403) userRequestsExceedRateLimit Użytkownik wysłał zbyt wiele żądań w danym przedziale czasu.
required (400) idRequired Wymagany parametr id musi identyfikować transmisję, której stan chcesz zmienić.
required (400) statusRequired Żądanie interfejsu API musi zawierać wartość parametru status.

Wypróbuj

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