YouTube Data API - Errors

Ten dokument określa różne typy błędów, które mogą zwracać operacje YouTube Data API. Listę błędów występujących w poszczególnych metodach znajdziesz też w jej dokumentacji.

Ogólne błędy

W tabelach poniżej znajdziesz listę komunikatów o błędach interfejsu API, które nie są związane z konkretną metodą 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ż Twój limit został przekroczony.

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 podanego konta Google.
forbidden (403) authenticatedUserAccountClosed Konto YouTube uwierzytelnionego użytkownika zostało zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd odnosi się do tego drugiego 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 odnosi się do tego drugiego konta.
forbidden (403) authenticatedUserNotChannel W przypadku tego żądania uwierzytelniony użytkownik musi połączyć się z kanałem, ale nie. Jeśli Twoje żądanie jest uwierzytelnione i używa parametru przekazywania uprawnień onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed Kanał wskazany w prośbie został zamknięty.
forbidden (403) channelNotFound Nie można znaleźć kanału wskazanego w żądaniu.
forbidden (403) channelSuspended Kanał wskazany w prośbie został zawieszony.
forbidden (403) cmsUserAccountNotFound Użytkownik systemu CMS nie może działać w imieniu podanego właściciela treści.
forbidden (403) insufficientCapabilities Użytkownik systemu CMS nie ma wystarczających uprawnień.
forbidden (403) insufficientPermissions Token OAuth 2.0 podany dla żądania określa zakresy, które są niewystarczające do uzyskania dostępu do żądanych danych.
notFound (404) contentOwnerAccountNotFound Nie znaleziono wskazanego 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 żądaniach, w przypadku których uwierzytelniony użytkownik jest partnerem YouTube. Usuń parametr mine, musisz się uwierzytelnić jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub pełnij funkcję jednego 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 zapisać w tym samym czasie.
badRequest (400) invalidRegionCode Parametr regionCode zawiera 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 korzysta z parametru mine, ale nie zostało poprawnie autoryzowane.
unauthorized (401) youtubeSignupRequired Ten błąd oznacza, że użytkownik ma niepołączone konto Google. Oznacza to, że ma on konto Google, ale nie ma kanału YouTube. Tacy użytkownicy mają dostęp do wielu funkcji, które wymagają autoryzacji użytkownika, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later. Jednak na przykład aby móc przesyłać filmy, użytkownik potrzebuje kanału w YouTube. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, z pewnością ma konto Google, ale być może nie połączył tego konta Google z kanałem YouTube.

Ten błąd często występuje podczas korzystania z protokołu konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi i jeśli spróbujesz uwierzytelnić się za pomocą konta usługi, wystąpi ten błąd.

W poście na blogu YouTube API opisującym obsługę kont Google szczegółowo omówiono błąd youtubeSignupRequired. Opis błędu w interfejsie API w wersji 2.1 objaśniono w poście na blogu, jednak jego znaczenie nadal ma znaczenie.

aktywności

Wycofaliśmy z YouTube funkcję biuletynu na kanale. 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 związane z zasobami 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 Ten interfejs API nie udostępnia danych o aktywności użytkownika na stronie głównej. Ten błąd może wystąpić, jeśli ustawisz parametr home na true w nieautoryzowanym żądaniu.
forbidden (403) forbidden Żądanie nie jest prawidłowo autoryzowane.
notFound (404) channelNotFound Nie można znaleźć identyfikatora kanału określonego w parametrze channelId żądania.
notFound (404) homeChannelNotFound Nie można znaleźć kanału strony głównej YouTube dla aktualnie uwierzytelnionego użytkownika.
unauthorized (401) authorizationRequired Żądanie korzysta z parametru home, ale nie zostało poprawnie autoryzowane.

captions

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

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 z napisami. Żądanie może nie być 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 z napisami. Prośba może nie być prawidłowo autoryzowana lub zamówienie filmu nie zezwala na dodawanie napisów do napisów przez osoby trzecie.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki z napisami na żądany język i/lub format. Sprawdź, czy żądane wartości tfmt i tlang są prawidłowe oraz czy snippet.status żądanej ścieżki napisów nie ma 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 z napisami.
conflict (409) captionExists Wskazany film ma już ścieżkę napisów z atrybutami 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ę.

Błąd można rozwiązać na kilka sposobów. Możesz usunąć istniejącą ścieżkę i wstawić nową lub zmienić jej nazwę przed wstawieniem.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do przesłania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
invalidValue (400) invalidMetadata Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie ścieżki audio. Sprawdź, czy żądanie określa prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Można użyć właściwości snippet.isDraft, ale nie jest to wymagane.
notFound (404) videoNotFound Nie udało się znaleźć filmu identyfikowanego przez parametr videoId.

captions.list

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie udało się pobrać co najmniej jednej ś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 jednej ze wskazanych ścieżek napisów. Ten błąd występuje, gdy parametr videoId identyfikuje film, ale parametr id identyfikuje nieistniejące identyfikatory ścieżek napisów lub identyfikatory ścieżek powiązane 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 identyfikowanego przez parametr videoId.

captions.update

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Żądanie nie przesłało zaktualizowanego pliku napisów. Rzeczywista zawartość ścieżki jest wymagana, jeśli parametr sync ma wartość true.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie wystarczą do zaktualizowania ścieżki napisów. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć wskazanej ścieżki z napisami. 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 związane z zasobami 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 grafiką kanału w YouTube zawiera zbyt wiele obrazów. Otwórz http://photos.google.com, otwórz stronę albumów i usuń niektóre ze zdjęć z tego albumu.
badRequest (400) mediaBodyRequired Żądanie nie zawiera zawartości obrazu.

Sekcje kanału

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 jest 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 określać wartość identyfikującą 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 można było wstawić lub zaktualizować obiekt localizations tego zasobu, należy ustawić właściwość snippet.defaultLanguage zasobu channelSection.
badRequest (400) invalidLanguage Jeden z kluczy języka obiektu localizations nie przeszedł weryfikacji. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Tej sekcji kanału nie można utworzyć.
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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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 jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400) channelNotActive Co najmniej jeden z podanych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ wskazano kanały zduplikowane.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i określić co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu miał podaną wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanałów nie należy stosować oczekiwanych kanałów.
invalidValue (400) contentDetailsNeeded Wstawianie zasobu musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelSectionExceeded Nie można zrealizować tej prośby, ponieważ kanał zawiera już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Nie można zrealizować żądania, ponieważ podjęto próbę dodania zbyt wielu kanałów do sekcji kanałów.
invalidValue (400) maxPlaylistExceeded Nie można zrealizować żądania, ponieważ podjęto próbę dodania 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 1 playlistę.
invalidValue (400) ownChannelInChannels Nie możesz dodać własnego kanału do wyświetlanej na nim sekcji kanału.
invalidValue (400) playlistIsPrivate Co najmniej jedna z podanych playlist jest prywatna, dlatego nie można ich umieścić w sekcji kanału.
invalidValue (400) playlistsDuplicated Nie można zrealizować żądania, ponieważ wskazano 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 Zasób podany w żądaniu miał podaną wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału playlisty nie są wymagane.
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 Zgłaszający nie ma dostępu do żądanych sekcji kanału.
invalidValue (400) idInvalid W żądaniu określono nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie można zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe.
notFound (404) channelNotFound Nie można znaleźć kanału powiązanego z żądaniem.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału powiązanej z żądaniem.

channelSections.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Aby można było wstawić lub zaktualizować obiekt localizations tego zasobu, należy ustawić właściwość snippet.defaultLanguage zasobu channelSection.
badRequest (400) invalidLanguage Jeden z kluczy języka obiektu localizations nie przeszedł weryfikacji. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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. Za pomocą metody channelSections.list możesz pobierać prawidłowe wartości i aktualizować je zgodnie ze wskazówkami zawartymi 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 jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
invalidValue (400) channelNotActive Co najmniej jeden z podanych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ wskazano kanały zduplikowane.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i określić co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu miał podaną wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanałów nie należy stosować oczekiwanych kanałów.
invalidValue (400) contentDetailsNeeded Aktualizowany zasób musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400) idInvalid Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) idRequired Właściwość id musi określać wartość identyfikującą aktualizowanej sekcję kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelsExceeded Nie można zrealizować żądania, ponieważ podjęto próbę dodania zbyt wielu kanałów do sekcji kanałów.
invalidValue (400) maxPlaylistExceeded Nie można zrealizować żądania, ponieważ podjęto próbę dodania 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 1 playlistę.
invalidValue (400) ownChannelInChannels Nie możesz dodać własnego kanału do wyświetlanej na nim sekcji kanału.
invalidValue (400) playlistIsPrivate Co najmniej jedna z podanych playlist jest prywatna, dlatego nie można ich umieścić w sekcji kanału.
invalidValue (400) playlistsDuplicated Nie można zrealizować żądania, ponieważ wskazano 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 Zasób podany w żądaniu miał podaną wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału playlisty nie są wymagane.
invalidValue (400) snippetNeeded Aby zaktualizować 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) 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, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami channels. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.

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 oraz forUsername. W przypadku uwierzytelniania właściciela treści 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 żądanie nie jest prawidłowo autoryzowane.
notFound (404) categoryNotFound Nie udało się znaleźć kategorii identyfikowanej 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 obiektu brandingSettings nie przeszła weryfikacji. Użyj metody channels.list, aby pobrać dotychczasowe ustawienia kanału i zaktualizować wartości właściwości zgodnie ze wskazówkami w dokumentacji zasobów channels.
badRequest (400) channelTitleUpdateForbidden Aktualizując 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ść. Jeśli zmienisz wartość właściwości, interfejs API zwróci błąd.
badRequest (400) defaultLanguageNotSetError Pole defaultLanguage musi być skonfigurowane do aktualizowania elementu localizations.
badRequest (400) invalidBrandingOption Jedno z podanych przez Ciebie ustawień marki nie istnieje. Za pomocą metody channels.list pobierz prawidłowe wartości i zaktualizuj je zgodnie ze wskazówkami zawartymi w dokumentacji zasobów channels.
badRequest (400) invalidCustomMessage Metadane żądania określają nieprawidłowy komunikat niestandardowy. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie wysłanym przez żą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 określa pozycję promowanego elementu w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie wysłanym przez żądanie.
badRequest (400) invalidRecentlyUploadedBy Metadane żądania zawierają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie wysłanym przez żądanie.
badRequest (400) invalidTimingOffset Metadane żądania określają nieprawidłowe przesunięcie czasu w części Invideopromotion.
badRequest (400) invalidTimingOffset Metadane żądania określają nieprawidłowe przesunięcie czasu, które określa, kiedy promowany element powinien wyświetlić się w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie wysłanym przez żądanie.
badRequest (400) invalidTimingType Metadane żądania określają nieprawidłową metodę określającą, kiedy promowany element powinien wyświetlić się w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie wysłanym przez żądanie.
badRequest (400) localizationValidationError Jedna z wartości obiektu lokalizacji nie powiodła się. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji dotyczącej kanałów.
badRequest (400) tooManyPromotedItems Przekroczono liczbę dozwolonych promowanych produktów w części dotyczącej promocji typu In-Video.
forbidden (403) channelForbidden Kanał podany w parametrze id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
forbidden (403) promotedVideoNotAllowed Nie można znaleźć kanału, który żądanie interfejsu API próbuje zaktualizować. Sprawdź wartość właściwości id w zasobie channel, z którego zostało wysłane żą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 budowania 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 określonego identyfikatora kanału lastUploadBy.
notFound (404) unknownVideoId Nie można znaleźć identyfikatora filmu określonego jako promowany produkt.
required (400) requiredItemIdType Metadane żądania muszą określać typ produktu w części Invideopromotion.
required (400) requiredItemId Metadane żądania muszą określać identyfikator produktu dla części Invideopromotion.
required (400) requiredTimingOffset Metadane żądania muszą określać domyślne przesunięcie czasu, tak aby YouTube mógł 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 mogło 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ą zawierać metodę pomiaru czasu, tak aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą zawierać metodę pomiaru czasu, tak aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie wysyłanym przez żądanie.
required (400) requiredTiming Metadane żądania muszą określać czas dla każdego elementu w części invideoPromotion.
required (400) requiredVideoId Metadane żądania muszą określać identyfikator filmu identyfikujący promowany produkt.
required (400) requiredWebsiteUrl Metadane żądania muszą określać adres URL witryny w części Invideopromotion. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie wysyłanym przez żądanie.

commentThreads

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 działa tylko w przypadku komentarzy z Google+.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Mimo że może to być błąd przejściowy, zwykle oznacza to, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowy.
forbidden (403) commentsDisabled W filmie identyfikowanym przez parametr videoId komentarze zostały wyłączone.
forbidden (403) forbidden Nie można pobrać co najmniej jednego żądanego 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 określonego za pomocą parametru channelId lub allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Nie można znaleźć co najmniej jednego ze wskazanych wątków komentarzy. Sprawdź, czy wartości parametru id żądania są prawidłowe.
notFound (404) videoNotFound Nie udało się znaleźć filmu identyfikowanego 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.
  • 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 pojawia się na karcie Dyskusja na tym kanale.
  • 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 jest wyświetlany na stronie odtwarzania filmu.
badRequest (400) commentTextRequired Wstawianie zasobu comment musi określać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawianie zasobu 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. Mimo że może to być błąd przejściowy, zwykle oznacza to, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowy.
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 komentarza, konto YouTube użyte do autoryzacji żądania 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źć wskazanego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa.

comments

Metoda comments.markAsSpam nie jest już obsługiwana.

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 identyfikatorów działa tylko w przypadku komentarzy z Google+.
forbidden (403) forbidden Nie można pobrać co najmniej jednego żądanego komentarza 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ź, 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 jego wartość moderationStatus to rejected.
badRequest (400) operationNotSupported Komentarze nieoparte na Google+ oferują ograniczoną funkcję moderowania.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Mimo że może to być błąd przejściowy, zwykle oznacza to, ż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 być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie można znaleźć co najmniej jednego komentarza, który próbuje zaktualizować żądanie. Sprawdź, czy wartości parametru id żądania są prawidłowe.

comments.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawianie zasobu comment musi określać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawianie zasobu 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żąca osoba przeglądająca może odpowiedzieć na wątek.
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ć powiązany z komentarzem nadrzędnym. Zasób comment w treści żądania 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. Mimo że może to być błąd przejściowy, zwykle oznacza to, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowy.
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 komentarza, konto YouTube użyte do autoryzacji żądania 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 Serwerowi interfejsu API nie udało się przetworzyć żądania. Mimo że może to być błąd przejściowy, zwykle oznacza to, ż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źć podanego komentarza. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

comments.update

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextTooLong Uaktualniany 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 Można aktualizować tylko komentarze z Google+.
badRequest (400) processingFailure Serwerowi interfejsu API nie udało się przetworzyć żądania. Mimo że może to być błąd przejściowy, zwykle oznacza to, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowy.
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 API musi być połączone z kontem Google użytkownika.
notFound (404) commentNotFound Nie udało się znaleźć podanego komentarza. Sprawdź, czy wartość właściwości id w treści żądania jest prawidłowa.

użytkownicy

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 Na kanale twórcy, który autoryzował prośbę, nie jest włączone wspieranie.
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ż 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 podanej wartości 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.

Poziomy wspierania

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 Na kanale twórcy, który autoryzował prośbę, nie jest włączone wspieranie.

playlistelementy

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 ma uprawnień do usunięcia określonego elementu playlisty.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty określonego za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie umożliwia usuwania filmów z określonej playlisty. Nie możesz na przykład usunąć filmu z playlisty z przesłanymi filmami.

playlistItems.insert

Typ błędu Szczegóły błędu Opis
duplicate videoAlreadyInPlaylist Film, który próbujesz dodać do playlisty, jest już na niej.
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. Możliwe, że pole contentDetails.note ma więcej niż 280 znaków.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić nieprawidłową lub nieobsługiwaną pozycję elementu playlisty. Sprawdź wartość właściwości position w sekcji snippet zasobu.
invalidValue (400) invalidResourceType Pole type określone dla identyfikatora zasobu nie jest obsługiwane w tej operacji. Identyfikator zasobu identyfikuje element, który ma być dodawany do playlisty – np. youtube#video.
invalidValue (400) manualSortRequired Żądanie ma na celu ustawienie pozycji elementu playlisty, ale playlista nie jest sortowana ręcznie. (na przykład elementy playlisty mogą być sortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby playlista zajmowała określoną pozycję na liście, musisz najpierw w jej ustawieniach zmienić jej opcję Kolejność na Ręcznie. Te ustawienia można zmienić w Menedżerze filmó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 wstawiania filmów do wskazanej playlisty. Nie możesz na przykład wstawić filmu do playlisty z przesłanymi filmami.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej parametrem 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 resourceId.

playlistItems.list

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma uprawnień do pobrania określonej playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej parametrem playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu określonego za pomocą parametru 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. Nie możesz na przykład dodać filmu do playlisty Do obejrzenia.

playlistItems.update

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma uprawnień do aktualizacji określonego elementu playlisty.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić nieprawidłową lub nieobsługiwaną pozycję elementu playlisty. Sprawdź wartość właściwości position w sekcji snippet zasobu.
invalidValue (400) invalidResourceType Pole type określone dla identyfikatora zasobu nie jest obsługiwane w tej operacji. Identyfikator zasobu identyfikuje element, który ma być dodawany do playlisty – np. youtube#video.
invalidValue (400) invalidSnippet Żądanie nie określa prawidłowej właściwości snippet.
invalidValue (400) manualSortRequired Żądanie ma na celu ustawienie pozycji elementu playlisty, ale playlista nie jest sortowana ręcznie. (na przykład elementy playlisty mogą być sortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby playlista zajmowała określoną pozycję na liście, musisz najpierw w jej ustawieniach zmienić jej opcję Kolejność na Ręcznie. Te ustawienia można zmienić w Menedżerze filmó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 z playlisty z przesłanymi filmami.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty określonego za pomocą właściwości id żądania.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej parametrem 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 Zasób elementu playlisty określony w żądaniu musi używać właściwości id, aby wskazać aktualizowany element playlisty.

playlisty

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 poprawnie autoryzowane.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej parametrem id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usunięcia określonej playlisty. Nie możesz na przykład usunąć playlisty z przesłanymi filmami.

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 wskazana 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 wskazywanej parametrem id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje wyświetlania listy wskazanej playlisty. Nie możesz na przykład wyświetlić listy filmów do obejrzenia później.

playlists.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Pole defaultLanguage musi być skonfigurowane do aktualizowania elementu localizations.
badRequest (400) localizationValidationError Jedna z wartości obiektu lokalizacji nie powiodła się. Użyj metody playlists.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji dotyczącej zasobów playlist.
badRequest (400) maxPlaylistExceeded Nie można utworzyć playlisty, ponieważ na kanale znajduje się już maksymalna dozwolona liczba playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest poprawnie autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
required (400) playlistTitleRequired Prośba musi zawierać tytuł playlisty.

playlists.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Pole defaultLanguage musi być skonfigurowane do aktualizowania elementu localizations.
badRequest (400) localizationValidationError Jedna z wartości obiektu lokalizacji nie powiodła się. Użyj metody playlists.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji dotyczącej zasobów playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest poprawnie 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żna na przykład aktualizować właściwości playlisty z przesłanymi filmami.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej parametrem id żądania.
required (400) playlistTitleRequired Prośba musi zawierać tytuł playlisty.

subskrypcje

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) subscriptionNotFound Nie można 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 subskrypcji w ostatnim czasie. Spróbuj ponownie za kilka godzin.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwane.
forbidden (403) subscriptionForbidden Żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału.
notFound (404) publisherNotFound Nie udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta wskazanego w żądaniu.
required (400) publisherRequired Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId, aby zidentyfikować zasubskrybowany kanał.

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 zgłaszająca nie ma dostępu do żądanych subskrypcji.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta wskazanego w żądaniu.

miniatury

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 Zawartość obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Żądanie nie zawiera zawartoś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, dla którego próbujesz wstawić obraz miniatury. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa.
tooManyRequests (429) uploadRateLimitExceeded Na kanał przesłano ostatnio zbyt wiele miniatur. Spróbuj jeszcze raz później.

Przyczyny zgłaszania nadużyć przez film

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 być prawidłowo autoryzowane.

kategoriewideo

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

videoCategories.list

Typ błędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie można znaleźć kategorii filmu określonej 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 związane z zasobami 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 ma na celu dodanie zlokalizowanych szczegółów 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 określają 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 zaplanowanej publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe wideo.
badRequest (400) invalidTitle Metadane żądania określają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoGameRating Metadane żądania określają nieprawidłową ocenę gry wideo.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości dla właściwości snippet.title ani snippet.categoryId.
badRequest (400) mediaBodyRequired Żądanie nie obejmuje treści wideo.
badRequest (400) uploadLimitExceeded Użytkownik przekroczył liczbę filmów, które może przesłać.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Prośba próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403) forbiddenPrivacySetting Prośba próbuje określić 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 niedostępny.
forbidden (403) forbidden Prośba nie ma odpowiedniego upoważnienia do uzyskania dostępu do pliku wideo lub informacji o przetwarzaniu. Pamiętaj, że części fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu.
forbidden (403) forbidden Żądanie nie może uzyskać dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie ma poprawnej autoryzacji do korzystania z 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 chcesz usunąć. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) videoNotFound Nie można znaleźć filmu, który chcesz usunąć. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie do interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez okreś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 ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji.
badRequest (400) invalidDescription Metadane żądania określają nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania określają nieprawidłowy czas zaplanowanej publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe wideo.
badRequest (400) invalidTitle Metadane żądania określają 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 dla właściwości snippet.title ani snippet.categoryId.
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) forbiddenEmbedSetting Żądanie próbuje ustawić nieprawidłowe ustawienie umieszczania filmu na stronie. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy w transmisjach na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403) forbiddenLicenseSetting Prośba próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403) forbiddenPrivacySetting Prośba próbuje określić nieprawidłowe ustawienie prywatności filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość w polu 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 zweryfikować swój adres e-mail.
badRequest (400) invalidRating Żądanie zawiera nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Wypożyczone filmy mogą oceniać tylko użytkownicy, którzy je wypożyczyli.
forbidden (403) forbidden Nie można ocenić filmu, który próbujesz 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ść oceny tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który chcesz 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ść 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 znaleziono filmu, którego dotyczy nadużycie.

znaki wodne,

W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami 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 Przesłany obraz ma nieobsługiwany format.
badRequest (400) imageTooTall Przesłane zdjęcie jest za wysokie.
badRequest (400) imageTooWide Przesłane zdjęcie jest za szerokie.
badRequest (400) mediaBodyRequired Żądanie nie zawiera zawartości obrazu.
forbidden (403) forbidden Znaku wodnego nie można ustawić na określonym kanale. Żądanie może nie być prawidłowo 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 na określonym kanale. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.