YouTube Data API - Errors

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.namesnippet.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 idvideoId żą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.

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.
notFound (404) channelNotFound Nie udało się znaleźć kanału zidentyfikowanego przez parametr allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Nie udało się znaleźć co najmniej jednego 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 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 można pobrać co najmniej 1 z żądanych komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie można znaleźć co najmniej jednego z podanych komentarzy. Sprawdź wartości parametrów idparentId żą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 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 komentarze prywatne.
badRequest (400) parentIdMissing Wstawiany komentarz musi być połączony z komentarzem nadrzędnym. Zasób comment w treści żądania 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 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 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.
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 positionsnippet 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 positionsnippet 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.

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.titlesnippet.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.titlesnippet.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_idsecondary_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ść.