YouTube Data API - Errors

W tym dokumencie opisujemy różne typy błędów, które mogą wystąpić podczas wykonywania operacji YouTube Data API. Listę błędów dla każdej metody znajdziesz też w dokumentacji referencyjnej tej metody.

Ogólne błędy

W tabelach poniżej znajdziesz komunikaty o błędach interfejsu API, które nie są związane z konkretną metodą interfejsu API.

Core API errors

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenDostęp zabroniony. Prośba może nie być prawidłowo autoryzowana.
quotaExceeded (403)quotaExceededNie możemy zrealizować tej prośby, ponieważ został przekroczony limit.

Common request errors

Typ błęduSzczegóły błęduOpis
badRequest (400)incompatibleParametersŻądanie zawiera co najmniej 2 parametry, których nie można użyć w tym samym żądaniu.
badRequest (400)invalidFiltersŻądanie zawiera nieprawidłowy parametr filtra.
badRequest (400)invalidPageTokenŻądanie zawiera nieprawidłowy token strony.
badRequest (400)missingRequiredParameterBrakuje wymaganego parametru.
badRequest (400)unexpectedParameterŻądanie zawiera nieoczekiwany parametr.
forbidden (403)accountDelegationForbiddenUżytkownik uwierzytelniony nie może działać w imieniu określonego konta Google.
forbidden (403)authenticatedUserAccountClosedKonto 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)authenticatedUserAccountSuspendedKonto 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)authenticatedUserNotChannelW przypadku tego żądania uwierzytelniony użytkownik musi być kanałem, ale nie jest. Jeśli żądanie jest uwierzytelniane i używa parametru delegowania onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel.
forbidden (403)channelClosedKanał wskazany w żądaniu został zamknięty.
forbidden (403)channelNotFoundNie udało się znaleźć kanału wskazanego w żądaniu.
forbidden (403)channelSuspendedKanał wskazany w żądaniu został zawieszony.
forbidden (403)cmsUserAccountNotFoundUżytkownik CMS nie może działać w imieniu określonego właściciela treści.
forbidden (403)insufficientCapabilitiesUżytkownik CMS ma niewystarczające uprawnienia.
forbidden (403)insufficientPermissionsToken OAuth 2.0 podany w żądaniu określa zakresy, które nie wystarczają do uzyskania dostępu do żądanych danych.
notFound (404)contentOwnerAccountNotFoundNie znaleziono podanego konta właściciela treści.

Request context errors

Typ błęduSzczegóły błęduOpis
badRequest (400)invalidLanguageWartość parametru hl nie określa prawidłowego kodu języka.
badRequest (400)invalidMineUżywanie parametru mine w żądaniu nie jest obsługiwane.
badRequest (400)invalidMineParametru mine nie można używać w żądaniach, w których uwierzytelniony użytkownik jest partnerem YouTube. Należy usunąć parametr mine, uwierzytelnić się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działać jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest dostępny w przypadku wywoływanej metody.
badRequest (400)invalidPartParametr part w żądaniu określa niektóre części, które nie mogą być zapisane w tym samym czasie.
badRequest (400)invalidRegionCodeParametr regionCode określa nieprawidłowy kod regionu.
badRequest (400)unexpectedPartParametr part w żądaniu ma nieoczekiwaną wartość.
badRequest (400)unknownPartParametr part w żądaniu określa nieznaną wartość.
badRequest (400)unsupportedLanguageCodeWartość parametru hl nie określa obsługiwanego kodu języka.
badRequest (400)unsupportedRegionCodeParametr regionCode określa nieobsługiwany kod regionu.
unauthorized (401)authorizationRequiredŻądanie używa parametru mine, ale nie jest prawidłowo autoryzowane.
unauthorized (401)youtubeSignupRequiredTen błąd wskazuje, że użytkownik ma niepołączone konto Google, co oznacza, że ma konto Google, ale nie ma kanału w YouTube. Taki użytkownik może korzystać z wielu funkcji, które wymagają autoryzacji użytkownika, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later. Aby 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 może nie mieć jeszcze połączonego z nim kanału w YouTube.

Ten błąd występuje często, gdy próbujesz użyć procesu dotyczącego konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi. Jeśli spróbujesz uwierzytelnić się za pomocą konta usługi, pojawi się ten błąd.

W poście na blogu YouTube API, w którym przedstawiamy obsługę konta Google, znajdziesz więcej informacji o błędzie youtubeSignupRequired. Chociaż w poście na blogu wyjaśniono błąd w wersji 2.1 interfejsu API, jego znaczenie jest nadal aktualne.

aktywności

Funkcja biuletynu kanału została wycofana z YouTube. Metoda activities.insert nie jest już obsługiwana.

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami activities. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

activities.list

Typ błęduSzczegóły błęduOpis
forbidden (403)homeParameterDeprecatedDane o aktywności użytkownika na stronie głównej nie są dostępne za pomocą tego interfejsu API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu parametr home ma wartość true.
forbidden (403)forbiddenżądanie nie jest prawidłowo autoryzowane;
notFound (404)channelNotFoundNie udało się znaleźć identyfikatora kanału określonego przez parametr channelId żądania.
notFound (404)homeChannelNotFoundNie udało się znaleźć kanału na stronie głównej YouTube dla aktualnie uwierzytelnionego użytkownika.
unauthorized (401)authorizationRequiredŻądanie używa parametru home, ale nie jest prawidłowo autoryzowane.

napisy

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami captions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

captions.delete

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenUprawnienia powiązane z żądaniem nie są wystarczające do usunięcia ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
notFound (404)captionNotFoundNie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

captions.download

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenUprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
invalidValue (400)couldNotConvertNie udało się przekonwertować danych ścieżki z napisami na wybrany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe oraz że snippet.status żądanego ścieżki napisów nie jest failed.
notFound (404)captionNotFoundNie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

captions.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)contentRequiredŻądanie nie zawiera treści ścieżki z napisami.
conflict (409)captionExistsPodany film ma już ścieżkę z napisami z podanymi wartościami snippet.language i snippet.name. Film może zawierać wiele ścieżek w tym samym języku, ale każda ścieżka musi mieć inną nazwę.

Istnieje kilka sposobów na rozwiązanie tego problemu. Możesz usunąć istniejący utwór, a następnie wstawić nowy lub zmienić nazwę nowego utworu przed jego wstawieniem.
forbidden (403)forbiddenUprawnienia powiązane z żądaniem nie są wystarczające do przesłania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
invalidValue (400)invalidMetadataŻądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie utworu. Sprawdź, czy żądanie zawiera prawidłowe wartości właściwości snippet.language, snippet.namesnippet.videoId. Możesz też podać właściwość snippet.isDraft, ale nie jest to wymagane.
notFound (404)videoNotFoundNie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
invalidValue (400)nameTooLongW żądaniu podany parametr snippet.name jest za długi. Maksymalna długość to 150 znaków.

captions.list

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenNie udało się pobrać co najmniej 1 ścieżki z napisami, ponieważ uprawnienia związane z żądaniem są niewystarczające do pobrania żądanych zasobów. Prośba może nie być prawidłowo autoryzowana.
notFound (404)captionNotFoundNie udało się znaleźć co najmniej 1 z podanych ścieżek z napisami. Ten błąd występuje, gdy parametr videoId identyfikuje rzeczywisty film, ale parametr id identyfikuje identyfikatory ścieżek napisów, które nie istnieją, lub identyfikatory ścieżek powiązane z innymi filmami. Sprawdź, czy parametry żądania idvideoId są prawidłowe.
notFound (404)videoNotFoundNie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.

captions.update

Typ błęduSzczegóły błęduOpis
badRequest (400)contentRequiredW żądaniu nie przesłano zaktualizowanego pliku napisów. Jeśli parametr sync ma wartość true, wymagane jest rzeczywiste zawartość ścieżki.
forbidden (403)forbiddenUprawnienia powiązane z żądaniem nie są wystarczające do zaktualizowania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
notFound (404)captionNotFoundNie udało się znaleźć określonej ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

channelBanners

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channelBanners. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

channelBanners.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)bannerAlbumFullTwój album z grafiką kanału w YouTube zawiera zbyt wiele obrazów. Otwórz stronę http://photos.google.com, przejdź na stronę albumów i usuń niektóre zdjęcia z tego albumu.
badRequest (400)mediaBodyRequiredProśba nie zawiera treści obrazu.

channelSections

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channelSections. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

channelSections.delete

Typ błęduSzczegóły błęduOpis
badRequest (400)notEditableTej sekcji kanału nie można usunąć.
forbidden (403)channelSectionForbiddenżądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane na tym kanale;
invalidValue (400)idInvalidWłaściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)idRequiredWłaściwość id musi zawierać wartość identyfikującą usuwany fragment kanału.
notFound (404)channelNotFoundNie znaleziono kanału.
notFound (404)channelSectionNotFoundNie można znaleźć sekcji kanału, którą próbujesz zaktualizować.

channelSections.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetErrorAby móc wstawić lub zaktualizować obiekt localizations dla zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400)invalidLanguageJeden z kluczy języka obiektu localizations nie został zweryfikowany. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)notEditableNie można utworzyć tej sekcji kanału.
badRequest (400)styleRequiredZasób channelSection musi zawierać wartość w polu snippet.style.
badRequest (400)targetInvalidCountryJedna z wartości na liście targeting.countries nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)targetInvalidLanguageJedna z wartości na liście targeting.languages nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)targetInvalidRegionJedna z wartości na liście targeting.regions nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)typeRequiredZasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403)channelSectionForbiddenżądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału;
invalidValue (400)channelNotActiveCo najmniej 1 z wybranych kanałów jest nieaktywny.
invalidValue (400)channelsDuplicatedŻądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400)channelsNeededJeśli wartość właściwości snippet.type to multipleChannels, musisz podać wartość właściwości contentDetails.channels[] i co najmniej jeden kanał.
invalidValue (400)channelsNotExpectedZasób podany w żądaniu zawiera wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie można podawać kanałów.
invalidValue (400)contentDetailsNeededZasób, który wstawiasz, musi zawierać obiekt contentDetails w przypadku tego typu sekcji kanału.
invalidValue (400)inValidPositionWłaściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400)maxChannelSectionExceededNie można zrealizować tej prośby, ponieważ kanał zawiera już maksymalną liczbę sekcji.
invalidValue (400)maxChannelsExceededŻądanie nie zostało zrealizowane, ponieważ w sekcji kanałów próbowano uwzględnić zbyt wiele kanałów.
invalidValue (400)maxPlaylistExceededŻądanie nie zostało zrealizowane, ponieważ próbowało uwzględnić zbyt wiele playlist w sekcji kanału.
invalidValue (400)onePlaylistNeededJeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400)ownChannelInChannelsNie możesz umieścić swojego kanału w sekcji, która pojawia się na tym kanale.
invalidValue (400)playlistIsPrivateCo najmniej jedna z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału.
invalidValue (400)playlistsDuplicatedŻądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty.
invalidValue (400)playlistsNeededJeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy podać właściwość contentDetails.playlists[].
invalidValue (400)playlistsNotExpectedZasób dostarczony w żądaniu zawiera wartość właściwości contentDetails.playlists[], ale playlisty nie są oczekiwane w przypadku tego typu sekcji kanału.
invalidValue (400)snippetNeededAby utworzyć sekcję kanału, musisz podać snippet.
invalidValue (400)titleLengthExceededWartość właściwości snippet.title jest za długa.
invalidValue (400)titleRequiredJeś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)channelNotFoundNie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404)playlistNotFoundNie znaleziono co najmniej jednej z podanych playlist.

channelSections.list

Typ błęduSzczegóły błęduOpis
forbidden (403)channelSectionForbiddenOsoba przesyłająca prośbę nie ma dostępu do żądanych sekcji kanału.
invalidValue (400)idInvalidŻądanie zawiera nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)invalidCriteriaNie udało się zrealizować żądania, ponieważ kryteria filtra są nieprawidłowe.
notFound (404)channelNotFoundNie udało się znaleźć kanału powiązanego z żądaniem.
notFound (404)channelSectionNotFoundNie udało się znaleźć sekcji kanału powiązanej z żądaniem.

channelSections.update

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetErrorAby móc wstawić lub zaktualizować obiekt localizations dla zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400)invalidLanguageJeden z kluczy języka obiektu localizations nie został zweryfikowany. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)notEditableTej sekcji kanału nie można edytować.
badRequest (400)styleRequiredZasób channelSection musi zawierać wartość w polu snippet.style.
badRequest (400)targetInvalidCountryJedna z wartości na liście targeting.countries nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)targetInvalidLanguageJedna z wartości na liście targeting.languages nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)targetInvalidRegionJedna z wartości na liście targeting.regions nie przeszła walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400)typeRequiredZasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403)channelSectionForbiddenżądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału;
invalidValue (400)channelNotActiveCo najmniej 1 z wybranych kanałów jest nieaktywny.
invalidValue (400)channelsDuplicatedŻądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400)channelsNeededJeśli wartość właściwości snippet.type to multipleChannels, musisz podać wartość właściwości contentDetails.channels[] i co najmniej jeden kanał.
invalidValue (400)channelsNotExpectedZasób podany w żądaniu zawiera wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie można podawać kanałów.
invalidValue (400)contentDetailsNeededZasób, który aktualizujesz, musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400)idInvalidWłaściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400)idRequiredWłaściwość id musi zawierać wartość identyfikującą aktualizowaną sekcję kanału.
invalidValue (400)inValidPositionWłaściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400)maxChannelsExceededŻądanie nie zostało zrealizowane, ponieważ w sekcji kanałów próbowano uwzględnić zbyt wiele kanałów.
invalidValue (400)maxPlaylistExceededŻądanie nie zostało zrealizowane, ponieważ próbowało uwzględnić zbyt wiele playlist w sekcji kanału.
invalidValue (400)onePlaylistNeededJeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400)ownChannelInChannelsNie możesz umieścić swojego kanału w sekcji, która pojawia się na tym kanale.
invalidValue (400)playlistIsPrivateCo najmniej jedna z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału.
invalidValue (400)playlistsDuplicatedŻądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty.
invalidValue (400)playlistsNeededJeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy podać właściwość contentDetails.playlists[].
invalidValue (400)playlistsNotExpectedZasób dostarczony w żądaniu zawiera wartość właściwości contentDetails.playlists[], ale playlisty nie są oczekiwane w przypadku tego typu sekcji kanału.
invalidValue (400)snippetNeededAby zaktualizować sekcję kanału, musisz podać snippet.
invalidValue (400)titleLengthExceededWartość właściwości snippet.title jest za długa.
invalidValue (400)titleRequiredJeś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)channelNotFoundNie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404)channelSectionNotFoundNie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
notFound (404)playlistNotFoundNie znaleziono co najmniej jednej z podanych playlist.

kanały

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channels. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

channels.list

Typ błęduSzczegóły błęduOpis
badRequest (400)invalidCriteriaMoż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)channelForbiddenKanał określony przez parametr id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
notFound (404)categoryNotFoundNie udało się znaleźć kategorii określonej przez parametr categoryId. Aby pobrać listę prawidłowych wartości, użyj metody guideCategories.list.
notFound (404)channelNotFoundNie udało się znaleźć kanału określonego w parametrze id.

channels.update

Typ błęduSzczegóły błęduOpis
badRequest (400)brandingValidationErrorJedna z wartości w obiekcie brandingSettings nie przeszła walidacji. Użyj metody channels.list, aby pobrać istniejące ustawienia kanału, a następnie zaktualizuj wartości właściwości zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels.
badRequest (400)channelTitleUpdateForbiddenPodczas aktualizowania właściwości brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na bieżący tytuł kanału lub pominąć tę właściwość. Jeśli zmienisz wartość właściwości, interfejs API zwróci błąd.
badRequest (400)defaultLanguageNotSetErrorUstawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400)invalidBrandingOptionJeden z ustawień brandingu, które zostały przez Ciebie określone, nie istnieje. Aby pobrać prawidłowe wartości, użyj metody channels.list i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels.
badRequest (400)invalidCustomMessageMetadane żądania podają nieprawidłową wiadomość niestandardową. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, do którego wysłano żądanie.
badRequest (400)invalidDurationMetadane żądania podają nieprawidłowy czas trwania w części invideoPromotion.
badRequest (400)invalidDurationMetadane żądania podają nieprawidłowy typ pozycji, który określa sposób umieszczenia promowanego produktu w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, do którego wysłano żądanie.
badRequest (400)invalidRecentlyUploadedByMetadane żądania zawierają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, do którego wysłano żądanie.
badRequest (400)invalidTimingOffsetMetadane żądania podają nieprawidłowy przesunięcie czasu w części invideoPromotion.
badRequest (400)invalidTimingOffsetMetadane żądania podają nieprawidłowy przesunięcie czasu, który służy do określania, kiedy promowany produkt powinien się wyświetlić w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, do którego wysłano żądanie.
badRequest (400)invalidTimingTypeMetadane żądania określają nieprawidłową metodę określania czasu wyświetlania promowanego produktu w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, do którego wysłano żądanie.
badRequest (400)localizationValidationErrorJedna z wartości w obiekcie localizations nie przeszła walidacji. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj, aby zaktualizować je zgodnie z wytycznymi podanymi w dokumentacji zasobu channels.
badRequest (400)tooManyPromotedItemsW części invideoPromotion została przekroczona dozwolona liczba promowanych elementów.
forbidden (403)channelForbiddenKanał określony w parametrze id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
forbidden (403)promotedVideoNotAllowedNie można znaleźć kanału, który ma być aktualizowany przez żądanie interfejsu API. Aby się upewnić, że identyfikator kanału jest prawidłowy, sprawdź wartość właściwości id w zasobie channel, który wysłał żądanie.
forbidden (403)websiteLinkNotAllowedPodany adres URL witryny jest niedozwolony.
notFound (404)channelNotFoundNie udało się znaleźć kanału określonego przez parametr id lub nie ma on opcji związanych z brandingiem.
notFound (404)channelNotFoundNie udało się znaleźć kanału określonego w parametrze id.
notFound (404)unknownChannelIdNie znaleziono podanego identyfikatora kanału.
notFound (404)unknownChannelIdNie znaleziono podanego identyfikatora kanału, który ostatnio przesłał treści.
notFound (404)unknownVideoIdNie udało się znaleźć identyfikatora filmu określonego jako promowany element.
required (400)requiredItemIdTypeMetadane żądania muszą określać typ elementu w części invideoPromotion.
required (400)requiredItemIdMetadane żądania muszą określać element w sekcji invideoPromotion.
required (400)requiredTimingOffsetMetadane żądania muszą zawierać domyślny przesunięcie czasu, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie, do którego wysyłane jest żądanie.
required (400)requiredTimingOffsetMetadane żądania muszą zawierać przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie, do którego wysyłane jest żądanie.
required (400)requiredTimingTypeMetadane żądania muszą zawierać metodę określania czasu, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie, do którego wysyłane jest żądanie.
required (400)requiredTimingTypeMetadane żądania muszą zawierać metodę określania czasu, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie, do którego wysyłane jest żądanie.
required (400)requiredTimingMetadane żądania muszą określać czas trwania każdego elementu w części invideoPromotion.
required (400)requiredVideoIdMetadane żądania muszą zawierać identyfikator filmu, który umożliwia zidentyfikowanie promowanego produktu.
required (400)requiredWebsiteUrlW metadanych żądania w części invideoPromotion musi być podany URL witryny. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie, do którego wysyłane jest żądanie.

commentThreads

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami commentThreads. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

commentThreads.list

Typ błęduSzczegóły błęduOpis
badRequest (400)operationNotSupportedŻądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403)commentsDisabledKomentarze zostały wyłączone w filmie zidentyfikowanym przez parametr videoId.
forbidden (403)forbiddenZ powodu niewystarczających uprawnień nie można pobrać co najmniej 1 żądanego wątku komentarzy. Prośba może nie być prawidłowo autoryzowana.
notFound (404)channelNotFoundNie udało się znaleźć kanału z parametrem allThreadsRelatedToChannelId.
notFound (404)commentThreadNotFoundNie udało się znaleźć co najmniej 1 z podanych wątków komentarzy. Sprawdź wartości parametru id żądania, aby się upewnić, że są prawidłowe.
notFound (404)videoNotFoundNie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.

commentThreads.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)channelOrVideoIdMissingKażdy wątek komentarzy musi być powiązany z kanałem lub filmem. Upewnij się, że zasób zawiera wartości zarówno dla właściwości snippet.channelId, jak i snippet.videoId. Komentarz do filmu pojawia się na stronie odtwarzania filmu.
badRequest (400)commentTextRequiredWstawiany zasób comment musi zawierać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400)commentTextTooLongW wstawianym zasobie comment występuje za dużo znaków w właściwości snippet.topLevelComment.snippet.textOriginal.
badRequest (400)invalidCommentThreadMetadataMetadane żądania są nieprawidłowe.
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403)forbiddenNie udało się utworzyć wątku komentarzy z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)ineligibleAccountAby móc wstawiać komentarze lub wątki komentarzy, konto YouTube używane do autoryzacji żądania interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404)channelNotFoundNie udało się znaleźć określonego kanału. Sprawdź wartość właściwości snippet.channelId, aby upewnić się, że jest prawidłowa.
notFound (404)videoNotFoundNie udało się znaleźć określonego filmu. Sprawdź wartość właściwości snippet.videoId, aby upewnić się, że jest prawidłowa.

komentarze

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

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami comments. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

comments.list

Typ błęduSzczegóły błęduOpis
badRequest (400)operationNotSupportedŻądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
forbidden (403)forbiddenNie udało się pobrać co najmniej 1 żądanego komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
notFound (404)commentNotFoundNie udało się znaleźć co najmniej 1 wskazanego komentarza. Sprawdź, czy parametry żądania idparentId są prawidłowe.

comments.setModerationStatus

Typ błęduSzczegóły błęduOpis
badRequest (400)banWithoutRejectParametru banAuthor można używać tylko wtedy, gdy wartość parametru moderationStatus to rejected.
badRequest (400)operationNotSupportedŻądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403)forbiddenNie można ustawić stanu moderacji co najmniej 1 komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
notFound (404)commentNotFoundNie można znaleźć co najmniej 1 komentarza, który ma zostać zaktualizowany. Sprawdź, czy wartości parametru id żądania są prawidłowe.

comments.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)commentTextRequiredWstawiany zasób comment musi zawierać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400)commentTextTooLongWstawiany zasób comment zawiera zbyt wiele znaków w właściwości snippet.textOriginal.
badRequest (400)invalidCommentMetadataMetadane żądania są nieprawidłowe.
badRequest (400)operationNotSupportedUżytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu zidentyfikowany przez właściwość snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżący użytkownik może odpowiedzieć na wątek.
badRequest (400)parentCommentIsPrivatePodany komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na komentarze prywatne.
badRequest (400)parentIdMissingWklejany komentarz musi być powiązany z komentarzem nadrzędnym. Jednak zasób comment w ciele żądania interfejsu API nie zawierał wartości właściwości snippet.parentId.
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403)forbiddenNie można utworzyć komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)ineligibleAccountAby móc wstawiać komentarze lub wątki komentarzy, konto YouTube używane do autoryzacji żądania interfejsu API musi zostać połączone z kontem Google użytkownika.
notFound (404)parentCommentNotFoundNie udało się znaleźć wskazanego komentarza nadrzędnego. Sprawdź wartość właściwości snippet.parentId w treści żądania, aby mieć pewność, że jest prawidłowa.

comments.delete

Typ błęduSzczegóły błęduOpis
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403)forbiddenNie udało się usunąć komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
notFound (404)commentNotFoundNie udało się znaleźć wskazanego komentarza. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

comments.update

Typ błęduSzczegóły błęduOpis
badRequest (400)commentTextTooLongAktualizowany zasób comment zawiera w atrybucie snippet.textOriginal za dużo znaków.
badRequest (400)invalidCommentMetadataMetadane żądania są nieprawidłowe.
badRequest (400)operationNotSupportedŻądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400)processingFailureSerwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403)forbiddenNie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)ineligibleAccountAby zaktualizować komentarz lub wątek komentarzy, konto YouTube używane do autoryzacji żądania interfejsu API musi zostać scalone z kontem Google użytkownika.
notFound (404)commentNotFoundNie udało się znaleźć wskazanego komentarza. Sprawdź wartość właściwości id w treści żądania, aby mieć pewność, że jest prawidłowa.

członkowie

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

members.list

Typ błęduSzczegóły błęduOpis
badRequest (400)channelMembershipsNotEnabledKanał twórcy, który autoryzuje prośbę, nie ma włączonego wspierania.
badRequest (400)invalidModeWartość parametru mode jest nieprawidłowa. Ten błąd może wystąpić, jeśli parametr pageToken określa token, który został pobrany za pomocą innego trybu niż określony.
badRequest (400)invalidPageTokenWartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, gdy token strony użyty w żądaniu wygasł.
badRequest (400)invalidHasAccessToLevelWartość parametru hasAccessToLevel jest nieprawidłowa. Brak poziomu o podanym identyfikatorzeid.
badRequest (400)invalidFilterByMemberChannelIdWartość 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 poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

membershipsLevels.list

Typ błęduSzczegóły błęduOpis
badRequest (400)channelMembershipsNotEnabledKanał twórcy, który autoryzuje prośbę, nie ma włączonego wspierania.

playlistItems

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami playlistItems. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

playlistItems.delete

Typ błęduSzczegóły błęduOpis
forbidden (403)playlistItemsNotAccessibleprośba nie jest odpowiednio upoważniona do usunięcia określonego elementu playlisty;
notFound (404)playlistItemNotFoundNie udało się znaleźć elementu playlisty zidentyfikowanego za pomocą parametru id żądania.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje możliwości usuwania filmów z określonej playlisty. Nie możesz na przykład usunąć filmu z playlisty przesłanych filmów.

playlistItems.insert

Typ błęduSzczegóły błęduOpis
duplicatevideoAlreadyInPlaylistFilm, który próbujesz dodać do playlisty, jest już na tej playliście.
forbidden (403)playlistContainsMaximumNumberOfVideosPlaylista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403)playlistItemsNotAccessibleŻądanie nie jest prawidłowo upoważnione do wstawiania określonego elementu playlisty.
invalidValue (400)invalidContentDetailsWłaściwość contentDetails w żądaniu jest nieprawidłowa. Możliwym powodem jest to, że pole contentDetails.note zawiera więcej niż 280 znaków.
invalidValue (400)invalidPlaylistItemPositionŻądanie próbuje ustawić pozycję elementu na liście odtwarzania na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w sekcji snippet zasobu.
invalidValue (400)invalidResourceTypeW przypadku tej operacji nie jest obsługiwany type podany w identyfikatorze zasobu. Identyfikator zasobu identyfikuje element dodawany do playlisty, np. youtube#video.
invalidValue (400)manualSortRequiredW żądaniu próbuje się ustawić pozycję elementu na playliście, ale playlista nie używa sortowania ręcznego. (np. elementy playlisty mogą być posortowane według daty lub popularności). Aby naprawić błąd, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty znajdował się w konkretnym miejscu na liście, musisz najpierw zmienić w ustawieniach playlisty opcję Uporządkowanie na Ręczne. Te ustawienia można zmienić w Menedżerze filmów w YouTube.
invalidValue (400)videoAlreadyInAnotherSeriesPlaylistFilm, który próbujesz dodać do playlisty, jest już na innej playliście serialu.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje możliwości wstawiania filmów na określonej playliście. Nie możesz na przykład wstawić filmu na playlistę przesłanych filmów.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404)videoNotFoundNie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź wartość właściwości videoId, aby upewnić się, że jest prawidłowa.
required (400)channelIdRequiredŻądanie nie zawiera wartości wymaganej właściwości channelId.
required (400)playlistIdRequiredŻądanie nie zawiera 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łęduSzczegóły błęduOpis
forbidden (403)playlistItemsNotAccessibleŻądanie nie jest prawidłowo autoryzowane do pobrania określonej playlisty.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404)videoNotFoundNie udało się znaleźć filmu zidentyfikowanego za pomocą parametru videoId żądania.
required (400)playlistIdRequiredŻądanie subskrypcji nie określa wartości wymaganej właściwości playlistId.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje możliwości wyświetlania listy filmów na określonej playliście. Nie możesz na przykład dodać filmu do playlisty Do obejrzenia.

playlistItems.update

Typ błęduSzczegóły błęduOpis
forbidden (403)playlistItemsNotAccessibleProśba nie jest prawidłowo autoryzowana do aktualizowania określonego elementu playlisty.
invalidValue (400)invalidPlaylistItemPositionŻądanie próbuje ustawić pozycję elementu na liście odtwarzania na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w sekcji snippet zasobu.
invalidValue (400)invalidResourceTypeW przypadku tej operacji nie jest obsługiwany type podany w identyfikatorze zasobu. Identyfikator zasobu identyfikuje element dodawany do playlisty, np. youtube#video.
invalidValue (400)invalidSnippetŻądanie nie określa prawidłowej usługi snippet.
invalidValue (400)manualSortRequiredW żądaniu próbuje się ustawić pozycję elementu na playliście, ale playlista nie używa sortowania ręcznego. (np. elementy playlisty mogą być posortowane według daty lub popularności). Aby naprawić błąd, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty znajdował się w konkretnym miejscu na liście, musisz najpierw zmienić w ustawieniach playlisty opcję Uporządkowanie na Ręczne. Te ustawienia można zmienić w Menedżerze filmów w YouTube.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje możliwości aktualizowania filmów na określonej playliście. Nie możesz na przykład zaktualizować filmu na liście przesłanych filmów.
notFound (404)playlistItemNotFoundNie udało się znaleźć elementu playlisty z właściwością id żądania.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
required (400)channelIdRequiredŻądanie nie zawiera wartości wymaganej właściwości channelId.
required (400)playlistIdRequiredŻądanie nie zawiera wartości wymaganej właściwości playlistId.
required (400)playlistItemIdRequiredZasób elementu playlisty określony w żądaniu musi używać właściwości id do identyfikowania aktualizowanego elementu playlisty.

playlisty

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami playlists. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

playlists.delete

Typ błęduSzczegóły błęduOpis
forbidden (403)playlistForbiddenTa operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400)playlistOperationUnsupportedInterfejs 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łęduSzczegóły błęduOpis
forbidden (403)channelClosedkanał podany w parametrze channelId został zamknięty,
forbidden (403)channelSuspendedKanał określony w parametrze channelId został zawieszony.
forbidden (403)playlistForbiddenPlaylista zidentyfikowana za pomocą parametru id żądania nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
notFound (404)channelNotFoundNie udało się znaleźć kanału określonego w parametrze channelId.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje wyświetlania określonej playlisty. Nie możesz na przykład wyświetlić listy Do obejrzenia.

playlists.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetErrorUstawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400)localizationValidationErrorJedna z wartości w obiekcie localizations nie przeszła walidacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj, aby zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlists.
badRequest (400)maxPlaylistExceededNie można utworzyć playlisty, ponieważ kanał ma już maksymalną liczbę playlist.
forbidden (403)playlistForbiddenTa operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400)invalidPlaylistSnippetŻądanie zawiera nieprawidłowy fragment playlisty.
required (400)playlistTitleRequiredW żądaniu musisz podać tytuł playlisty.

playlists.update

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetErrorUstawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400)localizationValidationErrorJedna z wartości w obiekcie localizations nie przeszła walidacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj, aby zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlists.
forbidden (403)playlistForbiddenTa operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400)invalidPlaylistSnippetŻądanie zawiera nieprawidłowy fragment playlisty.
invalidValue (400)playlistOperationUnsupportedInterfejs API nie obsługuje możliwości aktualizowania określonej playlisty. Nie możesz na przykład zaktualizować właściwości playlisty przesłanych filmów.
notFound (404)playlistNotFoundNie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
required (400)playlistTitleRequiredW żądaniu musisz podać tytuł playlisty.

subskrypcje

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami subscriptions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

subscriptions.delete

Typ błęduSzczegóły błęduOpis
forbidden (403)subscriptionForbiddenżądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane na tym kanale;
notFound (404)subscriptionNotFoundNie można znaleźć subskrypcji, którą próbujesz usunąć. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

subscriptions.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)subscriptionDuplicateSubskrypcja, którą próbujesz utworzyć, już istnieje.
badRequest (400)subscriptionForbiddenOsiągnięto maksymalną liczbę subskrypcji.
badRequest (400)subscriptionForbiddenW ostatnim czasie zasubskrybowałeś zbyt wiele kanałów. Spróbuj ponownie za kilka godzin.
badRequest (400)subscriptionForbiddenSubskrybowanie własnego kanału nie jest obsługiwane.
forbidden (403)subscriptionForbiddenżądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane na tym kanale;
notFound (404)publisherNotFoundNie udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404)subscriberNotFoundNie można znaleźć subskrybenta z żądania.
required (400)publisherRequiredZasoby subskrypcji określone w żądaniu muszą używać właściwości snippet.resourceId do identyfikowania kanału, do którego jest subskrypcja.

subscriptions.list

Typ błęduSzczegóły błęduOpis
forbidden (403)accountClosedNie można pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte.
forbidden (403)accountSuspendedNie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone.
forbidden (403)subscriptionForbiddenOsoba przesyłająca prośbę nie ma dostępu do żądanych subskrypcji.
notFound (404)subscriberNotFoundNie można znaleźć subskrybenta z żądaniem.

miniatury

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami thumbnails. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

thumbnails.set

Typ błęduSzczegóły błęduOpis
badRequest (400)invalidImageZawartość przesłanego obrazu jest nieprawidłowa.
badRequest (400)mediaBodyRequiredProśba nie zawiera treści obrazu.
forbidden (403)forbiddenNie można ustawić miniatury dla wybranego filmu. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)forbiddenUwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów.
notFound (404)videoNotFoundNie udało się znaleźć filmu, którego miniatury próbujesz wstawić. Sprawdź wartość parametru videoId żądania, aby się upewnić, że jest prawidłowa.
tooManyRequests (429)uploadRateLimitExceededKanał przesłał ostatnio zbyt wiele miniatur. Spróbuj ponownie później.

videoAbuseReportReasons

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videoAbuseReportReasons. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

videoAbuseReportReasons.list

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenDostęp zabroniony. Prośba może nie być prawidłowo autoryzowana.

videoCategories

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videoCategories. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

videoCategories.list

Typ błęduSzczegóły błęduOpis
notFound (404)videoCategoryNotFoundNie można znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.

filmy

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videos. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

videos.insert

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetProśba próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400)invalidCategoryIdWłaściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400)invalidDescriptionMetadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400)invalidFilenameNazwa pliku wideo określona w nagłówku Slug jest nieprawidłowa.
badRequest (400)invalidPublishAtMetadane żądania podają nieprawidłowy zaplanowany czas publikacji.
badRequest (400)invalidRecordingDetailsObiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400)invalidTagsMetadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400)invalidTitleMetadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400)invalidVideoGameRatingMetadane żądania podają nieprawidłową ocenę gry wideo.
badRequest (400)invalidVideoMetadataMetadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title ani snippet.categoryId.
badRequest (400)mediaBodyRequiredProśba nie zawiera treści wideo.
badRequest (400)uploadLimitExceededUżytkownik przekroczył limit liczby filmów, które może przesłać.
forbidden (403)forbidden
forbidden (403)forbiddenLicenseSettingŻądanie próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403)forbiddenPrivacySettingŻądanie próbuje ustawić nieprawidłowe ustawienie prywatności filmu.

videos.list

Typ błęduSzczegóły błęduOpis
badRequest (400)videoChartNotFoundŻądany wykres wideo jest niedostępny lub nie jest obsługiwany.
forbidden (403)forbiddenprośba nie jest prawidłowo autoryzowana do dostępu do pliku wideo lub przetwarzania informacji; Elementy fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu.
forbidden (403)forbiddenProśba nie może uzyskać dostępu do informacji o ocenie użytkownika. Ten błąd może wystąpić, ponieważ żądanie nie jest prawidłowo upoważnione do używania parametru myRating.
notFound (404)videoNotFoundNie udało się znaleźć filmu, który próbujesz pobrać. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

videos.delete

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenNie można usunąć filmu, który próbujesz usunąć. Prośba może nie być prawidłowo autoryzowana.
notFound (404)videoNotFoundNie można znaleźć filmu, który próbujesz usunąć. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

videos.update

Typ błęduSzczegóły błęduOpis
badRequest (400)defaultLanguageNotSetŻądanie interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400)invalidCategoryIdWł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ślnego kanału.
badRequest (400)invalidDescriptionMetadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400)invalidPublishAtMetadane żądania podają nieprawidłowy zaplanowany czas publikacji.
badRequest (400)invalidRecordingDetailsObiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400)invalidTagsMetadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400)invalidTitleMetadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400)invalidVideoMetadataMetadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title ani snippet.categoryId.
forbidden (403)forbiddenDostęp zabroniony. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)forbiddenEmbedSettingProśba próbuje ustawić nieprawidłowe ustawienie osadzenia filmu. Niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzaczy umieszczonych w transmisjach na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403)forbiddenLicenseSettingŻądanie próbuje ustawić nieprawidłową licencję dla filmu.
forbidden (403)forbiddenPrivacySettingŻądanie próbuje ustawić nieprawidłowe ustawienie prywatności filmu.
notFound (404)videoNotFoundNie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź wartość pola id w treści żądania, aby upewnić się, że jest prawidłowa.

videos.rate

Typ błęduSzczegóły błęduOpis
badRequest (400)emailNotVerifiedPrzed wystawieniem oceny użytkownik musi potwierdzić swój adres e-mail.
badRequest (400)invalidRatingŻądanie zawierało nieoczekiwaną wartość parametru rating.
badRequest (400)videoPurchaseRequiredFilmy do wypożyczenia mogą oceniać tylko użytkownicy, którzy je wypożyczyli.
forbidden (403)forbiddenFilm, który próbujesz ocenić, nie może być oceniony. Prośba może nie być prawidłowo autoryzowana.
forbidden (403)videoRatingDisabledWłaściciel filmu, który próbujesz ocenić, wyłączył oceny.
notFound (404)videoNotFoundNie można znaleźć filmu, któremu próbujesz przyznać ocenę. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

videos.reportAbuse

Typ błęduSzczegóły błęduOpis
badRequest (400)invalidAbuseReasonŻądanie zawierało nieoczekiwaną wartość w polu reason_id lub w kombinacji pól reason_idsecondary_reason_id.
badRequest (400)rateLimitExceededUżytkownik wysłał zbyt wiele żądań w danym przedziale czasu.
forbidden (403)forbidden
notFound (404)videoNotFoundNie można znaleźć filmu, którego dotyczy nadużycie, które chcesz zgłosić.

znaki wodne

W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami watermarks. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.

watermarks.set

Typ błęduSzczegóły błęduOpis
badRequest (400)imageFormatUnsupportedPodany obraz ma nieobsługiwany format.
badRequest (400)imageTooTallPodany obraz jest za wysoki.
badRequest (400)imageTooWidePodany obraz jest za szeroki.
badRequest (400)mediaBodyRequiredProśba nie zawiera treści obrazu.
forbidden (403)forbiddenNie można ustawić znaku wodnego na określonym kanale. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId może mieć nieprawidłową wartość.

watermarks.unset

Typ błęduSzczegóły błęduOpis
forbidden (403)forbiddenNie można usunąć znaku wodnego z wybranego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId może mieć nieprawidłową wartość.