LiveBroadcasts: bind

Powiązuje transmisję w YouTube ze strumieniem lub usuwa istniejące powiązanie między transmisją a strumieniem. Transmisję można powiązać tylko z 1 strumieniem wideo, ale strumień wideo może być powiązany z więcej niż 1 transmisją.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

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 listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
id string
Parametr id określa unikalny identyfikator transmisji, która jest powiązywana ze strumieniem wideo.
part string
Parametr part określa rozdzieloną przecinkami listę co najmniej 1 właściwości zasobu liveBroadcast, które będą uwzględnione w odpowiedzi interfejsu API. Nazwy part części, które możesz uwzględnić w wartości parametru, to id, snippet, contentDetails i status.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie 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ć połączone z określonym właścicielem treści w YouTube.
onBehalfOfContentOwnerChannel string
Ten parametr można używać tylko w prawidłowo autoryzowanym żądaniu. Ten parametr można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

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żna go używać tylko w połączeniu z tym parametrem. Ponadto żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwner. Na koniec kanał określony w wartości parametru onBehalfOfContentOwnerChannel musi być połączony z właścicielem treści określonym w parametrze onBehalfOfContentOwner.

Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie 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.
streamId string
Parametr streamId określa unikalny identyfikator strumienia wideo, który jest powiązywany z transmisją. Jeśli ten parametr zostanie pominięty, interfejs API usunie wszystkie istniejące powiązania między transmisją a strumieniem wideo.

Treść żądania

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

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób 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 dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
backendError internalError Podczas powiązania wystąpił błąd wewnętrzny.
forbidden (403) liveBroadcastBindingNotAllowed Obecny stan transmisji na żywo nie pozwala na powiązanie jej ze strumieniem.
insufficientPermissions insufficientLivePermissions Żądanie nie jest autoryzowane do pobierania określonej transmisji na żywo. Więcej informacji znajdziesz w artykule Implementowanie uwierzytelniania OAuth2.
insufficientPermissions liveStreamingNotEnabled Użytkownik, który autoryzował żądanie, nie ma uprawnień do transmitowania na żywo w YouTube. Więcej informacji znajdziesz na stronie https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound Transmisja określona w parametrze id nie istnieje.
notFound (404) liveStreamNotFound Strumień określony w parametrze 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óra ma zostać powiązana.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.