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ć tej prośby, ponieważ został przekroczony Twój 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 zawiera 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 występuje zwykle, 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 poście na blogu YouTube API, w którym wprowadziliśmy obsługę kont Google, szczegółowo omawiamy też błąd youtubeSignupRequired . 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 zostało prawidłowo 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 zwracane przez interfejs API 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 napisów. Żądanie może nie być prawidłowo autoryzowane. |
invalidValue (400) |
couldNotConvert |
Nie udało się przekonwertować danych ścieżki napisów na wybrany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe, a snippet.status żądanego ścieżki napisów nie jest 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 napisów. Żą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 napisów, 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 napisów. Żą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 w YouTube zawiera za dużo obrazów. Otwórz http://photos.google.com, przejdź na 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 tym kanale. |
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ęzykowych obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Nie udało się 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 nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Weryfikacja jednej z wartości na liście targeting.regions nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">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 są oczekiwane żadne kanały. |
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. |
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ść właściwości 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 można znaleźć co najmniej jednego z podanych kanałów. |
notFound (404) |
playlistNotFound |
Nie można znaleźć co najmniej jednej z podanych playlist. |
channelSections.list
Typ błędu |
Szczegóły błędu |
Opis |
forbidden (403) |
channelSectionForbidden |
Osoba wysyłająca prośbę 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 udało się 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ęzykowych obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">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 nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Weryfikacja jednej z wartości na liście targeting.regions nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie z wytycznymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">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 są oczekiwane żadne kanały. |
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ść właściwości 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 można znaleźć co najmniej jednego z podanych kanałów. |
notFound (404) |
channelSectionNotFound |
Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować. |
notFound (404) |
playlistNotFound |
Nie można znaleźć co najmniej jednej z podanych playlist. |
kanały
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API 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. |
badRequest (400) |
invalidRecentlyUploadedBy |
Metadane żądania zawierają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, do którego wysłano żądanie. |
badRequest (400) |
invalidTimingOffset |
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 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. |
notFound (404) |
unknownVideoId |
Nie znaleziono identyfikatora filmu określonego jako promowany produkt. |
required (400) |
requiredItemIdType |
Metadane żądania muszą określać typ elementu 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. |
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 . |
badRequest (400) |
invalidFilterByMemberChannelId |
Wartość parametru filterByMemberChannelId jest nieprawidłowa. Ten błąd występuje, jeśli wartość parametru filterByMemberChannelId określa więcej niż 100 kanałów. |
membershipsLevels
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 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, który jest wstawiany w ramach żądania. Jeśli chcesz, aby element playlisty znajdował się na określonej pozycji 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 |
Żądanie subskrypcji nie zawiera 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 usługi 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, który jest wstawiany w ramach żądania. Jeśli chcesz, aby element playlisty znajdował się na określonej pozycji 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 żą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 aktualizować 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 aktualizować 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 z przesłanymi filmami. |
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 wartość 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 tym kanale. |
notFound (404) |
subscriptionNotFound |
Nie udało się znaleźć subskrypcji, którą próbujesz 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 tym kanale. |
notFound (404) |
publisherNotFound |
Nie udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania. |
notFound (404) |
subscriberNotFound |
Nie można znaleźć subskrybenta zidentyfikowanego w żądaniu. |
required (400) |
publisherRequired |
Zasób subskrypcji określony 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 |
Osoba wysyłająca prośbę nie ma dostępu do żądanych subskrypcji. |
notFound (404) |
subscriberNotFound |
Nie można znaleźć subskrybenta zidentyfikowanego w żądaniu. |
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 zwracane przez interfejs API 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 zwracane przez interfejs API 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 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) |
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 zawierają 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. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje ustawić nieprawidłowe ustawienia prywatności filmu. |
videos.list
Typ błędu |
Szczegóły błędu |
Opis |
badRequest (400) |
videoChartNotFound |
Żą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 ma 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 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. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje ustawić nieprawidłowe ustawienia prywatności filmu. |
notFound (404) |
videoNotFound |
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 próbujesz 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 |
Podany obraz jest zbyt 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ść. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-10-06 UTC.
[[["Ł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: 2025-10-06 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.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
iparentId
żądania, aby upewnić się, że są prawidłowe.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
można używać tylko wtedy, gdy wartość parametrumoderationStatus
torejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania, aby upewnić się, że są prawidłowe.comments.insert
badRequest (400)
commentTextRequired
comment
musi mieć określoną wartość właściwościsnippet.textOriginal
. Komentarze nie mogą być puste.badRequest (400)
commentTextTooLong
comment
zawiera zbyt wiele znaków we właściwościsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. W zasobiecommentThread
właściwośćsnippet.canReply
wskazuje, czy bieżący widz może odpowiedzieć w wątku.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
w treści żądania API nie zawierał jednak wartości właściwościsnippet.parentId
.badRequest (400)
processingFailure
comment
w treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
w treści żądania jest prawidłowa.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania, aby upewnić się, że jest prawidłowa.comments.update
badRequest (400)
commentTextTooLong
comment
zawiera zbyt wiele znaków we właściwościsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
w treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
w treści żądania jest prawidłowa.