YouTube Data API - Errors
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W tym dokumencie opisujemy różne typy błędów, które mogą być zwracane przez operacje YouTube Data API. Listę błędów dla poszczególnych metod znajdziesz też w dokumentacji referencyjnej dotyczącej danej metody.
Ogólne błędy
W tabelach poniżej znajdziesz komunikaty o błędach interfejsu API, które nie są specyficzne dla konkretnej metody interfejsu API.
Core API errors
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
quotaExceeded (403)
quotaExceeded
Nie można zrealizować żądania, ponieważ został przekroczony limit.
Common request errors
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
incompatibleParameters
Żądanie zawiera co najmniej 2 parametry, których nie można użyć w tym samym żądaniu.
badRequest (400)
invalidFilters
Żądanie zawiera nieprawidłowy parametr filtra.
badRequest (400)
invalidPageToken
Żądanie określa nieprawidłowy token strony.
badRequest (400)
missingRequiredParameter
W żądaniu brakuje wymaganego parametru.
badRequest (400)
unexpectedParameter
Żądanie zawiera nieoczekiwany parametr.
forbidden (403)
accountDelegationForbidden
Uwierzytelniony użytkownik nie może działać w imieniu określonego konta Google.
forbidden (403)
authenticatedUserAccountClosed
Konto YouTube uwierzytelnionego użytkownika jest zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd dotyczy tego konta.
forbidden (403)
authenticatedUserAccountSuspended
Konto YouTube uwierzytelnionego użytkownika jest zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd dotyczy tego konta.
forbidden (403)
authenticatedUserNotChannel
W przypadku tego żądania uwierzytelniony użytkownik musi być powiązany z kanałem, ale nie jest. Jeśli Twoje żądanie jest uwierzytelnione i używa parametru delegowania onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel.
forbidden (403)
channelClosed
Kanał zidentyfikowany w żądaniu został zamknięty.
forbidden (403)
channelNotFound
Nie udało się znaleźć kanału wskazanego w prośbie.
forbidden (403)
channelSuspended
Kanał zidentyfikowany w żądaniu został zawieszony.
forbidden (403)
cmsUserAccountNotFound
Użytkownik CMS nie może działać w imieniu określonego właściciela treści.
forbidden (403)
insufficientCapabilities
Użytkownik CMS ma niewystarczające uprawnienia.
forbidden (403)
insufficientPermissions
Token OAuth 2.0 podany w żądaniu określa zakresy, które są niewystarczające do uzyskania dostępu do żądanych danych.
notFound (404)
contentOwnerAccountNotFound
Nie znaleziono podanego konta właściciela treści.
Request context errors
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
invalidLanguage
Wartość parametru hl nie określa prawidłowego kodu języka.
badRequest (400)
invalidMine
Użycie parametru mine w żądaniu nie jest obsługiwane.
badRequest (400)
invalidMine
Parametru mine nie można używać w przypadku żądań, w których uwierzytelniony użytkownik jest partnerem YouTube. Usuń parametr mine, uwierzytelnij się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działaj jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest dostępny dla wywoływanej metody.
badRequest (400)
invalidPart
Parametr part żądania określa części, których nie można zapisywać w tym samym czasie.
badRequest (400)
invalidRegionCode
Parametr regionCode określa nieprawidłowy kod regionu.
badRequest (400)
unexpectedPart
Parametr part w żądaniu określa nieoczekiwaną wartość.
badRequest (400)
unknownPart
Parametr part w żądaniu określa nieznaną wartość.
badRequest (400)
unsupportedLanguageCode
Wartość parametru hl nie określa obsługiwanego kodu języka.
badRequest (400)
unsupportedRegionCode
Parametr regionCode określa nieobsługiwany kod regionu.
unauthorized (401)
authorizationRequired
Żądanie używa parametru mine, ale nie jest prawidłowo autoryzowane.
unauthorized (401)
youtubeSignupRequired
Ten błąd oznacza, że użytkownik ma niepołączone konto Google, czyli konto Google, ale nie ma kanału YouTube. Tacy użytkownicy mogą korzystać z wielu funkcji, które wymagają autoryzacji, np. oceniać filmy czy dodawać je do watch_later playlisty. Aby na przykład przesłać film, użytkownik musi mieć kanał w YouTube. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, na pewno ma konto Google, ale nie musi mieć jeszcze połączonego konta Google z kanałem w YouTube.
Ten błąd często występuje, gdy próbujesz użyć procesu konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi. Jeśli spróbujesz uwierzytelnić się za pomocą konta usługi, pojawi się ten błąd.
W artykule na blogu interfejsu API YouTube, w którym przedstawiamy obsługę kont Google, omawiamy też youtubeSignupRequiredten błądyoutubeSignupRequired bardziej szczegółowo. Chociaż post na blogu wyjaśnia błąd w przypadku wersji 2.1 interfejsu API, znaczenie tego błędu jest nadal aktualne.
aktywności
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami activities. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
activities.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
homeParameterDeprecated
Dane o aktywności użytkownika na stronie głównej nie są dostępne w tym interfejsie API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na true.
forbidden (403)
forbidden
Żądanie nie jest odpowiednio autoryzowane.
notFound (404)
channelNotFound
Nie znaleziono identyfikatora kanału określonego przez parametr channelId w żądaniu.
notFound (404)
homeChannelNotFound
Nie udało się znaleźć kanału na stronie głównej YouTube dla aktualnie uwierzytelnionego użytkownika.
unauthorized (401)
authorizationRequired
Żądanie używa parametru home, ale nie jest prawidłowo autoryzowane.
napisy
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami captions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
captions.delete
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Uprawnienia powiązane z żądaniem nie są wystarczające do usunięcia ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
captionNotFound
Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
captions.download
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Uprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
invalidValue (400)
couldNotConvert
Nie udało się przekonwertować danych ścieżki z napisami na żądany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe, a wartość snippet.status żądanej ścieżki z napisami nie jest równa failed.
notFound (404)
captionNotFound
Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
captions.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
contentRequired
Żądanie nie zawiera treści ścieżki z napisami.
conflict (409)
captionExists
Określony film ma już ścieżkę z napisami o podanym snippet.language i snippet.name. Film może mieć wiele ścieżek w tym samym języku, ale każda ścieżka musi mieć inną nazwę.
Istnieje kilka sposobów rozwiązania tego problemu. Możesz usunąć istniejącą ścieżkę, a potem wstawić nową lub zmienić nazwę nowej ścieżki przed jej wstawieniem.
forbidden (403)
forbidden
Uprawnienia powiązane z żądaniem nie są wystarczające do przesłania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
invalidValue (400)
invalidMetadata
Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie ścieżki. Sprawdź, czy w żądaniu podano prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Możesz też uwzględnić właściwość snippet.isDraft, ale nie jest to wymagane.
notFound (404)
videoNotFound
Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
invalidValue (400)
nameTooLong
Wskazany w żądaniu parametr snippet.name jest za długi. Maksymalna długość to 150 znaków.
captions.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Nie udało się pobrać co najmniej 1 ścieżki napisów, ponieważ uprawnienia powiązane z żądaniem są niewystarczające do pobrania żądanych zasobów. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
captionNotFound
Nie udało się znaleźć co najmniej 1 z podanych ścieżek z napisami. Ten błąd występuje, jeśli parametr videoId wskazuje rzeczywisty film, ale parametr id wskazuje identyfikatory ścieżek z napisami, które nie istnieją, lub identyfikatory ścieżek powiązane z innymi filmami. Sprawdź wartości parametrów id i videoId żądania, aby upewnić się, że są prawidłowe.
notFound (404)
videoNotFound
Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
captions.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
contentRequired
W ramach prośby nie przesłano zaktualizowanego pliku z napisami. Rzeczywista zawartość ścieżki jest wymagana, jeśli parametr sync ma wartość true.
forbidden (403)
forbidden
Uprawnienia powiązane z żądaniem nie są wystarczające do zaktualizowania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
captionNotFound
Nie udało się znaleźć podanej ścieżki z napisami. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
channelBanners
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channelBanners. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channelBanners.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
bannerAlbumFull
Album Grafika kanału na YouTube zawiera za dużo obrazów. Wejdź na http://photos.google.com, otwórz stronę albumów i usuń z albumu kilka zdjęć.
badRequest (400)
mediaBodyRequired
Żądanie nie zawiera treści obrazu.
channelSections
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channelSections. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channelSections.delete
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
notEditable
Tej sekcji kanału nie można usunąć.
forbidden (403)
channelSectionForbidden
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400)
idInvalid
Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)
idRequired
Właściwość id musi zawierać wartość, która identyfikuje usuwaną sekcję kanału.
notFound (404)
channelNotFound
Nie znaleziono kanału.
notFound (404)
channelSectionNotFound
Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
channelSections.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSetError
Aby wstawić lub zaktualizować obiekt localizations w przypadku zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400)
invalidLanguage
Jeden z kluczy języka w obiekcie localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
notEditable
Nie można utworzyć tej sekcji kanału.
badRequest (400)
styleRequired
Zasób channelSection musi zawierać wartość w polu snippet.style.
badRequest (400)
targetInvalidCountry
Weryfikacja jednej z wartości na liście targeting.countries zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
targetInvalidLanguage
Weryfikacja jednej z wartości na liście targeting.languages zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
targetInvalidRegion
Weryfikacja jednej z wartości na liście targeting.regions zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
typeRequired
Zasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403)
channelSectionForbidden
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400)
channelNotActive
Co najmniej 1 z określonych kanałów jest nieaktywny.
invalidValue (400)
channelsDuplicated
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400)
channelsNeeded
Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał.
invalidValue (400)
channelsNotExpected
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie oczekuje się kanałów.
invalidValue (400)
contentDetailsNeeded
W przypadku tego typu sekcji kanału wstawiany zasób musi zawierać obiekt contentDetails.
invalidValue (400)
inValidPosition
Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400)
maxChannelSectionExceeded
Nie można zrealizować prośby, ponieważ kanał zawiera już maksymalną liczbę sekcji kanału.
invalidValue (400)
maxChannelsExceeded
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanałów.
invalidValue (400)
maxPlaylistExceeded
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist.
invalidValue (400)
onePlaylistNeeded
Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę.
invalidValue (400)
ownChannelInChannels
Nie możesz dodać własnego kanału do sekcji kanału, która pojawia się na tym kanale.
invalidValue (400)
playlistIsPrivate
Co najmniej 1 z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału.
invalidValue (400)
playlistsDuplicated
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty.
invalidValue (400)
playlistsNeeded
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy określić właściwość contentDetails.playlists[].
invalidValue (400)
playlistsNotExpected
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania.
invalidValue (400)
snippetNeeded
Aby utworzyć sekcję kanału, musisz określić snippet.
invalidValue (400)
titleLengthExceeded
Wartość usługi snippet.title jest za długa.
invalidValue (400)
titleRequired
Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404)
channelNotFound
Nie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404)
playlistNotFound
Nie udało się znaleźć co najmniej jednej z podanych playlist.
channelSections.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
channelSectionForbidden
Osoba wysyłająca żądanie nie ma uprawnień dostępu do żądanych sekcji kanału.
invalidValue (400)
idInvalid
Żądanie określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)
invalidCriteria
Nie udało się zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe.
notFound (404)
channelNotFound
Nie można znaleźć kanału powiązanego z żądaniem.
notFound (404)
channelSectionNotFound
Nie udało się znaleźć sekcji kanału powiązanej z żądaniem.
channelSections.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSetError
Aby wstawić lub zaktualizować obiekt localizations w przypadku zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400)
invalidLanguage
Jeden z kluczy języka w obiekcie localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
notEditable
Tej sekcji kanału nie można edytować.
badRequest (400)
styleRequired
Zasób channelSection musi zawierać wartość w polu snippet.style.
badRequest (400)
targetInvalidCountry
Weryfikacja jednej z wartości na liście targeting.countries zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
targetInvalidLanguage
Weryfikacja jednej z wartości na liście targeting.languages zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
targetInvalidRegion
Weryfikacja jednej z wartości na liście targeting.regions zakończyła się niepowodzeniem. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400)
typeRequired
Zasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403)
channelSectionForbidden
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400)
channelNotActive
Co najmniej 1 z określonych kanałów jest nieaktywny.
invalidValue (400)
channelsDuplicated
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400)
channelsNeeded
Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał.
invalidValue (400)
channelsNotExpected
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie oczekuje się kanałów.
invalidValue (400)
contentDetailsNeeded
Aktualizowany zasób musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400)
idInvalid
Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)
idRequired
Właściwość id musi określać wartość, która identyfikuje aktualizowaną sekcję kanału.
invalidValue (400)
inValidPosition
Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400)
maxChannelsExceeded
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanałów.
invalidValue (400)
maxPlaylistExceeded
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist.
invalidValue (400)
onePlaylistNeeded
Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę.
invalidValue (400)
ownChannelInChannels
Nie możesz dodać własnego kanału do sekcji kanału, która pojawia się na tym kanale.
invalidValue (400)
playlistIsPrivate
Co najmniej 1 z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału.
invalidValue (400)
playlistsDuplicated
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty.
invalidValue (400)
playlistsNeeded
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy określić właściwość contentDetails.playlists[].
invalidValue (400)
playlistsNotExpected
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania.
invalidValue (400)
snippetNeeded
Aby zaktualizować sekcję kanału, musisz podać snippet.
invalidValue (400)
titleLengthExceeded
Wartość usługi snippet.title jest za długa.
invalidValue (400)
titleRequired
Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404)
channelNotFound
Nie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404)
channelSectionNotFound
Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
notFound (404)
playlistNotFound
Nie udało się znaleźć co najmniej jednej z podanych playlist.
kanały
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami channels. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channels.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
invalidCriteria
Możesz określić maksymalnie 1 z tych filtrów:id, mySubscribers, categoryId, mine, managedByMe, forUsername. W przypadku uwierzytelniania właściciela treści za pomocą parametru onBehalfOfContentOwner można określić tylko parametry id lub managedByMe.
forbidden (403)
channelForbidden
Kanał określony przez parametr id nie obsługuje żądania lub żądanie nie jest odpowiednio autoryzowane.
notFound (404)
categoryNotFound
Nie można znaleźć kategorii zidentyfikowanej przez parametr categoryId.
notFound (404)
channelNotFound
Nie udało się znaleźć kanału podanego w parametrze id.
channels.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
brandingValidationError
Weryfikacja jednej z wartości w obiekcie brandingSettings nie powiodła się. Użyj metody channels.list, aby pobrać dotychczasowe ustawienia kanału, i zaktualizuj wartości właściwości zgodnie z wytycznymi w dokumentacji zasobu channels.
badRequest (400)
channelTitleUpdateForbidden
Podczas aktualizowania brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na bieżący tytuł kanału lub pominąć tę właściwość. Jeśli zmienisz wartość właściwości, interfejs API zwróci błąd.
badRequest (400)
defaultLanguageNotSetError
defaultLanguage musi być ustawiony na aktualizację localizations.
badRequest (400)
invalidBrandingOption
Jedno z określonych ustawień marki nie istnieje. Użyj metody channels.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w channels dokumentacji zasobu.
badRequest (400)
invalidCustomMessage
Metadane żądania zawierają nieprawidłową wiadomość niestandardową. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, do którego wysłano żądanie.
badRequest (400)
invalidDuration
Metadane żądania określają nieprawidłowy czas trwania w części invideoPromotion.
badRequest (400)
invalidDuration
Metadane żądania określają nieprawidłowy typ pozycji, który służy do określania sposobu pozycjonowania promowanego produktu w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, do którego wysłano żądanie.
Metadane żądania określają nieprawidłowe przesunięcie czasowe w części invideoPromotion.
badRequest (400)
invalidTimingOffset
Metadane żądania określają nieprawidłowe przesunięcie czasowe, które służy do określania, kiedy promowany produkt powinien być wyświetlany w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, do którego wysłano żądanie.
badRequest (400)
invalidTimingType
Metadane żądania określają nieprawidłową metodę określania czasu, w którym promowany produkt powinien być wyświetlany w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, do którego wysłano żądanie.
badRequest (400)
localizationValidationError
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody channels.list. Pamiętaj, aby zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu kanałów.
badRequest (400)
tooManyPromotedItems
W sekcji invideoPromotion przekroczono dozwoloną liczbę promowanych produktów.
forbidden (403)
channelForbidden
Kanał określony w parametrze id nie obsługuje żądania lub żądanie nie jest odpowiednio autoryzowane.
forbidden (403)
promotedVideoNotAllowed
Nie można znaleźć kanału, który próbuje zaktualizować żądanie do interfejsu API. Sprawdź wartość właściwości id w zasobie channel, do którego wysłano żądanie, aby upewnić się, że identyfikator kanału jest prawidłowy.
forbidden (403)
websiteLinkNotAllowed
Podany adres URL witryny jest niedozwolony.
notFound (404)
channelNotFound
Nie można znaleźć kanału określonego przez parametr id lub nie ma on opcji brandingu.
notFound (404)
channelNotFound
Nie udało się znaleźć kanału podanego w parametrze id.
notFound (404)
unknownChannelId
Nie znaleziono podanego identyfikatora kanału.
notFound (404)
unknownChannelId
Nie znaleziono podanego identyfikatora kanału recentlyUploadedBy.
Metadane żądania muszą określać typ produktu w części invideoPromotion.
required (400)
requiredItemId
Metadane żądania muszą określać element w części invideoPromotion.
required (400)
requiredTimingOffset
Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie, który wysyła żądanie.
required (400)
requiredTimingOffset
Metadane żądania muszą określać przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysyła żądanie.
required (400)
requiredTimingType
Metadane żądania muszą określać metodę określania czasu, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie, który wysyła żądanie.
required (400)
requiredTimingType
Metadane żądania muszą określać metodę określania czasu, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie, który wysyła żądanie.
required (400)
requiredTiming
Metadane żądania muszą określać czas dla każdego elementu w części invideoPromotion.
required (400)
requiredVideoId
Metadane żądania muszą zawierać identyfikator filmu, aby można było zidentyfikować promowany produkt.
required (400)
requiredWebsiteUrl
Metadane żądania muszą zawierać adres URL witryny w sekcji invideoPromotion. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie, który wysyła żądanie.
commentThreads
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami commentThreads. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
commentThreads.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
operationNotSupported
Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403)
commentsDisabled
Film zidentyfikowany przez parametr videoId ma wyłączone komentarze.
forbidden (403)
forbidden
Nie udało się pobrać co najmniej 1 wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
Nie udało się znaleźć co najmniej 1 z podanych wątków komentarzy. Sprawdź wartości parametru id żądania, aby upewnić się, że są prawidłowe.
notFound (404)
videoNotFound
Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
commentThreads.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
channelOrVideoIdMissing
Każdy wątek komentarzy musi być powiązany z kanałem lub filmem. Upewnij się, że zasób określa wartości właściwości snippet.channelId i snippet.videoId. Komentarz do filmu pojawia się na stronie odtwarzania filmu.
badRequest (400)
commentTextRequired
Wstawiany zasób comment musi mieć określoną wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400)
commentTextTooLong
Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal.
badRequest (400)
invalidCommentThreadMetadata
Metadane żądania są nieprawidłowe.
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403)
forbidden
Nie udało się utworzyć wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
ineligibleAccount
Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404)
channelNotFound
Nie udało się znaleźć podanego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa.
notFound (404)
videoNotFound
Nie udało się znaleźć wybranego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa.
komentarze
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami comments. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
comments.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
operationNotSupported
Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
forbidden (403)
forbidden
Nie udało się pobrać co najmniej 1 z komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
commentNotFound
Nie udało się znaleźć co najmniej jednego z podanych komentarzy. Sprawdź wartości parametrów id i parentId żądania, aby upewnić się, że są prawidłowe.
comments.setModerationStatus
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
banWithoutReject
Parametru banAuthor można używać tylko wtedy, gdy wartość parametru moderationStatus to rejected.
badRequest (400)
operationNotSupported
Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403)
forbidden
Nie udało się ustawić stanu moderacji co najmniej 1 komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
commentNotFound
Nie można znaleźć co najmniej jednego komentarza, który próbuje zaktualizować żądanie. Sprawdź wartości parametru id żądania, aby upewnić się, że są prawidłowe.
comments.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
commentTextRequired
Wstawiany zasób comment musi mieć określoną wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400)
commentTextTooLong
Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400)
invalidCommentMetadata
Metadane żądania są nieprawidłowe.
badRequest (400)
operationNotSupported
Użytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu zidentyfikowany przez właściwość snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżący widz może odpowiedzieć w wątku.
badRequest (400)
parentCommentIsPrivate
Określony komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na prywatne komentarze.
badRequest (400)
parentIdMissing
Wstawiany komentarz musi być połączony z komentarzem nadrzędnym. Zasób comment w treści żądania do interfejsu API nie zawierał jednak wartości właściwości snippet.parentId.
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403)
forbidden
Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
ineligibleAccount
Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404)
parentCommentNotFound
Nie udało się znaleźć podanego komentarza nadrzędnego. Sprawdź, czy wartość właściwości snippet.parentId w treści żądania jest prawidłowa.
comments.delete
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403)
forbidden
Nie udało się usunąć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
commentNotFound
Nie udało się znaleźć wskazanego komentarza. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
comments.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
commentTextTooLong
Aktualizowany zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400)
invalidCommentMetadata
Metadane żądania są nieprawidłowe.
badRequest (400)
operationNotSupported
Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)
processingFailure
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403)
forbidden
Nie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
ineligibleAccount
Aby zaktualizować komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404)
commentNotFound
Nie udało się znaleźć wskazanego komentarza. Sprawdź, czy wartość właściwości id w treści żądania jest prawidłowa.
członkowie
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
members.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
channelMembershipsNotEnabled
Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania.
badRequest (400)
invalidMode
Wartość parametru mode jest nieprawidłowa.
Ten błąd może wystąpić, jeśli parametr pageToken określa token pobrany w innym trybie niż określony.
badRequest (400)
invalidPageToken
Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, jeśli token strony użyty w żądaniu wygasł.
badRequest (400)
invalidHasAccessToLevel
Wartość parametru hasAccessToLevel jest nieprawidłowa. Nie ma poziomu o podanym identyfikatorze id.
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
membershipsLevels.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
channelMembershipsNotEnabled
Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania.
playlistItems
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami playlistItems. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
playlistItems.delete
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
playlistItemsNotAccessible
Żądanie nie jest odpowiednio autoryzowane do usunięcia określonego elementu playlisty.
notFound (404)
playlistItemNotFound
Nie udało się znaleźć elementu listy odtwarzania zidentyfikowanego za pomocą parametru id w żądaniu.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości usuwania filmów z określonej playlisty. Nie możesz na przykład usunąć filmu z playlisty przesłanych filmów.
playlistItems.insert
Typ błędu
Szczegóły błędu
Opis
duplicate
videoAlreadyInPlaylist
Film, który próbujesz dodać do playlisty, już się na niej znajduje.
forbidden (403)
playlistContainsMaximumNumberOfVideos
Playlista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403)
playlistItemsNotAccessible
Żądanie nie ma odpowiednich uprawnień do wstawienia określonego elementu playlisty.
invalidValue (400)
invalidContentDetails
Właściwość contentDetails w żądaniu jest nieprawidłowa. Możliwa przyczyna to przekroczenie limitu 280 znaków w polu contentDetails.note.
invalidValue (400)
invalidPlaylistItemPosition
Żądanie próbuje ustawić pozycję elementu listy odtwarzania na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu.
invalidValue (400)
invalidResourceType
W przypadku identyfikatora zasobu podano wartość type, która nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400)
manualSortRequired
Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie korzysta z ręcznego sortowania. (Na przykład elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, do którego wstawiane jest żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować opcję Kolejność playlisty na Ręczna w ustawieniach playlisty. Te ustawienia można zmienić w Menedżerze filmów w YouTube.
invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
Film, który próbujesz dodać do playlisty, jest już na innej playliście serialu.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości wstawiania filmów do określonej playlisty. Nie możesz na przykład wstawić filmu do playlisty z przesłanymi przez siebie filmami.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru playlistId w żądaniu.
notFound (404)
videoNotFound
Nie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź wartość właściwości videoId, aby upewnić się, że jest prawidłowa.
required (400)
channelIdRequired
W żądaniu nie podano wartości wymaganej właściwości channelId.
required (400)
playlistIdRequired
W żądaniu nie podano wartości wymaganej właściwości playlistId.
required (400)
resourceIdRequired
Żądanie musi zawierać zasób, w którym obiekt snippet określa resourceId.
playlistItems.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
playlistItemsNotAccessible
Żądanie nie jest odpowiednio autoryzowane do pobrania określonej playlisty.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru playlistId w żądaniu.
notFound (404)
videoNotFound
Nie udało się znaleźć filmu zidentyfikowanego za pomocą parametru videoId w żądaniu.
required (400)
playlistIdRequired
W żądaniu subskrypcji nie podano wartości wymaganej właściwości playlistId.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości wyświetlania listy filmów na określonej playliście. Nie możesz na przykład umieścić filmu na playliście Do obejrzenia.
playlistItems.update
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
playlistItemsNotAccessible
Żądanie nie jest odpowiednio autoryzowane do zaktualizowania określonego elementu playlisty.
invalidValue (400)
invalidPlaylistItemPosition
Żądanie próbuje ustawić pozycję elementu listy odtwarzania na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu.
invalidValue (400)
invalidResourceType
W przypadku identyfikatora zasobu podano wartość type, która nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400)
invalidSnippet
Żądanie nie zawiera prawidłowej właściwości snippet.
invalidValue (400)
manualSortRequired
Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie korzysta z ręcznego sortowania. (Na przykład elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, do którego wstawiane jest żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować opcję Kolejność playlisty na Ręczna w ustawieniach playlisty. Te ustawienia można zmienić w Menedżerze filmów w YouTube.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości aktualizowania filmów na określonej playliście. Nie możesz na przykład zaktualizować filmu na liście przesłanych filmów.
notFound (404)
playlistItemNotFound
Nie można znaleźć elementu listy odtwarzania zidentyfikowanego za pomocą właściwości id żądania.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru playlistId w żądaniu.
required (400)
channelIdRequired
W żądaniu nie podano wartości wymaganej właściwości channelId.
required (400)
playlistIdRequired
W żądaniu nie podano wartości wymaganej właściwości playlistId.
required (400)
playlistItemIdRequired
Zasób elementu playlisty określony w żądaniu musi używać właściwości id, aby zidentyfikować aktualizowany element playlisty.
playlisty
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami playlists. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
playlists.delete
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
playlistForbidden
Ta operacja jest zabroniona lub żądanie nie jest odpowiednio autoryzowane.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru id w żądaniu.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości usunięcia określonej playlisty. Nie możesz na przykład usunąć playlisty przesłanych filmów.
playlists.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
channelClosed
Kanał podany w parametrze channelId został zamknięty.
forbidden (403)
channelSuspended
Kanał określony w parametrze channelId został zawieszony.
forbidden (403)
playlistForbidden
Lista odtwarzania zidentyfikowana za pomocą parametru id w żądaniu nie obsługuje tego żądania lub żądanie nie jest odpowiednio autoryzowane.
notFound (404)
channelNotFound
Nie udało się znaleźć kanału podanego w parametrze channelId.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru id w żądaniu.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości wyświetlania określonej playlisty. Nie możesz na przykład wyświetlić listy Do obejrzenia.
playlists.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSetError
defaultLanguage musi być ustawiony na aktualizację localizations.
badRequest (400)
localizationValidationError
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list. Pamiętaj, aby zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu playlisty.
badRequest (400)
maxPlaylistExceeded
Nie można utworzyć playlisty, ponieważ kanał ma już maksymalną dozwoloną liczbę playlist.
forbidden (403)
playlistForbidden
Ta operacja jest zabroniona lub żądanie nie jest odpowiednio autoryzowane.
invalidValue (400)
invalidPlaylistSnippet
Żądanie zawiera nieprawidłowy fragment playlisty.
required (400)
playlistTitleRequired
Żądanie musi zawierać tytuł playlisty.
playlists.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSetError
defaultLanguage musi być ustawiony na aktualizację localizations.
badRequest (400)
localizationValidationError
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list. Pamiętaj, aby zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu playlisty.
forbidden (403)
playlistForbidden
Ta operacja jest zabroniona lub żądanie nie jest odpowiednio autoryzowane.
invalidValue (400)
invalidPlaylistSnippet
Żądanie zawiera nieprawidłowy fragment playlisty.
invalidValue (400)
playlistOperationUnsupported
Interfejs API nie obsługuje możliwości aktualizowania określonej playlisty. Nie możesz na przykład aktualizować właściwości playlisty przesłanych filmów.
notFound (404)
playlistNotFound
Nie można znaleźć listy odtwarzania zidentyfikowanej za pomocą parametru id w żądaniu.
required (400)
playlistTitleRequired
Żądanie musi zawierać tytuł playlisty.
szukaj
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami search. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
search.list
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
invalidChannelId
Parametr channelId określa nieprawidłowy identyfikator kanału.
badRequest (400)
invalidLocation
Wartość parametru location lub locationRadius została nieprawidłowo sformatowana.
badRequest (400)
invalidRelevanceLanguage
Wartość parametru relevanceLanguage ma nieprawidłowy format.
badRequest (400)
invalidSearchFilter
Żądanie zawiera nieprawidłową kombinację filtrów wyszukiwania lub ograniczeń. Jeśli ustawisz wartość parametru eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated lub videoType, musisz ustawić parametr type na video.
subskrypcje
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami subscriptions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
subscriptions.delete
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
subscriptionForbidden
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404)
subscriptionNotFound
Nie udało się znaleźć subskrypcji, którą chcesz usunąć. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
subscriptions.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
subscriptionDuplicate
Subskrypcja, którą próbujesz utworzyć, już istnieje.
badRequest (400)
subscriptionForbidden
Masz już maksymalną liczbę subskrypcji.
badRequest (400)
subscriptionForbidden
W ostatnim czasie zasubskrybowałeś zbyt wiele kanałów. Spróbuj ponownie za kilka godzin.
badRequest (400)
subscriptionForbidden
Subskrybowanie własnego kanału nie jest obsługiwane.
forbidden (403)
subscriptionForbidden
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404)
publisherNotFound
Nie udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404)
subscriberNotFound
Nie znaleziono subskrybenta z żądania.
required (400)
publisherRequired
Usługa subskrypcji określona w żądaniu musi używać właściwości snippet.resourceId, aby zidentyfikować kanał, który jest subskrybowany.
subscriptions.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
accountClosed
Nie można pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte.
forbidden (403)
accountSuspended
Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone.
forbidden (403)
subscriptionForbidden
Zgłaszający nie ma dostępu do żądanych subskrypcji.
notFound (404)
subscriberNotFound
Nie znaleziono subskrybenta z żądania.
miniatury
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami thumbnails. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
thumbnails.set
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
invalidImage
Podana treść obrazu jest nieprawidłowa.
badRequest (400)
mediaBodyRequired
Żądanie nie zawiera treści obrazu.
forbidden (403)
forbidden
Nie można ustawić miniatury dla wybranego filmu. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
forbidden
Uwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów.
notFound (404)
videoNotFound
Nie można znaleźć filmu, do którego próbujesz wstawić miniaturę. Sprawdź wartość parametru videoId żądania, aby upewnić się, że jest prawidłowa.
tooManyRequests (429)
uploadRateLimitExceeded
Na kanale przesłano ostatnio zbyt wiele miniatur. Spróbuj ponownie później.
videoAbuseReportReasons
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videoAbuseReportReasons. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videoAbuseReportReasons.list
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
videoCategories
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami videoCategories. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videoCategories.list
Typ błędu
Szczegóły błędu
Opis
notFound (404)
videoCategoryNotFound
Nie znaleziono kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.
filmy
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami videos. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videos.insert
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSet
Żądanie próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka szczegółów filmu.
badRequest (400)
invalidCategoryId
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400)
invalidDescription
Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400)
invalidFilename
Nazwa pliku wideo podana w nagłówku Slug jest nieprawidłowa.
badRequest (400)
invalidPublishAt
Metadane żądania określają nieprawidłowy czas publikacji zaplanowanej.
badRequest (400)
invalidRecordingDetails
Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrania.
badRequest (400)
invalidTags
Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400)
invalidTitle
Metadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400)
invalidVideoGameRating
Metadane żądania określają nieprawidłową ocenę gry wideo.
badRequest (400)
invalidVideoMetadata
Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId.
badRequest (400)
mediaBodyRequired
Prośba nie zawiera treści wideo.
badRequest (400)
uploadLimitExceeded
Użytkownik przekroczył liczbę filmów, które może przesłać.
forbidden (403)
forbidden
forbidden (403)
forbiddenLicenseSetting
Żądanie próbuje ustawić nieprawidłową licencję na film.
Żądana lista filmów nie jest obsługiwana lub jest niedostępna.
forbidden (403)
forbidden
Żądanie nie jest odpowiednio autoryzowane do uzyskania dostępu do pliku wideo lub informacji o przetwarzaniu. Części fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu.
forbidden (403)
forbidden
Żądanie nie może uzyskać dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie jest odpowiednio autoryzowane do używania parametru myRating.
notFound (404)
videoNotFound
Nie można znaleźć filmu, który próbujesz odzyskać. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
videos.delete
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Nie można usunąć filmu, który próbujesz usunąć. Żądanie może nie być prawidłowo autoryzowane.
notFound (404)
videoNotFound
Nie można znaleźć filmu, który próbujesz usunąć. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
videos.update
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
defaultLanguageNotSet
Żądanie do interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400)
invalidCategoryId
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400)
invalidDefaultBroadcastPrivacySetting
Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji.
badRequest (400)
invalidDescription
Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400)
invalidPublishAt
Metadane żądania określają nieprawidłowy czas publikacji zaplanowanej.
badRequest (400)
invalidRecordingDetails
Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrania.
badRequest (400)
invalidTags
Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400)
invalidTitle
Metadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400)
invalidVideoMetadata
Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId.
forbidden (403)
forbidden
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
forbiddenEmbedSetting
Żądanie próbuje ustawić nieprawidłowe ustawienie umieszczania filmu. Niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzaczy do umieszczania transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403)
forbiddenLicenseSetting
Żądanie próbuje ustawić nieprawidłową licencję na film.
Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość pola id w treści żądania jest prawidłowa.
videos.rate
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
emailNotVerified
Przed wystawieniem oceny użytkownik musi potwierdzić swój adres e-mail.
badRequest (400)
invalidRating
Żądanie zawierało nieoczekiwaną wartość parametru rating.
badRequest (400)
videoPurchaseRequired
Filmy do wypożyczenia mogą oceniać tylko użytkownicy, którzy je wypożyczyli.
forbidden (403)
forbidden
Filmu, który próbujesz ocenić, nie można ocenić. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403)
videoRatingDisabled
Właściciel filmu, który próbujesz ocenić, wyłączył możliwość oceniania tego filmu.
notFound (404)
videoNotFound
Nie można znaleźć filmu, który chcesz ocenić. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.
videos.reportAbuse
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
invalidAbuseReason
Żądanie zawierało nieoczekiwaną wartość pola reason_id lub kombinację pól reason_id i secondary_reason_id.
badRequest (400)
rateLimitExceeded
Użytkownik wysłał zbyt wiele żądań w danym okresie.
forbidden (403)
forbidden
notFound (404)
videoNotFound
Nie można znaleźć filmu, w przypadku którego próbujesz zgłosić nadużycie.
znaki wodne,
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami watermarks. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
watermarks.set
Typ błędu
Szczegóły błędu
Opis
badRequest (400)
imageFormatUnsupported
Przesłany obraz jest w nieobsługiwanym formacie.
badRequest (400)
imageTooTall
Przesłany obraz jest za wysoki.
badRequest (400)
imageTooWide
Podany obraz jest za szeroki.
badRequest (400)
mediaBodyRequired
Żądanie nie zawiera treści obrazu.
forbidden (403)
forbidden
Nie można ustawić znaku wodnego dla wybranego kanału. Żądanie może nie być odpowiednio autoryzowane lub parametr channelId ma nieprawidłową wartość.
watermarks.unset
Typ błędu
Szczegóły błędu
Opis
forbidden (403)
forbidden
Nie można cofnąć ustawienia znaku wodnego dla wybranego kanału. Żądanie może nie być odpowiednio autoryzowane lub parametr channelId ma nieprawidłową wartość.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2026-03-15 UTC."],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
komentarze
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami
comments. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidiparentIdżądania, aby upewnić się, że są prawidłowe.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthormożna używać tylko wtedy, gdy wartość parametrumoderationStatustorejected.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidżądania, aby upewnić się, że są prawidłowe.comments.insertbadRequest (400)commentTextRequiredcommentmusi mieć określoną wartość właściwościsnippet.textOriginal. Komentarze nie mogą być puste.badRequest (400)commentTextTooLongcommentzawiera zbyt wiele znaków we właściwościsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentId. W zasobiecommentThreadwłaściwośćsnippet.canReplywskazuje, czy bieżący widz może odpowiedzieć w wątku.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentw treści żądania do interfejsu API nie zawierał jednak wartości właściwościsnippet.parentId.badRequest (400)processingFailurecommentw treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdw treści żądania jest prawidłowa.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidżądania, aby upewnić się, że jest prawidłowa.comments.updatebadRequest (400)commentTextTooLongcommentzawiera zbyt wiele znaków we właściwościsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentw treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidw treści żądania jest prawidłowa.