LiveBroadcasts: transition

Zmienia stan transmisji na żywo w YouTube i inicjuje związane z nim procesy. Jeśli na przykład zmienisz stan transmisji na testing, YouTube zacznie przesyłać wideo do strumienia monitorowania tej transmisji. Przed wywołaniem tej metody upewnij się, że wartość właściwości status.streamStatus strumienia powiązanego z transmisją wynosi active.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

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
broadcastStatus string
Parametr broadcastStatus wskazuje stan, na który zmienia się transmisja. Pamiętaj, że aby zmienić stan transmisji na testing lub live, parametr status.streamStatus musi wynosić active dla strumienia, z którym jest powiązana transmisja.

Akceptowane 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 transmisji.
  • testing – rozpocznij testowanie transmisji. YouTube przesyła obraz do strumienia monitorowania transmisji. Pamiętaj, że transmisję do stanu testing możesz przenieść tylko wtedy, gdy jej właściwość contentDetails.monitorStream.enableMonitorStream jest ustawiona na true.
id string
Parametr id określa unikalny identyfikator transmisji, której stan się zmienia.
part string
Parametr part określa rozdzieloną przecinkami listę właściwości zasobu liveBroadcast, która będzie zawarta w odpowiedzi interfejsu API. Nazwy elementu 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

Nie podawaj treści żądania podczas wywoływania tej metody.

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
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 zmienić jej obecnego stanu na żądany.
forbidden (403) redundantTransition Transmisja na żywo ma już żądany stan lub jest przetwarzana do żądanego stanu.
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 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.
notFound (404) liveBroadcastNotFound Transmisja określona 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 wskazywać transmisję, której stan chcesz zmienić.
required (400) statusRequired Żądanie do interfejsu API musi określać wartość parametru status.

Wypróbuj

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