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 poszczególnych metod znajdziesz w dokumentacji tej metody.

Ogólne błędy

W tabelach poniżej znajdziesz komunikaty o błędach interfejsu API, które nie dotyczą określonej metody API.

Core API errors

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie zostać prawidłowo autoryzowane.
quotaExceeded (403) quotaExceeded Nie można zrealizować żądania, ponieważ został przekroczony Twój limit.

Common request errors

Typ błędu Szczegóły błędu Opis
badRequest (400) incompatibleParameters Żądanie określa co najmniej 2 parametry, których nie można użyć w tym samym żądaniu.
badRequest (400) invalidFilters Żądanie określa nieprawidłowy parametr filtra.
badRequest (400) invalidPageToken Żądanie określa nieprawidłowy token strony.
badRequest (400) missingRequiredParameter W żądaniu brakuje wymaganego parametru.
badRequest (400) unexpectedParameter Żądanie określa 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, błąd ten odnosi się do tego drugiego.
forbidden (403) authenticatedUserAccountSuspended Konto YouTube uwierzytelnionego użytkownika jest zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd ten odnosi się do tego drugiego.
forbidden (403) authenticatedUserNotChannel W tym przypadku musi uwierzytelnić użytkownika do kanału, ale tego nie zrobił. Jeśli żądanie zostało uwierzytelnione i używa parametru przekazania onBehalfOfContentOwner, ustaw też parametr onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed Kanał określony w żądaniu został zamknięty.
forbidden (403) channelNotFound Nie udało się znaleźć kanału wskazanego w żądaniu.
forbidden (403) channelSuspended Kanał określony w prośbie został zawieszony.
forbidden (403) cmsUserAccountNotFound Użytkownik systemu CMS nie może działać w imieniu określonego właściciela treści.
forbidden (403) insufficientCapabilities Użytkownik systemu CMS ma niewystarczające możliwości.
forbidden (403) insufficientPermissions Token OAuth 2.0 podany w żądaniu określa zakresy 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 Wykorzystanie parametru mine w żądaniu nie jest obsługiwane.
badRequest (400) invalidMine Parametru mine nie można używać w żądaniach, w których uwierzytelniony użytkownik jest partnerem YouTube. Musisz usunąć parametr mine, uwierzytelnić się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działać jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest on dostępny dla wywołanej metody.
badRequest (400) invalidPart Parametr part żądania określa niektóre części, których nie można zapisać jednocześnie.
badRequest (400) invalidRegionCode Parametr regionCode określa nieprawidłowy kod regionu.
badRequest (400) unexpectedPart Parametr part żądania określa nieoczekiwaną wartość.
badRequest (400) unknownPart Parametr part żądania 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 odłączone konto Google, co oznacza, że ma konto Google, ale nie ma kanału w YouTube. Tacy użytkownicy mają dostęp do wielu funkcji zależnych od autoryzacji użytkownika, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later. Przykładowo użytkownik będzie musiał mieć kanał w YouTube, aby móc przesłać film. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, ma już konto Google, ale mógł je wcześniej nie połączyć z kanałem w YouTube.

Ten błąd często pojawia się, gdy próbujesz użyć procedury konta 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 dotyczącym interfejsu API YouTube dotyczącym obsługi konta Google szczegółowo opisujemy błąd youtubeSignupRequired. Chociaż w poście na blogu pojawi się opis błędu związanego z interfejsem API w wersji 2.1, jego znaczenie nadal będzie obowiązywać.

aktywności

YouTube wycofał funkcję Biuletynu kanału. Metoda activities.insert nie jest już obsługiwana.

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów activities. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

activities.list

Typ błędu Szczegóły błędu Opis
forbidden (403) homeParameterDeprecated Dane dotyczące aktywności na stronie głównej użytkownika nie są dostępne za pomocą tego interfejsu API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na wartość true.
forbidden (403) forbidden Żądanie nie jest poprawnie autoryzowane.
notFound (404) channelNotFound Nie można znaleźć identyfikatora kanału zdefiniowanego w parametrze channelId żądania.
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.

captions

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów captions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

captions.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie wystarczą do usunięcia ścieżki napisów. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

captions.download

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do pobrania ścieżki napisów. Prośba mogła nie zostać poprawnie autoryzowana lub zamówienie wideo nie umożliwiało dodania napisów dla osób trzecich.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki napisów na żądany język lub format. Sprawdź, czy żądane wartości tfmt i tlang są prawidłowe, a snippet.status podanej ścieżki audio nie zawiera wartości failed.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

captions.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Żądanie nie zawiera treści ścieżki napisów.
conflict (409) captionExists Podany film ma już ścieżkę napisów z snippet.language i snippet.name. Film może mieć wiele ścieżek dla tego samego języka, ale każdy z nich musi mieć inną nazwę.

Istnieje kilka sposobów na rozwiązanie problemu. Przed wstawieniem nowej ścieżki możesz usunąć obecną, a następnie wstawić nową. Możesz też zmienić nazwę nowej ścieżki.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do przesłania ścieżki z napisami. Żądanie może nie zostać prawidłowo autoryzowane.
invalidValue (400) invalidMetadata Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie ścieżki. Potwierdź, że żądanie określa prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Możesz też dodać właściwość snippet.isDraft, ale nie jest to wymagane.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.

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 nie są wystarczające do pobrania żądanych zasobów. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć co najmniej 1 z podanych ścieżek napisów. Ten błąd występuje, jeśli parametr videoId identyfikuje rzeczywisty film, ale parametr id identyfikuje identyfikatory ścieżek napisów, które nie istnieją, lub identyfikatory ścieżek powiązanych z innymi filmami. Sprawdź, czy wartości parametrów id i videoId żądania są prawidłowe.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.

captions.update

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Prośba nie przesłała zaktualizowanego pliku z napisami. Rzeczywista zawartość ścieżki jest wymagana, jeśli parametr sync jest ustawiony na true.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie wystarczają do zaktualizowania ścieżki napisów. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć wskazanej ścieżki napisów. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

Banery kanału

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channelBanners. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

channelBanners.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) bannerAlbumFull Twój album z grafikami kanału w YouTube zawiera zbyt wiele obrazów. Otwórz stronę http://photos.google.com, przejdź na stronę albumów i usuń część zdjęć z tego albumu.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści graficznych.

Sekcje-Kanałów

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channelSections. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

channelSections.delete

Typ błędu Szczegóły błędu Opis
badRequest (400) notEditable Tej sekcji kanału nie można usunąć.
forbidden (403) channelSectionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400) idInvalid Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) idRequired Właściwość id musi zawierać wartość identyfikującą usuwaną sekcję kanału.
notFound (404) channelNotFound Nie znaleziono kanału.
notFound (404) channelSectionNotFound Nie możemy znaleźć sekcji kanału, którą próbujesz zaktualizować.

channelSections.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Właściwość snippet.defaultLanguage zasobu channelSection musi być ustawiona, aby można było wstawiać lub aktualizować obiekt localizations dla tego zasobu.
badRequest (400) invalidLanguage Jeden z kluczy języków obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Nie można utworzyć tej sekcji kanału.
badRequest (400) styleRequired Zasób channelSection musi określać wartość w polu snippet.style.
badRequest (400) targetInvalidCountry Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired Zasób channelSection musi określać 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 podanych kanałów nie jest aktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] oraz co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[], ale kanały nie są przeznaczone do tego typu kanału.
invalidValue (400) contentDetailsNeeded Wstawiony zasób musi zawierać obiekt contentDetails dla tego typu kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelSectionExceeded Nie można przetworzyć żądania, ponieważ kanał ma już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Nie udało się dodać zbyt wielu kanałów do sekcji kanału.
invalidValue (400) maxPlaylistExceeded Nie udało się dodać zbyt wielu playlist do sekcji kanału.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, to właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400) ownChannelInChannels Nie możesz umieścić własnego kanału w sekcji, która pojawia się na nim.
invalidValue (400) playlistIsPrivate Co najmniej jedna z określonych playlist jest prywatna i dlatego nie można jej dodać do sekcji kanału.
invalidValue (400) playlistsDuplicated Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane playlisty.
invalidValue (400) playlistsNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, musisz określić właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected W zasobie podanym w żądaniu określono wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie należy oczekiwać playlist.
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 określić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404) channelNotFound Nie udało się znaleźć co najmniej jednego z podanych kanałów.
notFound (404) playlistNotFound Nie udało się znaleźć co najmniej jednej z określonych playlist.

channelSections.list

Typ błędu Szczegóły błędu Opis
forbidden (403) channelSectionForbidden Zgłaszający nie ma dostępu do wybranych sekcji kanału.
invalidValue (400) idInvalid Żądanie określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie można zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe.
notFound (404) channelNotFound Nie udało się znaleźć kanału powiązanego z prośbą.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału powiązanej z żądaniem.

channelSections.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Właściwość snippet.defaultLanguage zasobu channelSection musi być ustawiona, aby można było wstawiać lub aktualizować obiekt localizations dla tego zasobu.
badRequest (400) invalidLanguage Jeden z kluczy języków obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów 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 określać wartość w polu snippet.style.
badRequest (400) targetInvalidCountry Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired Zasób channelSection musi określać 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 podanych kanałów nie jest aktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] oraz co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[], ale kanały nie są przeznaczone do tego typu kanału.
invalidValue (400) contentDetailsNeeded Zasób, który aktualizujesz, musi zawierać obiekt contentDetails dla tego typu 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 uaktualnioną sekcję kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelsExceeded Nie udało się dodać zbyt wielu kanałów do sekcji kanału.
invalidValue (400) maxPlaylistExceeded Nie udało się dodać zbyt wielu playlist do sekcji kanału.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, to właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400) ownChannelInChannels Nie możesz umieścić własnego kanału w sekcji, która pojawia się na nim.
invalidValue (400) playlistIsPrivate Co najmniej jedna z określonych playlist jest prywatna i dlatego nie można jej dodać do sekcji kanału.
invalidValue (400) playlistsDuplicated Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane playlisty.
invalidValue (400) playlistsNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, musisz określić właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected W zasobie podanym w żądaniu określono wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie należy oczekiwać playlist.
invalidValue (400) snippetNeeded Musisz określić tag snippet, aby zaktualizować sekcję kanału.
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 określić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404) channelNotFound Nie udało się znaleźć co najmniej jednego z podanych kanałów.
notFound (404) channelSectionNotFound Nie możemy znaleźć sekcji kanału, którą próbujesz zaktualizować.
notFound (404) playlistNotFound Nie udało się znaleźć co najmniej jednej z określonych playlist.

kanały

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channels. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

channels.list

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidCriteria Można określić maksymalnie jeden z tych filtrów:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Jeśli uwierzytelnianie właściciela treści odbywa się za pomocą parametru onBehalfOfContentOwner, można określić tylko id lub managedByMe.
forbidden (403) channelForbidden Kanał określony w parametrze id nie obsługuje żądania lub nie jest on poprawnie autoryzowany.
notFound (404) categoryNotFound Nie można znaleźć kategorii określonego przez parametr categoryId. Aby pobrać listę prawidłowych wartości, użyj metody guideCategory.list.
notFound (404) channelNotFound Nie można znaleźć kanału określonego w parametrze id.

channels.update

Typ błędu Szczegóły błędu Opis
badRequest (400) brandingValidationError Jedna z wartości w obiekcie brandingSettings nie przeszła weryfikacji. Użyj metody channels.list, aby pobrać istniejące ustawienia kanału i zaktualizować wartości właściwości zgodnie ze wskazówkami w dokumentacji zasobu channels.
badRequest (400) channelTitleUpdateForbidden Podczas aktualizowania brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na aktualny tytuł kanału lub pominąć tę właściwość. Interfejs API zwróci błąd, jeśli zmienisz wartość usługi.
badRequest (400) defaultLanguageNotSetError Musisz skonfigurować właściwość defaultLanguage, aby zaktualizować localizations.
badRequest (400) invalidBrandingOption Jedno z podanych ustawień marki nie istnieje. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów channels.
badRequest (400) invalidCustomMessage Metadane żądania wskazują nieprawidłowy komunikat niestandardowy. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, który wysłał żą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 określającej położenie promowanego elementu w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, który wysłał żądanie.
badRequest (400) invalidRecentlyUploadedBy Metadane żądania podają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, który wysłał żądanie.
badRequest (400) invalidTimingOffset Metadane żądania wskazują nieprawidłowe przesunięcie czasowe w części invideopromotion.
badRequest (400) invalidTimingOffset Metadane żądania wskazują nieprawidłowe przesunięcie czasowe określające, kiedy promowany produkt powinien zostać wyświetlony w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysłał żą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. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, który wysłał żą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 i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów kanału.
badRequest (400) tooManyPromotedItems W części invideopromotion została przekroczona dozwolona liczba elementów objętych promocją.
forbidden (403) channelForbidden Kanał określony w parametrze id nie obsługuje żądania lub nie jest ono prawidłowo autoryzowane.
forbidden (403) promotedVideoNotAllowed Nie udało się znaleźć kanału, który próbujesz zaktualizować API. Sprawdź wartość właściwości id w zasobie channel, który wysłał żądanie, aby mieć pewność, ż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 za pomocą parametru id lub nie są dostępne żadne opcje promowania marki.
notFound (404) channelNotFound Nie można znaleźć kanału określonego w parametrze id.
notFound (404) unknownChannelId Nie znaleziono podanego identyfikatora kanału.
notFound (404) unknownChannelId Nie znaleziono podanego identyfikatora kanału.
notFound (404) unknownVideoId Nie można znaleźć identyfikatora filmu określonego jako promowany produkt.
required (400) requiredItemIdType Metadane żądania muszą określać typ elementu w sekcji invideopromotion.
required (400) requiredItemId Metadane żądania muszą zawierać identyfikator elementu, który jest częścią invideopromotion.
required (400) requiredTimingOffset Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mogło określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie wysyłanym przez żą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 wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie wysyłanym przez żądanie.
required (400) requiredTiming Metadane żądania muszą zawierać informacje o czasie w elemencie 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 wysyłanym przez żądanie.

wątki

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów commentThreads. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

commentThreads.list

Typ błędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Filtr identyfikatorów jest zgodny tylko z komentarzami opartymi na Google+.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest on prawidłowy.
forbidden (403) commentsDisabled Film zidentyfikowany przez parametr videoId wyłączył komentarze.
forbidden (403) forbidden Nie można pobrać co najmniej 1 z wątków komentarzy z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) channelNotFound Nie udało się znaleźć kanału wskazanego w parametrze channelId lub allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Nie udało się znaleźć co najmniej 1 z podanych wątków komentarzy. Sprawdź, czy wartości parametru id żądania są prawidłowe.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.

commentThreads.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) channelOrVideoIdMissing Każdy wątek komentarzy musi być połączony z kanałem lub filmem.
  • Jeśli komentarz dotyczy kanału, sprawdź, czy zasób określony w treści żądania zawiera wartość właściwości snippet.channelId. Komentarz dotyczący kanału zostanie wyświetlony na karcie Dyskusja.
  • Jeśli komentarz dotyczy filmu, upewnij się, że zasób określa wartości we właściwościach snippet.channelId i snippet.videoId. Komentarz dotyczący filmu pojawi się na jego stronie odtwarzania.
badRequest (400) commentTextRequired Wstawiony zasób comment musi określać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiony 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 Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest on prawidłowy.
forbidden (403) forbidden Nie udało się utworzyć wątku z komentarzem z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404) channelNotFound Nie udało się znaleźć tego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa.
notFound (404) videoNotFound Nie udało się znaleźć podanego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa.

komentarza

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów comments. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

comments.list

Typ błędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Filtr id jest zgodny tylko z komentarzami opartymi na Google+.
forbidden (403) forbidden Nie można pobrać co najmniej 1 z żądanych komentarzy z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej jednego z podanych komentarzy. Sprawdź, czy wartości parametrów id i parentId żądania 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 jest rejected.
badRequest (400) operationNotSupported Komentarze, które nie są oparte na Google+, oferują tylko ograniczoną funkcję moderowania.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Nie można ustawić stanu moderowania co najmniej jednego komentarza z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej 1 komentarza, który próbujesz zaktualizować. Sprawdź, czy wartości parametru id żądania są prawidłowe.

comments.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawiony zasób comment musi określać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiony zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Użytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu zdefiniowany przez właściwość snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżący przeglądający może odpowiedzieć w wątku.
badRequest (400) parentCommentIsPrivate Podany komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na komentarze prywatne.
badRequest (400) parentIdMissing Wstawiony komentarz musi być połączony z komentarzem nadrzędnym. Zasób comment w treści żądania do interfejsu API nie określa jednak wartości właściwości snippet.parentId.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest on prawidłowy.
forbidden (403) forbidden Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404) parentCommentNotFound Nie udało się znaleźć określonego komentarza nadrzędnego. Sprawdź w treści żądania, czy wartość właściwości snippet.parentId jest prawidłowa.

comments.markAsSpam

Typ błędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Komentarze, które nie pochodzą z Google+, nie mogą być oznaczane jako spam.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Co najmniej jednego komentarza nie udało się oznaczyć jako spam z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej 1 komentarza, który próbujesz zaktualizować. Sprawdź, czy wartości parametru id żądania są prawidłowe.

comments.delete

Typ błędu Szczegóły błędu Opis
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, ż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 zostać prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć określonego komentarza. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

comments.update

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextTooLong Zasób comment, który jest aktualizowany, zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Można aktualizować tylko komentarze oparte na Google+.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest on prawidłowy.
forbidden (403) forbidden Nie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby zaktualizować komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404) commentNotFound Nie udało się znaleźć określonego komentarza. Sprawdź w treści żądania, czy wartość właściwości id jest prawidłowa.

użytkownicy

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

members.list

Typ błędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzował żą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, który został pobrany w innym trybie niż ten określony.
badRequest (400) invalidPageToken Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, jeśli token strony użyty w prośbie wygasł.
badRequest (400) invalidHasAccessToLevel Wartość parametru hasAccessToLevel jest nieprawidłowa. Nie ma poziomu o podanym id.
badRequest (400) invalidFilterByMemberChannelId Wartość parametru filterByMemberChannelId jest nieprawidłowa. Ten błąd występuje wtedy, gdy wartość parametru filterByMemberChannelId określa więcej niż 100 kanałów.

Poziomy wspierania

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

membershipsLevels.list

Typ błędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzował żądanie, nie ma włączonego wspierania.

playlistaElementów

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów playlistItems. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

playlistItems.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie jest prawidłowo autoryzowane do usunięcia wskazanego elementu playlisty.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty z parametrem id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje usuwania filmów z określonej playlisty. Nie możesz np. usunąć filmu z przesłanej playlisty.

playlistItems.insert

Typ błędu Szczegóły błędu Opis
duplicate videoAlreadyInPlaylist Film, który próbujesz dodać do playlisty, znajduje się już na playliście.
forbidden (403) playlistContainsMaximumNumberOfVideos Playlista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403) playlistItemsNotAccessible Żądanie nie ma uprawnień do wstawienia określonego elementu playlisty.
invalidValue (400) invalidContentDetails Właściwość contentDetails w żądaniu jest nieprawidłowa. Prawdopodobna przyczyna jest to, że pole contentDetails.note ma więcej niż 280 znaków.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w polu snippet zasobu.
invalidValue (400) invalidResourceType Parametr type podany dla identyfikatora zasobu nie jest obsługiwany w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired Żądanie próbuje określić pozycję elementu playlisty, ale playlista nie jest sortowana ręcznie. (Na przykład elementy na playliście mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby pozycja z playlisty miała określoną pozycję, najpierw musisz w jej ustawieniach zmienić opcję Kolejność na Ręcznie. Te ustawienia możesz dostosować w Menedżerze filmów w YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Film, który próbujesz dodać do playlisty, znajduje się już na innej playliście.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje funkcji wstawiania filmów na określonej playliście. Na przykład nie możesz wstawić filmu do przesłanej playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu, który chcesz dodać do playlisty. Sprawdź, czy wartość właściwości videoId jest prawidłowa.
required (400) channelIdRequired Żądanie nie określa wartości wymaganej właściwości channelId.
required (400) playlistIdRequired Żądanie nie określa wartości wymaganej właściwości playlistId.
required (400) resourceIdRequired Żądanie musi zawierać zasób, w którym obiekt snippet określa właściwość resourceId.

playlistItems.list

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie jest prawidłowo autoryzowane do pobrania określonej playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu wskazanego w parametrze videoId żądania.
required (400) playlistIdRequired Prośba o subskrypcję nie określa wartości wymaganej właściwości playlistId.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje wyświetlania listy filmów z określonej playlisty. Na przykład nie możesz dodać filmu do playlisty Do obejrzenia.

playlistItems.update

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Prośba nie jest prawidłowo autoryzowana do aktualizowania wskazanego elementu playlisty.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w polu snippet zasobu.
invalidValue (400) invalidResourceType Parametr type podany dla identyfikatora zasobu nie jest obsługiwany w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) invalidSnippet Żądanie nie określa prawidłowej właściwości snippet.
invalidValue (400) manualSortRequired Żądanie próbuje określić pozycję elementu playlisty, ale playlista nie jest sortowana ręcznie. (Na przykład elementy na playliście mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby pozycja z playlisty miała określoną pozycję, najpierw musisz w jej ustawieniach zmienić opcję Kolejność na Ręcznie. Te ustawienia możesz dostosować w Menedżerze filmów w YouTube.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje aktualizowania filmów na określonej playliście. Na przykład nie możesz zaktualizować filmu na przesłanej playliście.
notFound (404) playlistItemNotFound Nie można znaleźć playlisty z właściwością id żądania.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
required (400) channelIdRequired Żądanie nie określa wartości wymaganej właściwości channelId.
required (400) playlistIdRequired Żądanie nie określa wartości wymaganej właściwości playlistId.
required (400) playlistItemIdRequired Aby wskazać element, który jest aktualizowany, playlista musi zawierać właściwość id.

playlist(y)

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów playlists. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

playlists.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje usuwania określonej playlisty. Nie możesz na przykład usunąć przesłanej playlisty filmów.

playlists.list

Typ błędu Szczegóły błędu Opis
forbidden (403) channelClosed Kanał określony w parametrze channelId został zamknięty.
forbidden (403) channelSuspended Kanał określony w parametrze channelId został zawieszony.
forbidden (403) playlistForbidden Playlista z parametrem id żądania nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
notFound (404) channelNotFound Nie można znaleźć kanału określonego w parametrze channelId.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wyświetlania określonej playlisty. Nie możesz na przykład dodać playlisty do obejrzenia później.

playlists.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Musisz skonfigurować właściwość defaultLanguage, aby zaktualizować localizations.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów playlist.
badRequest (400) maxPlaylistExceeded Nie można utworzyć playlisty, ponieważ na kanale jest już maksymalna dozwolona liczba playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
required (400) playlistTitleRequired Żądanie musi określać tytuł playlisty.

playlists.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Musisz skonfigurować właściwość defaultLanguage, aby zaktualizować localizations.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje aktualizowania określonej playlisty. Nie możesz na przykład zmieniać właściwości przesłanej playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
required (400) playlistTitleRequired Żądanie musi określać tytuł playlisty.

subskrypcje

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów subscriptions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

subscriptions.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) subscriptionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) subscriptionNotFound Nie udało się znaleźć subskrypcji, którą próbujesz usunąć. Sprawdź, czy wartość parametru id żądania 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 Zbyt wiele nowych subskrypcji. Spróbuj ponownie za kilka godzin.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwane.
forbidden (403) subscriptionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) publisherNotFound Nie można znaleźć zasobu określonego we właściwości snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie udało się znaleźć subskrybenta określonego w żądaniu.
required (400) publisherRequired Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId do identyfikacji subskrybowanego kanału.

subscriptions.list

Typ błędu Szczegóły błędu Opis
forbidden (403) accountClosed Nie udało się 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, która wysłała prośbę, nie ma dostępu do wybranych subskrypcji.
notFound (404) subscriberNotFound Nie udało się znaleźć subskrybenta określonego w żądaniu.

miniatury

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów thumbnails. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

thumbnails.set

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidImage Dostarczona treść obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści graficznych.
forbidden (403) forbidden Nie można ustawić miniatury dla określonego filmu. Żądanie może nie zostać 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, dla którego próbujesz wstawić miniaturę. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa.

VideoAbuseReportReasons

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videoAbuseReportReasons. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

videoAbuseReportReasons.list

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie zostać prawidłowo autoryzowane.

Kategorie filmów wideo

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videoCategories. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

videoCategories.list

Typ błędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie można znaleźć kategorii filmu wskazywanej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategory.list.

filmy

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videos. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

videos.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie próbuje dodać zlokalizowane szczegóły filmu bez określania domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDescription Metadane żądania podaj nieprawidłowy opis filmu.
badRequest (400) invalidFilename Nazwa pliku wideo podana w nagłówku Slug jest nieprawidłowa.
badRequest (400) invalidPublishAt Metadane żądania wskazują nieprawidłowy czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania.
badRequest (400) invalidTags Metadane żądania określają nieprawidłowe słowa kluczowe wideo.
badRequest (400) invalidTitle Metadane żądania podają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoGameRating Metadane żądania wskazują nieprawidłową ocenę gry wideo.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, gdy żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości obu 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ę przesłanych filmów.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Żądanie próbuje ustawić nieprawidłową licencję na film.
forbidden (403) forbiddenPrivacySetting Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności filmu.

videos.list

Typ błędu Szczegóły błędu Opis
badRequest (400) videoChartNotFound Żądany wykres wideo nie jest obsługiwany lub jest niedostępny.
forbidden (403) forbidden Żądanie nie ma uprawnień dostępu do pliku wideo lub informacji o przetwarzaniu. Pamiętaj, że fragmenty fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu.
forbidden (403) forbidden Prośba nie ma dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie jest poprawnie autoryzowane do używania parametru myRating.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz pobrać. Sprawdź, czy wartość parametru id żądania 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 zostać prawidłowo autoryzowane.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz usunąć. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie API próbuje dodać zlokalizowane szczegóły filmu bez określania domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDefaultBroadcastPrivacySetting Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności dla transmisji domyślnej.
badRequest (400) invalidDescription Metadane żądania podaj nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania wskazują nieprawidłowy czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania.
badRequest (400) invalidTags Metadane żądania określają nieprawidłowe słowa kluczowe wideo.
badRequest (400) invalidTitle Metadane żądania podają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, gdy żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości obu właściwości snippet.title i snippet.categoryId.
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) forbiddenEmbedSetting Żądanie próbuje skonfigurować nieprawidłowe ustawienie umieszczenia filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy podczas 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 skonfigurować nieprawidłowe ustawienie prywatności filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy pole id w treści żądania jest prawidłowe.

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 nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Wypożyczone filmy mogą być oceniane tylko przez użytkowników, którzy je wypożyczyli.
forbidden (403) forbidden Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył oceny tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.reportAbuse

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidAbuseReason Żądanie zawiera nieoczekiwaną wartość dla 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 udało się znaleźć filmu, którego dotyczy zgłoszenie nadużycia.

znaki wodne

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów watermarks. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

watermarks.set

Typ błędu Szczegóły błędu Opis
badRequest (400) imageFormatUnsupported Format podanego obrazu jest nieobsługiwany.
badRequest (400) imageTooTall Przesłany obraz jest za wysoki.
badRequest (400) imageTooWide Przesłany obraz jest za szeroki.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści graficznych.
forbidden (403) forbidden Nie można ustawić znaku wodnego dla konkretnego kanału. Żądanie może nie zostać prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.

watermarks.unset

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Znaku wodnego nie można cofnąć w przypadku określonego kanału. Żądanie może nie zostać prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.