LiveStreams: update

Aktualizuje strumień wideo. Jeśli właściwości, które chcesz zmienić, nie można zaktualizować, musisz utworzyć nowy strumień z odpowiednimi ustawieniami.

Typowe zastosowania

Żądanie

Żądanie HTTP

PUT https://www.googleapis.com/youtube/v3/liveStreams

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 autoryzacji 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
part string
Parametry part służą w tej operacji do dwóch celów. Określa właściwości, które zostaną ustawione przez operację zapisu, a także właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Właściwości part, które możesz uwzględnić w wartości parametru, to id, snippet, cdn i status.

Pamiętaj, że ta metoda zastąpi dotychczasowe wartości wszystkich właściwości, które można zmienić, a które są zawarte w dowolnych częściach określonych przez wartość parametru. Jeśli w ciele żądania nie ma wartości właściwości, która może ulec zmianie, dotychczasowa wartość tej właściwości zostanie usunięta.
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 nimi zarządzają. 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. Dodatkowo żą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

W treści żądania podaj zasób transmisji na żywo. W przypadku tego zasobu:

  • Musisz podać wartość tych właściwości:

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • Możesz ustawić wartości tych właściwości:

    • snippet.title
    • snippet.description

    Jeśli przesyłasz żądanie aktualizacji, a w prośbie nie ma wartości właściwości, która już ma wartość, dotychczasowa wartość właściwości zostanie usunięta.

Odpowiedź

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

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
forbidden (403) liveStreamModificationNotAllowed Nie można zmodyfikować określonej transmisji na żywo w jej obecnym stanie. Więcej informacji znajdziesz w artykule Cykl życia transmisji.
forbidden (403) liveStreamModificationNotAllowed Po utworzeniu strumienia interfejs API nie pozwala zmienić wartości pól cdn.format, cdn.frameRate, cdn.ingestionType ani cdn.resolution.
forbidden (403) liveStreamModificationNotAllowed Interfejs API nie pozwala zmienić strumienia wielokrotnego użytku na niewykorzystywny i odwrotnie. Więcej informacji znajdziesz w artykule Informacje o transmisjach i strumieniowaniu.
insufficientPermissions insufficientLivePermissions Prośba nie jest upoważniona do aktualizowania określonej transmisji na żywo. Więcej informacji znajdziesz w artykule Wdrażanie uwierzytelniania OAuth 2.
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 Wymagania dotyczące funkcji.
invalidValue (400) invalidDescription Wartość właściwości snippet.description w zasobie strumienia na żywo może mieć maksymalnie 10 000 znaków.
invalidValue (400) invalidTitle Wartość właściwości snippet.title w zasobie strumienia na żywo musi zawierać od 1 do 128 znaków.
notFound (404) liveStreamNotFound Wskazana transmisja na żywo nie istnieje.
required (400) idRequired Zasób strumieniowania na żywo musi zawierać wartość właściwości id.
required (400) ingestionTypeRequired Zasób strumieniowania na żywo musi zawierać wartość właściwości cdn.ingestionType.
required (400) titleRequired Zasób strumieniowania na żywo musi zawierać wartość właściwości snippet.title.

Wypróbuj

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