LiveBroadcasts: insert

Interfejs API obsługuje teraz oznaczanie transmisji na żywo jako „przeznaczone dla dzieci”, a zasób liveBroadcast zawiera właściwość, która określa stan „przeznaczone dla dzieci” danej transmisji na żywo. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług YouTube API i Zasady dla deweloperów. Więcej informacji znajdziesz w historii zmian dotyczących usługi YouTube Live Streaming API i Warunków korzystania z usług YouTube API.

Tworzy transmisję.

Częste zastosowania

Żądanie

Żądanie HTTP

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

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 Parametr part pełni w tej operacji 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ściami parametru part, które możesz uwzględnić, są id, snippet, 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ą w 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 dotyczących ich filmów i kanałów 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. 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. onBehalfOfContentOwnerChannelPonadto żądanie musi być autoryzowane za pomocą konta CMS powiązanego z właścicielem treści określonym w parametrze 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.

Treść żądania

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

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

  • snippet.title
  • snippet.scheduledStartTime
  • status.privacyStatus

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

  • snippet.title
  • snippet.description
  • snippet.categoryId
  • snippet.scheduledStartTime
  • snippet.scheduledEndTime
  • status.privacyStatus
  • status.selfDeclaredMadeForKids
  • contentDetails.monitorStream.enableMonitorStream
  • contentDetails.monitorStream.broadcastStreamDelayMs
  • contentDetails.enableAutoStart
  • contentDetails.enableAutoStop
  • contentDetails.enableClosedCaptions
  • contentDetails.enableDvr
  • contentDetails.enableEmbed
  • contentDetails.recordFromStart
  • contentDetails.availabilityConfig
  Uwaga: w tabeli właściwości znajdziesz informacje o wartościach domyślnych ustawionych dla wymienionych właściwości. Wartości domyślne zostaną przypisane w jednym z tych przypadków:
  

  • Nie określisz wartości tych właściwości.
  • Wartość parametru part w żądaniu nie określa części, która zawiera te właściwości.

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
insufficientPermissions	insufficientLivePermissions	Żądanie nie jest autoryzowane do utworzenia transmisji na żywo.
insufficientPermissions	livePermissionBlocked	Użytkownik, który autoryzował żądanie, nie może obecnie przesyłać transmisji na żywo w YouTube. Szczegóły wyjaśniające, dlaczego użytkownik nie może przesyłać strumieniowo transmisji na żywo, mogą być dostępne w ustawieniach kanału użytkownika na stronie https://www.youtube.com/features.
insufficientPermissions	liveStreamingNotEnabled	Użytkownik, który autoryzował żądanie, nie ma włączonej możliwości przesyłania transmisji na żywo w YouTube. Więcej informacji znajdziesz na stronie https://www.youtube.com/features.
invalidValue (400)	invalidAutoStart	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości contentDetails.enableAutoStart. Nie wszystkie transmisje obsługują to ustawienie.
invalidValue (400)	invalidAutoStop	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości contentDetails.enableAutoStop. Nie możesz zmienić ustawienia enableAutoStop w przypadku transmisji ciągłej.
invalidValue (400)	invalidDescription	Zasób liveBroadcast nie zawierał prawidłowej wartości właściwości snippet.description. Wartość właściwości może zawierać maksymalnie 5000 znaków.
invalidValue (400)	invalidEmbedSetting	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości contentDetails.enable_embed. Nie możesz osadzić tej transmisji.
invalidValue (400)	invalidLatencyPreferenceOptions	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości contentDetails.latencyPreference. Nie wszystkie ustawienia są obsługiwane w przypadku tego ustawienia opóźnienia.
invalidValue (400)	invalidPrivacyStatus	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości status.privacy_status.
invalidValue (400)	invalidProjection	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości contentDetails.projection. Projekcji domyślnej transmisji nie można ustawić na 360.
invalidValue (400)	invalidScheduledEndTime	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości snippet.scheduledEndTime. Zaplanowana godzina zakończenia musi być późniejsza niż zaplanowana godzina rozpoczęcia.
invalidValue (400)	invalidScheduledStartTime	Zasób liveBroadcast zawierał nieprawidłową wartość właściwości snippet.scheduledStartTime. Zaplanowana godzina rozpoczęcia musi przypadać w przyszłości i być na tyle blisko bieżącej daty, aby można było niezawodnie zaplanować transmisję na tę godzinę.
invalidValue (400)	invalidTitle	Zasób liveBroadcast nie zawierał prawidłowej wartości właściwości snippet.title. Wartość właściwości musi mieć od 1 do 100 znaków.
limitExceeded	userBroadcastsExceedLimit	Użytkownik utworzył zbyt wiele transmisji na żywo lub zaplanowanych i musi zatrzymać lub usunąć niektóre z nich.
rateLimitExceeded	userRequestsExceedRateLimit	Użytkownik wysłał zbyt wiele żądań w danym okresie.
required (400)	privacyStatusRequired	Zasób liveBroadcast musi określać stan prywatności. Zobacz prawidłowe wartości privacyStatus.
required (400)	scheduledEndTimeRequired	Zasób liveBroadcast musi określać właściwość snippet.scheduledEndTime.
required (400)	scheduledStartTimeRequired	Zasób liveBroadcast musi określać właściwość snippet.scheduledStartTime.
required (400)	titleRequired	Zasób liveBroadcast musi określać właściwość snippet.title.

Wypróbuj

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