LiveStreams: update

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

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
part string
Parametr part spełnia 2 cele w tej operacji. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie zawierać odpowiedź interfejsu API.

Właściwości part, które można uwzględnić w wartościach parametrów: id, snippet, cdn i status.

Pamiętaj, że ta metoda zastąpi istniejące wartości dla wszystkich właściwości zmiennych w dowolnych częściach określonych w wartościach parametru. Jeśli treść żądania nie określa wartości właściwości zmiennej, obecna wartość tej właściwości zostanie usunięta.
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.

Treść żądania

Treść transmisji na żywo w treści żądania. Dla tego zasobu:

  • Musisz określić 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 prośbę o aktualizację, ale nie określa ona wartości właściwości, która już ma wartość, 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 informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) liveStreamModificationNotAllowed Określonej transmisji na żywo nie można zmienić w jej obecnym stanie. Więcej informacji na ten temat znajdziesz na stronie Życie transmisji.
forbidden (403) liveStreamModificationNotAllowed Interfejs API nie pozwala zmieniać wartości pól cdn.format, cdn.frameRate, cdn.ingestionType ani cdn.resolution po utworzeniu strumienia.
forbidden (403) liveStreamModificationNotAllowed Interfejs API nie umożliwia zmiany strumienia wielokrotnego użytku na inny lub odwrotnie. Więcej informacji znajdziesz w artykule Omówienie transmisji i strumieni.
insufficientPermissions insufficientLivePermissions Prośba nie ma uprawnień do aktualizowania 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.
invalidValue (400) invalidDescription Wartość właściwości snippet.description w zasobie Livestream może mieć maksymalnie 10 000 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 mieć określoną wartość właściwości id.
required (400) ingestionTypeRequired Zasób LiveStream musi mieć określoną wartość właściwości cdn.ingestionType.
required (400) titleRequired Zasób LiveStream musi mieć określoną wartość właściwości snippet.title.

Wypróbuj

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