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łędu Szczegóły błędu Opis
forbidden (403) forbidden Dostęp zabroniony. Prośba może nie być prawidłowo autoryzowana.
quotaExceeded (403) quotaExceeded Nie możemy zrealizować tej prośby, ponieważ został przekroczony limit.

Common request errors

Typ błędu Szczegóły błędu Opis
badRequest (400) incompatibleParameters Żądanie zawiera co najmniej 2 parametry, których nie można użyć w tym samym żądaniu.
badRequest (400) invalidFilters Żądanie zawiera nieprawidłowy parametr filtra.
badRequest (400) invalidPageToken Żądanie zawiera nieprawidłowy token strony.
badRequest (400) missingRequiredParameter Brakuje wymaganego parametru.
badRequest (400) unexpectedParameter Żądanie zawiera nieoczekiwany parametr.
forbidden (403) accountDelegationForbidden Użytkownik uwierzytelniony nie może działać w imieniu określonego konta Google.
forbidden (403) authenticatedUserAccountClosed Konto YouTube uwierzytelnionego użytkownika zostało zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd odnosi się do tego drugiego konta.
forbidden (403) authenticatedUserAccountSuspended Konto YouTube uwierzytelnionego użytkownika jest zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, ten błąd odnosi się do tego drugiego konta.
forbidden (403) authenticatedUserNotChannel W przypadku tego żądania uwierzytelniony użytkownik musi być kanałem, ale nie jest. Jeśli żądanie jest uwierzytelniane i używa parametru delegowania onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed Kanał wskazany w żądaniu został zamknięty.
forbidden (403) channelNotFound Nie udało się znaleźć kanału wskazanego w żądaniu.
forbidden (403) channelSuspended Kanał wskazany w żądaniu został zawieszony.
forbidden (403) cmsUserAccountNotFound Użytkownik CMS nie może działać w imieniu określonego właściciela treści.
forbidden (403) insufficientCapabilities Użytkownik CMS ma niewystarczające uprawnienia.
forbidden (403) insufficientPermissions Token OAuth 2.0 podany w żądaniu określa zakresy, które nie wystarczają do uzyskania dostępu do żądanych danych.
notFound (404) contentOwnerAccountNotFound Nie znaleziono podanego konta właściciela treści.

Request context errors

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidLanguage Wartość parametru hl nie określa prawidłowego kodu języka.
badRequest (400) invalidMine Używanie parametru mine w żądaniu nie jest obsługiwane.
badRequest (400) invalidMine Parametru mine nie można używać w żądaniach, w których uwierzytelniony użytkownik jest partnerem YouTube. 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) invalidPart Parametr part w żądaniu określa niektóre części, które nie mogą być zapisane w tym samym czasie.
badRequest (400) invalidRegionCode Parametr regionCode określa nieprawidłowy kod regionu.
badRequest (400) unexpectedPart Parametr part w żądaniu ma nieoczekiwaną wartość.
badRequest (400) unknownPart Parametr part w żądaniu określa nieznaną wartość.
badRequest (400) unsupportedLanguageCode Wartość parametru hl nie określa obsługiwanego kodu języka.
badRequest (400) unsupportedRegionCode Parametr regionCode określa nieobsługiwany kod regionu.
unauthorized (401) authorizationRequired Żądanie używa parametru mine, ale nie jest prawidłowo autoryzowane.
unauthorized (401) youtubeSignupRequired Ten błąd 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łędu Szczegóły błędu Opis
forbidden (403) homeParameterDeprecated Dane 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) channelNotFound Nie udało się znaleźć identyfikatora kanału określonego przez parametr channelId żądania.
notFound (404) homeChannelNotFound Nie udało się znaleźć kanału na stronie głównej YouTube dla aktualnie uwierzytelnionego użytkownika.
unauthorized (401) authorizationRequired Żądanie używa parametru home, ale nie jest prawidłowo autoryzowane.

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łędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do usunięcia ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

captions.download

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
invalidValue (400) couldNotConvert Nie 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) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

captions.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Żądanie nie zawiera treści ścieżki z napisami.
conflict (409) captionExists Podany 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) forbidden Uprawnienia 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) videoNotFound Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
invalidValue (400) nameTooLong W żądaniu podany parametr snippet.name jest za długi. Maksymalna długość to 150 znaków.

captions.list

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie udało się pobrać co najmniej 1 ścieżki 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) captionNotFound Nie 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) videoNotFound Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.

captions.update

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired W żądaniu nie przesłano zaktualizowanego pliku napisów. Jeśli parametr sync ma wartość true, wymagane jest rzeczywiste zawartość ścieżki.
forbidden (403) forbidden Uprawnienia 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) captionNotFound Nie 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łę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 stronę http://photos.google.com, przejdź na stronę albumów i usuń niektóre zdjęcia z tego albumu.
badRequest (400) mediaBodyRequired Proś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łę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 na tym kanale;
invalidValue (400) idInvalid Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) idRequired Właściwość id musi zawierać wartość identyfikującą usuwany fragment kanału.
notFound (404) channelNotFound Nie znaleziono kanału.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.

channelSections.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Aby móc wstawić lub zaktualizować obiekt localizations dla zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400) invalidLanguage Jeden 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="/https/developers.google.com/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 zawierać wartość w polu snippet.style.
badRequest (400) targetInvalidCountry Jedna 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="/https/developers.google.com/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 walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/https/developers.google.com/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 walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) typeRequired Zasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403) channelSectionForbidden żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału;
invalidValue (400) channelNotActive Co najmniej 1 z wybranych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400) channelsNeeded Jeś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) channelsNotExpected Zasó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) contentDetailsNeeded Zasób, który wstawiasz, musi zawierać obiekt contentDetails w przypadku tego typu sekcji kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelSectionExceeded Nie można zrealizować tej prośby, ponieważ kanał zawiera już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Żą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) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400) ownChannelInChannels Nie możesz umieścić swojego kanału w sekcji, która pojawia się na tym kanale.
invalidValue (400) playlistIsPrivate Co 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) playlistsNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy podać właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Zasó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) snippetNeeded Aby utworzyć sekcję kanału, musisz podać snippet.
invalidValue (400) titleLengthExceeded Wartość właściwości snippet.title jest za długa.
invalidValue (400) titleRequired Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404) channelNotFound Nie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404) playlistNotFound Nie znaleziono co najmniej jednej z podanych playlist.

channelSections.list

Typ błędu Szczegóły błędu Opis
forbidden (403) channelSectionForbidden Osoba 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) 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 żądaniem.
notFound (404) channelSectionNotFound Nie udało się znaleźć sekcji kanału powiązanej z żądaniem.

channelSections.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Aby móc wstawić lub zaktualizować obiekt localizations dla zasobu channelSection, musisz ustawić właściwość snippet.defaultLanguage tego zasobu.
badRequest (400) invalidLanguage Jeden 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="/https/developers.google.com/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 zawierać wartość w polu snippet.style.
badRequest (400) targetInvalidCountry Jedna 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="/https/developers.google.com/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 walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/https/developers.google.com/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 walidacji. Aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections, użyj metody channelSections.list.
badRequest (400) typeRequired Zasób channelSection musi zawierać wartość w polu snippet.type.
forbidden (403) channelSectionForbidden żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w przypadku tego kanału;
invalidValue (400) channelNotActive Co najmniej 1 z wybranych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400) channelsNeeded Jeś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) channelsNotExpected Zasó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) 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 zawierać 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ż 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) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę.
invalidValue (400) ownChannelInChannels Nie możesz umieścić swojego kanału w sekcji, która pojawia się na tym kanale.
invalidValue (400) playlistIsPrivate Co 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) playlistsNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy podać właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Zasó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) snippetNeeded Aby zaktualizować sekcję kanału, musisz podać snippet.
invalidValue (400) titleLengthExceeded Wartość właściwości snippet.title jest za długa.
invalidValue (400) titleRequired Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, podając wartość właściwości snippet.title.
notFound (404) channelNotFound Nie udało się znaleźć co najmniej 1 z podanych kanałów.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.
notFound (404) playlistNotFound Nie 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łę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 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) channelTitleUpdateForbidden Podczas 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) defaultLanguageNotSetError Ustawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400) invalidBrandingOption Jeden 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) invalidCustomMessage Metadane żą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) invalidDuration Metadane żądania podają nieprawidłowy czas trwania w części invideoPromotion.
badRequest (400) invalidDuration Metadane żą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) invalidRecentlyUploadedBy Metadane żądania zawierają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, do którego wysłano żądanie.
badRequest (400) invalidTimingOffset Metadane żądania podają nieprawidłowy przesunięcie czasu w części invideoPromotion.
badRequest (400) invalidTimingOffset Metadane żą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) invalidTimingType Metadane żą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) localizationValidationError Jedna 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) tooManyPromotedItems W części invideoPromotion została przekroczona dozwolona liczba promowanych elementów.
forbidden (403) channelForbidden Kanał określony 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 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) websiteLinkNotAllowed Podany adres URL witryny jest niedozwolony.
notFound (404) channelNotFound Nie udało się znaleźć kanału określonego przez parametr id lub nie ma on opcji związanych z brandingiem.
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, który ostatnio przesłał treści.
notFound (404) unknownVideoId Nie udało się znaleźć identyfikatora filmu określonego jako promowany element.
required (400) requiredItemIdType Metadane żądania muszą określać typ elementu w części invideoPromotion.
required (400) requiredItemId Metadane żądania muszą określać element w sekcji invideoPromotion.
required (400) requiredTimingOffset Metadane żą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) requiredTimingOffset Metadane żą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) requiredTimingType Metadane żą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) requiredTimingType Metadane żą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) requiredTiming Metadane żądania muszą określać czas trwania każdego elementu w części invideoPromotion.
required (400) requiredVideoId Metadane żądania muszą zawierać identyfikator filmu, który umożliwia zidentyfikowanie promowanego produktu.
required (400) requiredWebsiteUrl W 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łędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403) commentsDisabled Komentarze zostały wyłączone w filmie zidentyfikowanym przez parametr videoId.
forbidden (403) forbidden Z 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) channelNotFound Nie udało się znaleźć kanału z parametrem allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Nie 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) videoNotFound Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.

commentThreads.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) channelOrVideoIdMissing Każdy wątek komentarzy musi być powiązany z kanałem lub filmem. Upewnij się, że zasób 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) commentTextRequired Wstawiany zasób comment musi zawierać wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong W wstawianym zasobie comment występuje za dużo znaków w właściwości snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Metadane żądania są nieprawidłowe.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403) forbidden Nie udało się utworzyć wątku komentarzy z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) ineligibleAccount Aby 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) channelNotFound Nie 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) videoNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
forbidden (403) forbidden Nie 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) commentNotFound Nie udało się znaleźć co najmniej 1 wskazanego komentarza. Sprawdź, czy parametry żądania idparentId są prawidłowe.

comments.setModerationStatus

Typ błędu Szczegóły błędu Opis
badRequest (400) banWithoutReject Parametru banAuthor można używać tylko wtedy, gdy wartość parametru moderationStatus to rejected.
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Nie 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) commentNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) commentTextRequired Wstawiany zasób comment musi zawierać wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiany zasób comment zawiera zbyt wiele znaków w 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 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) parentCommentIsPrivate Podany komentarz nadrzędny jest prywatny. Interfejs API nie obsługuje odpowiedzi na komentarze prywatne.
badRequest (400) parentIdMissing Wklejany 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) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403) forbidden Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) ineligibleAccount Aby 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) parentCommentNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe.
forbidden (403) forbidden Nie udało się usunąć komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
notFound (404) commentNotFound Nie udało się znaleźć wskazanego komentarza. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

comments.update

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextTooLong Aktualizowany zasób comment zawiera w atrybucie snippet.textOriginal za dużo znaków.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu comment w ciele żądania, aby mieć pewność, że jest on prawidłowy.
forbidden (403) forbidden Nie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) ineligibleAccount Aby 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) commentNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzuje prośbę, nie ma włączonego wspierania.
badRequest (400) invalidMode Wartość parametru mode jest nieprawidłowa. Ten błąd może wystąpić, jeśli parametr pageToken określa token, który został pobrany za pomocą innego trybu niż określony.
badRequest (400) invalidPageToken Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, gdy token strony użyty w żądaniu wygasł.
badRequest (400) invalidHasAccessToLevel Wartość parametru hasAccessToLevel jest nieprawidłowa. Brak poziomu o podanym identyfikatorzeid.
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 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łędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał 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łędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible prośba nie jest odpowiednio upoważniona do usunięcia określonego elementu playlisty;
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty zidentyfikowanego za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs 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łędu Szczegóły błędu Opis
duplicate videoAlreadyInPlaylist Film, który próbujesz dodać do playlisty, jest już na tej playliście.
forbidden (403) playlistContainsMaximumNumberOfVideos Playlista 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) invalidContentDetails Wł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) invalidResourceType W przypadku tej operacji nie jest obsługiwany type podany w identyfikatorze zasobu. Identyfikator zasobu identyfikuje element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired W żą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) videoAlreadyInAnotherSeriesPlaylist Film, który próbujesz dodać do playlisty, jest już na innej playliście serialu.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wstawiania filmów na określonej playliście. Nie możesz na przykład wstawić filmu na playlistę przesłanych filmów.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź wartość właściwości videoId, aby upewnić się, że jest prawidłowa.
required (400) channelIdRequired Żą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łę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 zidentyfikowanej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie 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) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wyświetlania listy filmów na określonej playliście. Nie możesz na przykład dodać filmu do playlisty Do obejrzenia.

playlistItems.update

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Prośba nie jest prawidłowo autoryzowana do aktualizowania 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) invalidResourceType W 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) manualSortRequired W żą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) playlistOperationUnsupported Interfejs API nie obsługuje możliwości aktualizowania filmów na określonej playliście. Nie możesz na przykład zaktualizować filmu na liście przesłanych filmów.
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty z właściwością id żądania.
notFound (404) playlistNotFound Nie 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) playlistItemIdRequired Zasó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łę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 zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości usunięcia określonej playlisty. Nie możesz na przykład usunąć playlisty z przesłanymi filmami.

playlists.list

Typ błędu Szczegóły błędu Opis
forbidden (403) channelClosed kanał podany w parametrze channelId został zamknięty,
forbidden (403) channelSuspended Kanał określony w parametrze channelId został zawieszony.
forbidden (403) playlistForbidden Playlista zidentyfikowana za pomocą parametru id żądania nie obsługuje żądania lub żądanie nie jest 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 zidentyfikowanej za pomocą parametru id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje wyświetlania określonej playlisty. Nie możesz na przykład wyświetlić listy Do obejrzenia.

playlists.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Ustawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400) localizationValidationError Jedna 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) maxPlaylistExceeded Nie można utworzyć playlisty, ponieważ kanał ma już maksymalną liczbę playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
required (400) playlistTitleRequired W żądaniu musisz podać tytuł playlisty.

playlists.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Ustawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400) localizationValidationError Jedna 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) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje 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) playlistNotFound Nie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
required (400) playlistTitleRequired W żą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łędu Szczegóły błędu Opis
forbidden (403) subscriptionForbidden żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane na tym kanale;
notFound (404) subscriptionNotFound Nie 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łę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 zasubskrybowałeś zbyt wiele kanałów. Spróbuj ponownie za kilka godzin.
badRequest (400) subscriptionForbidden Subskrybowanie własnego kanału nie jest obsługiwane.
forbidden (403) subscriptionForbidden żądanie nie jest prawidłowo uwierzytelnione lub nie jest obsługiwane na tym kanale;
notFound (404) publisherNotFound Nie udało się znaleźć zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta z żądania.
required (400) publisherRequired Zasoby 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łędu Szczegóły błędu Opis
forbidden (403) accountClosed Nie można pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte.
forbidden (403) accountSuspended Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone.
forbidden (403) subscriptionForbidden Osoba przesyłająca prośbę nie ma dostępu do żądanych subskrypcji.
notFound (404) subscriberNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) invalidImage Zawartość przesłanego obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.
forbidden (403) forbidden Nie można ustawić miniatury dla wybranego filmu. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) forbidden Uwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów.
notFound (404) videoNotFound Nie 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) uploadRateLimitExceeded Kanał 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łędu Szczegóły błędu Opis
forbidden (403) forbidden Dostę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łędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie można znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody 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łędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Prośba próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDescription Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400) invalidFilename Nazwa pliku wideo określona w nagłówku Slug jest nieprawidłowa.
badRequest (400) invalidPublishAt Metadane żądania podają nieprawidłowy zaplanowany czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoGameRating Metadane żądania podają nieprawidłową ocenę gry wideo.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title ani snippet.categoryId.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści wideo.
badRequest (400) uploadLimitExceeded Uż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łędu Szczegóły błędu Opis
badRequest (400) videoChartNotFound Żądany wykres wideo jest niedostępny lub nie jest obsługiwany.
forbidden (403) forbidden proś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) forbidden Proś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) videoNotFound Nie 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łędu Szczegóły błędu Opis
forbidden (403) forbidden Nie można usunąć filmu, który próbujesz usunąć. Prośba może nie być prawidłowo autoryzowana.
notFound (404) videoNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDefaultBroadcastPrivacySetting Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnego kanału.
badRequest (400) invalidDescription Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania podają nieprawidłowy zaplanowany czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania zawierają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title ani snippet.categoryId.
forbidden (403) forbidden Dostęp zabroniony. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) forbiddenEmbedSetting Proś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) videoNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) emailNotVerified Przed wystawieniem oceny użytkownik musi potwierdzić swój adres e-mail.
badRequest (400) invalidRating Żądanie zawierało nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Filmy do wypożyczenia mogą oceniać tylko użytkownicy, którzy je wypożyczyli.
forbidden (403) forbidden Film, który próbujesz ocenić, nie może być oceniony. Prośba może nie być prawidłowo autoryzowana.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył oceny.
notFound (404) videoNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) invalidAbuseReason Żądanie zawierało nieoczekiwaną wartość w polu reason_id lub w kombinacji pól reason_idsecondary_reason_id.
badRequest (400) rateLimitExceeded Użytkownik wysłał zbyt wiele żądań w danym przedziale czasu.
forbidden (403) forbidden
notFound (404) videoNotFound Nie 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łędu Szczegóły błędu Opis
badRequest (400) imageFormatUnsupported Podany obraz ma nieobsługiwany format.
badRequest (400) imageTooTall Podany obraz jest za wysoki.
badRequest (400) imageTooWide Podany obraz jest za szeroki.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.
forbidden (403) forbidden Nie 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łędu Szczegóły błędu Opis
forbidden (403) forbidden Nie 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ść.