LiveStreams: insert

Tworzy strumień wideo. Strumień umożliwia wysyłanie filmu do YouTube, który może go następnie transmitować do odbiorców.

Częste zastosowania

Żądanie

Żądanie HTTP

POST 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).

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
W tej operacji parametr part pełni 2 funkcje. Określa właściwości, które zostaną ustawione przez operację zapisu, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Wartość parametru part może zawierać te właściwości: id, snippet, cdn, contentDetails i status.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzację żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Parametr `**onBehalfOfContentOwner**` wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu zarządzania treścią YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Umożliwia to właścicielom treści jednokrotne uwierzytelnienie i uzyskanie dostępu do wszystkich danych wideo i danych kanału bez konieczności podawania danych uwierzytelniających dla każdego pojedynczego kanału. Konto CMS, za pomocą którego uwierzytelnia się użytkownik, 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 prawidłowo autoryzowanym żądaniu. `string` Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów 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. Ponadto żądanie musi być autoryzowane przy użyciu konta CMS, które jest połączone z właścicielem treści określonym przez parametr onBehalfOfContentOwner. Ponadto żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwnerChannel.onBehalfOfContentOwner

Umożliwia to właścicielom treści jednokrotne 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 oddzielnego kanału.

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.

Treść żądania zawiera zasób liveStream. W treści żądania podaj zasób liveStream.

  • W przypadku tego zasobu:

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

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

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

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

Jeśli operacja się powiedzie, ta metoda zwraca zasób liveStream w treści odpowiedzi.

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób 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 dokumentacji komunikatów o błędach. Typ błędu Szczegóły błędu
insufficientPermissions insufficientLivePermissions Żądanie nie jest autoryzowane do utworzenia określonej transmisji na żywo.
insufficientPermissions livePermissionBlocked Żądanie nie jest autoryzowane do utworzenia określonego strumienia na żywo. Szczegółowe informacje o przyczynach, dla których użytkownik nie może przesyłać strumieniowo transmisji na żywo, mogą być dostępne w ustawieniach kanału użytkownika pod adresem https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Szczegóły wyjaśniające, dlaczego użytkownik nie może przesyłać strumieniowo filmów na żywo, mogą być dostępne w ustawieniach kanału użytkownika na stronie https://www.youtube.com/features. Użytkownik, który autoryzował żądanie, nie ma włączonej możliwości przesyłania strumieniowego filmów na żywo w YouTube. Więcej informacji można znaleźć pod adresem https://www.youtube.com/features.
invalidValue (400) invalidDescription Wartość właściwości snippet.description w zasobie liveStream może mieć do 10000 znaków.
invalidValue (400) invalidFormat Wartość właściwości cdn.format w zasobie liveStream jest nieprawidłowa.
invalidValue (400) invalidFrameRate Wartość właściwości cdn.frameRate w zasobie liveStream jest nieprawidłowa.
invalidValue (400) invalidIngestionType Wartość właściwości cdn.ingestionType w zasobie liveStream jest nieprawidłowa.
invalidValue (400) invalidResolution Wartość właściwości cdn.resolution w zasobie liveStream jest nieprawidłowa.
invalidValue (400) invalidTitle Wartość właściwości snippet.title w zasobie liveStream musi mieć od 1 do 128 znaków.
rateLimitExceeded userRequestsExceedRateLimit Wartość właściwości `snippet.title` w zasobie `liveStream` musi mieć od 1 do 128 znaków.
required (400) cdnRequired Zasób liveStream musi zawierać obiekt cdn.
required (400) frameRateRequired Interfejs API zwraca ten błąd, jeśli określisz wartość właściwości cdn.resolution, ale nie właściwości cdn.frameRate.
required (400) ingestionTypeRequired Zasób liveStream musi określać wartość właściwości cdn.ingestionType>.
required (400) resolutionRequired Interfejs API zwraca ten błąd, jeśli określisz wartość właściwości cdn.frameRate, ale nie właściwości cdn.resolution.
required (400) titleRequired Zasób liveStream musi określać wartość właściwości snippet.title.

Zasób `liveStream` musi zawierać wartość właściwości `snippet.title`.

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