LiveStreams: update

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

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

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
part string
Parametr part służy w tej operacji do 2 celów. Określa właściwości, które ustawi operacja zapisu, a także właściwości zawarte 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.

Ta metoda zastąpi obecne wartości wszystkich zmiennych, które znajdują się w dowolnych częściach określonych w wartości parametru. Jeśli treść żądania nie określa wartości zmiennej, obecna 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 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

Podaj zasób transmisji na żywo w treści żądania. 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 dla tych właściwości:

    • snippet.title
    • snippet.description

    Jeśli przesyłasz prośbę o aktualizację usługi, która ma już wartość, ale nie jest w niej określona, obecna wartość usługi zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób transmisji na żywo 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
forbidden (403) liveStreamModificationNotAllowed Wybranej transmisji na żywo nie można zmodyfikować w jej obecnym stanie. Więcej informacji znajdziesz w artykule Life of a Broadcast.
forbidden (403) liveStreamModificationNotAllowed Interfejs API nie pozwala na zmianę wartości pól cdn.format, cdn.frameRate, cdn.ingestionType ani cdn.resolution po utworzeniu strumienia.
forbidden (403) liveStreamModificationNotAllowed Interfejs API nie pozwala na zmianę strumienia wielokrotnego użytku na taki, który nie jest wielokrotnego użytku, ani odwrotnie. Więcej informacji znajdziesz w artykule Omówienie transmisji i strumieni.
insufficientPermissions insufficientLivePermissions Żądanie nie ma uprawnień do aktualizacji określonej transmisji na żywo. Więcej informacji znajdziesz w artykule Wdrażanie uwierzytelniania OAuth2.
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.
invalidValue (400) invalidDescription Wartość właściwości snippet.description w zasobie LiveStream może mieć maksymalnie 10 tys. znaków.
invalidValue (400) invalidTitle Wartość właściwości snippet.title w zasobie LiveStream musi mieć od 1 do 128 znaków.
notFound (404) liveStreamNotFound Podana transmisja na żywo nie istnieje.
required (400) idRequired Zasób LiveStream musi określać wartość właściwości id.
required (400) ingestionTypeRequired Zasób LiveStream musi określać wartość właściwości cdn.ingestionType.
required (400) titleRequired Zasób LiveStream musi określać wartość właściwości snippet.title.

Wypróbuj

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