LiveBroadcasts: bind

Łączy transmisję w YouTube z transmisją lub usuwa istniejące powiązanie między transmisją. Transmisja może być powiązana tylko z 1 strumieniem wideo, chociaż może być powiązana z więcej niż 1 strumieniem wideo.

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

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
id string
Parametr id określa unikalny identyfikator transmisji, który jest powiązany ze strumieniem wideo.
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.
streamId string
Parametr streamId określa unikalny identyfikator strumienia wideo, który jest powiązany z transmisją. Jeśli pominiesz ten parametr, interfejs API usunie wszystkie wiązania między transmisją a strumieniem wideo.

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 internalError Podczas tworzenia powiązania wystąpił błąd wewnętrzny.
forbidden (403) liveBroadcastBindingNotAllowed Obecny stan transmisji na żywo nie pozwala na powiązanie jej z transmisją.
insufficientPermissions insufficientLivePermissions Żądanie nie ma uprawnień do pobrania określonej transmisji na żywo. Więcej informacji znajdziesz w artykule Implementacja uwierzytelniania OAuth2.
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.
notFound (404) liveStreamNotFound Strumień określony przez parametr streamId nie istnieje.
rateLimitExceeded userRequestsExceedRateLimit Użytkownik wysłał zbyt wiele żądań w danym okresie.
required (400) idRequired Wymagany parametr id musi identyfikować transmisję, którą chcesz powiązać.

Wypróbuj

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