YouTube Data API - Errors

W tym dokumencie opisujemy różne typy błędów, które mogą zwracać operacje YouTube Data API. Listę błędów związanych z poszczególnymi metodami znajdziesz w jej dokumentacji.

Ogólne błędy

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

Core API errors

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
quotaExceeded (403) quotaExceeded Nie można zrealizować tej prośby, ponieważ przekroczony został 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 podanego konta Google.
forbidden (403) authenticatedUserAccountClosed Konto YouTube uwierzytelnionego użytkownika jest zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd 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 przejść do kanału, ale nie. Jeśli żądanie jest uwierzytelniane 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 udało się 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 w żądaniu parametru mine 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. Usuń parametr mine, usuń parametr onBehalfOfContentOwner, aby uwierzytelnić się jako użytkownik YouTube, albo skorzystaj z funkcji 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 niektóre części, których nie można zapisać w tym samym czasie.
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 niepołączone konto Google. Oznacza to, że ma on konto Google, ale nie ma kanału YouTube. Tacy użytkownicy mogą korzystać z wielu funkcji, które wymagają autoryzacji użytkownika, takich jak ocenianie filmów i dodawanie filmów do playlisty watch_later. Jednak na przykład, aby móc przesłać film, użytkownik musi mieć kanał w YouTube. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, z pewnością ma konto Google, ale mógł nie powiązać tego konta Google z kanałem YouTube.

Ten błąd często występuje podczas korzystania z procedury dotyczącej konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi. Jeśli spróbujesz uwierzytelnić się przy użyciu konta usługi, zobaczysz ten błąd.

Ten błąd pojawi się w poście na blogu YouTube API przedstawiającym pomoc dotyczącą kont Google, a także szczegółowo opisuje błąd youtubeSignupRequired. Chociaż w poście na blogu wyjaśniono, jaki błąd występuje w interfejsie API w wersji 2.1, jego znaczenie nadal ma zastosowanie.

aktywności

Funkcja biuletynu kanału została wycofana w YouTube. 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 związane z żądaniami.

activities.list

Typ błędu Szczegóły błędu Opis
forbidden (403) homeParameterDeprecated Ten interfejs API nie ma dostępu do danych o aktywności użytkownika na stronie głównej. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na true.
forbidden (403) forbidden Żądanie nie jest poprawnie autoryzowane.
notFound (404) channelNotFound Nie udało się znaleźć identyfikatora kanału określonego przez parametr channelId żądania.
notFound (404) homeChannelNotFound W przypadku aktualnie uwierzytelnionego użytkownika nie można znaleźć kanału na stronie głównej YouTube.
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 związane z zasobami captions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy związane z żądaniami.

captions.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do usunięcia ścieżki z napisami. Żądanie może nie być poprawnie 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. Żądanie może nie być odpowiednio autoryzowane lub zamówienie filmu nie umożliwia przesyłania napisów przez osoby trzecie.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki z napisami na żądany język 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ę z napisami snippet.language i snippet.name. Film może zawierać wiele ścieżek w tym samym języku, ale każda z nich musi mieć inną nazwę.

Błąd można rozwiązać na kilka sposobów. Możesz usunąć istniejącą ścieżkę, a następnie wstawić nową, lub zmienić nazwę nowej, zanim ją wstawisz.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do przesłania ścieżki z napisami. Żądanie może nie być poprawnie autoryzowane.
invalidValue (400) invalidMetadata Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie ścieżki. Potwierdź, że w żądaniu określone są prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Możesz też dołączyć właściwość snippet.isDraft, ale nie jest ona wymagana.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.
invalidValue (400) nameTooLong Pole snippet.name w żądaniu jest za długie. Maksymalna obsługiwana długość to 150 znaków.

captions.list

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie udało się pobrać co najmniej 1 ścieżki napisów, ponieważ uprawnienia powiązane z żądaniem są niewystarczające do pobrania żądanych zasobów. Żądanie może nie być poprawnie autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć co najmniej jednej podanej ścieżki z napisami. Ten błąd występuje wtedy, gdy parametr videoId identyfikuje film, ale parametr id identyfikuje nieistniejące identyfikatory ścieżek napisów 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 Żą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 są wystarczające do aktualizacji ścieżki napisów. Żądanie może nie być poprawnie autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć wskazanej ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

channelBanners

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 związane z żądaniami.

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 zdjęcia z tego albumu.
badRequest (400) mediaBodyRequired Żądanie nie zawiera obrazów.

channelSections

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 związane z żądaniami.

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 Właściwość snippet.defaultLanguage zasobu channelSection musi być ustawiona, aby można było wstawić lub zaktualizować obiekt localizations tego zasobu.
badRequest (400) invalidLanguage Jeden z kluczy języka obiektu localizations nie przeszedł weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
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. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) targetInvalidLanguage Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) targetInvalidRegion Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
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 zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[], która musi określać co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu ma podaną wartość właściwości contentDetails.channels[], ale w przypadku sekcji kanałów tego typu nie należy spodziewać się kanałów.
invalidValue (400) contentDetailsNeeded Wstawiony zasób 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ł ma już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Żądanie nie zostało zrealizowane, ponieważ chciała uwzględnić zbyt wiele kanałów w sekcji kanałów.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ usiłowano uwzględnić zbyt wiele playlist w 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ć swojego kanału do sekcji kanału, która się na nim wyświetla.
invalidValue (400) playlistIsPrivate Co najmniej jedna z podanych playlist jest prywatna i dlatego nie można ich uwzględnić w sekcji kanału.
invalidValue (400) playlistsDuplicated Żądanie nie zostało zrealizowane, 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 ma podaną wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie należy tworzyć 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 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 podano nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) invalidCriteria Nie udało się zrealizować żądania, ponieważ kryteria filtra są nieprawidłowe.
notFound (404) channelNotFound Nie udało się znaleźć kanału powiązanego z prośbą.
notFound (404) channelSectionNotFound Nie udało się znaleźć sekcji kanału powiązanej z prośbą.

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 wstawić lub zaktualizować obiekt localizations tego zasobu.
badRequest (400) invalidLanguage Jeden z kluczy języka obiektu localizations nie przeszedł weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
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. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) targetInvalidLanguage Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) targetInvalidRegion Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
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 zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[], która musi określać co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu ma podaną wartość właściwości contentDetails.channels[], ale w przypadku sekcji kanałów tego typu nie należy spodziewać się kanałów.
invalidValue (400) contentDetailsNeeded Zasób, który aktualizujesz, 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ą aktualizowaną sekcję kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelsExceeded Żądanie nie zostało zrealizowane, ponieważ chciała uwzględnić zbyt wiele kanałów w sekcji kanałów.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ usiłowano uwzględnić zbyt wiele playlist w 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ć swojego kanału do sekcji kanału, która się na nim wyświetla.
invalidValue (400) playlistIsPrivate Co najmniej jedna z podanych playlist jest prywatna i dlatego nie można ich uwzględnić w sekcji kanału.
invalidValue (400) playlistsDuplicated Żądanie nie zostało zrealizowane, 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 ma podaną wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie należy tworzyć playlist.
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 związane z żądaniami.

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. 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 przez parametr id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
notFound (404) categoryNotFound Nie udało się znaleźć kategorii określonej przez parametr categoryId. Aby pobrać listę prawidłowych wartości, użyj metody guideCategories.list.
notFound (404) channelNotFound Nie udało się 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 z wytycznymi podanymi 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 defaultLanguage musi być skonfigurowany do aktualizowania localizations.
badRequest (400) invalidBrandingOption Jedno z podanych przez Ciebie ustawień marki nie istnieje. Aby pobrać prawidłowe wartości, użyj metody channels.list i zaktualizuj je zgodnie ze wskazówkami podanymi 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 decydujący o pozycji promowanego elementu w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie wysłanym przez żądanie.
badRequest (400) invalidRecentlyUploadedBy Metadane żądania określają 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 ma zostać wyświetlony 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 pojawić 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 localizations nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody channels.list i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobów kanałów.
badRequest (400) tooManyPromotedItems Przekroczono liczbę dozwolonych promowanych produktów w części InvideoPromotion.
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, do 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 udało się 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 lastUploadBy.
notFound (404) unknownVideoId Nie udało się 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ć element w części InvideoPromotion.
required (400) requiredTimingOffset Metadane żądania muszą określać domyślne przesunięcie czasu, tak aby serwis 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ć opóźnienie, tak aby serwis 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ę realizacji czasu, tak aby serwis 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ą określać metodę realizacji czasu, tak aby serwis 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 związane z żądaniami.

commentThreads.list

Typ błędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. W rezultacie serwer interfejsu API nie mógł zrozumieć żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) commentsDisabled W filmie określonym przez parametr videoId wyłączono komentarze.
forbidden (403) forbidden Nie udało się pobrać co najmniej jednego z żądanych wątków komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie autoryzowane.
notFound (404) channelNotFound Nie udało się znaleźć kanału określonego przez parametr allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Nie udało się znaleźć co najmniej jednego 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ć powiązany z kanałem lub filmem. Upewnij się, że zasób określa wartości dla właściwości snippet.channelId i snippet.videoId. Komentarz do filmu jest wyświetlany na stronie odtwarzania filmu.
badRequest (400) commentTextRequired Wstawiane zasób comment musi określać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiane zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Metadane żądania są nieprawidłowe.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Wątek z komentarzami mógł zostać utworzony z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarza, konto YouTube używane do autoryzacji żądania do interfejsu API musi być scalone z kontem Google użytkownika.
notFound (404) channelNotFound Nie udało się znaleźć wskazanego 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 związane z żądaniami.

comments.list

Typ błędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. W rezultacie serwer interfejsu API nie mógł zrozumieć żądania.
forbidden (403) forbidden Nie udało się pobrać co najmniej jednego z żądanych komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie 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 to rejected.
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. W rezultacie serwer interfejsu API nie mógł zrozumieć żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, ż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ć poprawnie autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej jednego komentarza, który ma zostać zaktualizowany przez żądanie. Sprawdź, czy wartości parametru id żądania są prawidłowe.

comments.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawiane zasób comment musi określać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiane 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żąca osoba przeglądająca 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ć powiązany z komentarzem nadrzędnym. Zasób comment w treści żądania API nie określał jednak wartości dla właściwości snippet.parentId.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) ineligibleAccount Aby wstawić komentarz lub wątek komentarza, konto YouTube używane do autoryzacji żądania do interfejsu API musi być scalone z kontem Google użytkownika.
notFound (404) parentCommentNotFound Nie udało się znaleźć podanego komentarza nadrzędnego. Sprawdź, czy wartość właściwości snippet.parentId w treści żądania jest prawidłowa.

comments.delete

Typ błędu Szczegóły błędu Opis
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Nie udało się usunąć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie 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 Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. W rezultacie serwer interfejsu API nie mógł zrozumieć żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Chociaż może to być błąd przejściowy, zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) ineligibleAccount Aby można było zaktualizować komentarz lub wątek komentarza, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404) commentNotFound Nie udało się znaleźć podanego komentarza. Sprawdź, czy wartość właściwości id w treści żądania jest prawidłowa.

członkowie

W tabelach poniżej znajdziesz komunikaty o błędach, 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 związane z żądaniami.

members.list

Typ błędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzował prośbę, nie ma włączonego wspierania kanału.
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.

membershipsLevels

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 związane z żądaniami.

membershipsLevels.list

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

playlistItems

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 związane z żądaniami.

playlistItems.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma prawidłowej autoryzacji do usunięcia określonego elementu playlisty.
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty określonego za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usuwania filmów ze wskazanej 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 prawidłowej autoryzacji 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ć pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w parametrze snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona dla identyfikatora zasobu nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired W żądaniu jest ustalona pozycja elementu playlisty, ale sortowanie playlisty nie jest wykonywane ręcznie. (na przykład elementy playlist 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 element playlisty miał określoną pozycję na liście, musisz najpierw zmienić opcję Kolejność na Ręczna w jej ustawieniach. Te ustawienia można dostosować 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 funkcji wstawiania filmów do wskazanej playlisty. Nie możesz na przykład wstawić filmu do playlisty przesłanych filmów.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz 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 jest prawidłowo autoryzowane do pobrania określonej playlisty.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego za pomocą parametru videoId żądania.
required (400) playlistIdRequired W żądaniu subskrypcji nie określono wartości wymaganej właściwości playlistId.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje wyświetlania listy filmów ze wskazanej playlisty. Nie możesz na przykład umieścić filmu na playliście Do obejrzenia.

playlistItems.update

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie jest poprawnie autoryzowane do aktualizacji 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 parametrze snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona dla identyfikatora zasobu nie jest obsługiwana 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 W żądaniu jest ustalona pozycja elementu playlisty, ale sortowanie playlisty nie jest wykonywane ręcznie. (na przykład elementy playlist 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 element playlisty miał określoną pozycję na liście, musisz najpierw zmienić opcję Kolejność na Ręczna w jej ustawieniach. Te ustawienia można dostosować 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 aktualizować filmu na playliście z przesłanymi filmami.
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty wskazanego we właściwości id żądania.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej 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 Zasób playlisty określony w żądaniu musi używać właściwości id do identyfikowania aktualizowanych elementów 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 związane z żądaniami.

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 udało się znaleźć playlisty określonej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usunięcia wskazanej 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 określona z parametrem id żądania nie obsługuje żądania lub nie jest ono prawidłowo autoryzowane.
notFound (404) channelNotFound Nie udało się znaleźć kanału określonego w parametrze channelId.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wyświetlenia wskazanej playlisty. Nie możesz na przykład wyświetlić playlisty Do obejrzenia.

playlists.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError defaultLanguage musi być skonfigurowany do aktualizowania localizations.
badRequest (400) localizationValidationError Jedna z wartości obiektu localizations nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami podanymi w dokumentacji dotyczącej 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 kodu playlisty.
required (400) playlistTitleRequired Prośba musi zawierać tytuł playlisty.

playlists.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError defaultLanguage musi być skonfigurowany do aktualizowania localizations.
badRequest (400) localizationValidationError Jedna z wartości obiektu localizations nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami podanymi w dokumentacji dotyczącej 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 kodu 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 udało się znaleźć playlisty określonej za pomocą parametru 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 związane z żądaniami.

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 Osiągnięto maksymalną liczbę subskrypcji.
badRequest (400) subscriptionForbidden W ostatnim czasie zasubskrybowano zbyt wiele treści. Spróbuj ponownie za kilka godzin.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwana.
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 udało się znaleźć subskrybenta wskazanego w żądaniu.
required (400) publisherRequired Zasób subskrypcji podany w prośbie musi używać właściwości snippet.resourceId do identyfikowania 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 Zgłaszający nie ma dostępu do żądanych subskrypcji.
notFound (404) subscriberNotFound Nie udało się 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 związane z żądaniami.

thumbnails.set

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidImage Zawartość przesłanego obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Żądanie nie zawiera obrazów.
forbidden (403) forbidden Nie można ustawić miniatury dla określonego filmu. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) forbidden Uwierzytelniony użytkownik nie ma uprawnień do przesyłania ani 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.
tooManyRequests (429) uploadRateLimitExceeded Na kanał przesłano ostatnio zbyt wiele miniatur. Spróbuj przesłać prośbę ponownie później.

videoAbuseReportReasons

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 związane z żądaniami.

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

Typ błędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie udało się znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.

filmy

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

videos.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie ma na celu dodanie zlokalizowanych szczegółów filmu bez określenia domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDescription Metadane żądania 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 określają 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 W żądaniu nie ma treści wideo.
badRequest (400) uploadLimitExceeded Użytkownik przekroczył liczbę filmów, które może przesłać.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting To żądanie próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403) forbiddenPrivacySetting Żądanie stanowi próbę ustawienia nieprawidłowego ustawienia 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 Żądanie nie ma poprawnie uprawnień dostępu do pliku wideo lub informacji o przetwarzaniu. Części fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela tego filmu.
forbidden (403) forbidden Żądanie nie może uzyskać dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie jest prawidłowo autoryzowane do użycia parametru myRating.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz odzyskać. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Filmu, który próbujesz usunąć, nie można usunąć. Żądanie może nie być poprawnie 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 do interfejsu API ma na celu dodanie zlokalizowanych szczegółów filmu bez określenia domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDefaultBroadcastPrivacySetting Wystąpiła próba ustawienia nieprawidłowego ustawienia 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 określają 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 W żądaniu zażądano ustawienia nieprawidłowego ustawienia umieszczania filmu. Niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzacza umieszczonego na stronie internetowej w przypadku transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403) forbiddenLicenseSetting To żądanie próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403) forbiddenPrivacySetting Żądanie stanowi próbę ustawienia nieprawidłowego ustawienia 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 potwierdzić swój adres e-mail.
badRequest (400) invalidRating Żądanie zawiera nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Wypożyczone filmy mogą oceniać tylko te użytkowników, którzy je wypożyczyli.
forbidden (403) forbidden Nie można ocenić filmu wideo, który próbujesz ocenić. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył możliwość oceniania tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, 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 kombinacji pól reason_id i secondary_reason_id.
badRequest (400) rateLimitExceeded Użytkownik wysłał zbyt wiele żądań w danym okresie.
forbidden (403) forbidden
notFound (404) videoNotFound Nie można znaleźć filmu, który chcesz zgłosić jako nadużycie.

watermarks

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 związane z żądaniami.

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 obrazów.
forbidden (403) forbidden Znaku wodnego nie można ustawić dla wskazanego kanału. Żą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 dla wybranego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.