YouTube Data API - Errors

W tym dokumencie opisujemy różne typy błędów, które mogą zwracać operacje YouTube Data API. Listę błędów dla poszczególnych metod znajdziesz też w dokumentacji referencyjnej dotyczącej danej metody.

Błędy ogólne

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

Core API errors

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
quotaExceeded (403) quotaExceeded Nie można zrealizować żądania, ponieważ został przekroczony Twój 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żywać 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 W żądaniu brakuje wymaganego parametru.
badRequest (400) unexpectedParameter Żądanie określa nieoczekiwany parametr.
forbidden (403) accountDelegationForbidden Uwierzytelniony użytkownik nie może działać w imieniu określonego konta Google.
forbidden (403) authenticatedUserAccountClosed Konto YouTube uwierzytelnionego użytkownika jest zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd dotyczy tego drugiego konta.
forbidden (403) authenticatedUserAccountSuspended Konto YouTube uwierzytelnionego użytkownika zostało zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd dotyczy tego drugiego konta.
forbidden (403) authenticatedUserNotChannel W przypadku tego żądania uwierzytelniony użytkownik musi zostać rozpoznany jako kanał, ale tak się nie dzieje. Jeśli Twoje żądanie jest uwierzytelnione i używa parametru przekazywania uprawnień onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed Kanał określony w żądaniu został zamknięty.
forbidden (403) channelNotFound Nie udało się znaleźć kanału wskazanego w żądaniu.
forbidden (403) channelSuspended Kanał określony w żą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 są niewystarczające do uzyskania dostępu do żądanych danych.
notFound (404) contentOwnerAccountNotFound Nie znaleziono podanego konta właściciela treści.

Request context errors

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidLanguage Wartość parametru hl nie określa prawidłowego kodu języka.
badRequest (400) invalidMine Użycie 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. Usuń parametr mine, uwierzytelnij się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działaj jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest dostępny dla wywołanej metody.
badRequest (400) invalidPart Parametr part żądania określa pewne części, których nie można zapisać jednocześnie.
badRequest (400) invalidRegionCode Parametr regionCode określa nieprawidłowy kod regionu.
badRequest (400) unexpectedPart Parametr part żądania określa nieoczekiwaną wartość.
badRequest (400) unknownPart Parametr part żądania określa nieznaną wartość.
badRequest (400) unsupportedLanguageCode Wartość parametru hl nie określa obsługiwanego kodu języka.
badRequest (400) unsupportedRegionCode Parametr regionCode określa nieobsługiwany kod regionu.
unauthorized (401) authorizationRequired Żądanie używa parametru mine, ale nie jest prawidłowo autoryzowane.
unauthorized (401) youtubeSignupRequired Ten błąd oznacza, że użytkownik ma niepołączone konto Google, czyli ma konto Google, ale nie ma kanału w YouTube. Tacy użytkownicy mają dostęp do wielu funkcji, które wymagają autoryzacji, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later. Aby na przykład przesłać film, użytkownik musi mieć kanał w YouTube. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, na pewno ma konto Google, ale może nie mieć jeszcze powiązanego z nim kanału YouTube.

Ten błąd często pojawia się, gdy próbujesz użyć przepływu konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi, więc jeśli spróbujesz uwierzytelnić się za pomocą takiego konta, pojawi się ten błąd.

Więcej informacji o błędzie youtubeSignupRequired znajdziesz w poście na blogu interfejsu API YouTube, w którym przedstawiono obsługę kont Google. Chociaż post na blogu wyjaśnia błąd w interfejsie API w wersji 2.1, znaczenie błędu jest nadal aktualne.

aktywności

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

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 w tym interfejsie API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na true.
forbidden (403) forbidden Żądanie nie jest prawidłowo autoryzowane.
notFound (404) channelNotFound Nie można znaleźć identyfikatora kanału określonego przez parametr channelId żądania.
notFound (404) homeChannelNotFound Nie można znaleźć kanału na stronie głównej YouTube dla obecnie uwierzytelnionego użytkownika.
unauthorized (401) authorizationRequired Żądanie używa parametru home, ale nie jest prawidłowo autoryzowane.

napisy

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

captions.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające, aby usunąć ścieżkę z napisami. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

captions.download

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki z napisami na żądany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe, a wartość snippet.status żądanego ścieżki napisów nie jest równa failed.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

captions.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Żądanie nie zawiera treści ścieżki z napisami.
conflict (409) captionExists Określony film ma już ścieżkę z napisami o podanym snippet.language i snippet.name. Film może mieć kilka ścieżek w tym samym języku, ale każda z nich musi mieć inną nazwę.

Ten błąd można rozwiązać na kilka sposobów. Możesz usunąć istniejącą ścieżkę, a potem wstawić nową lub zmienić nazwę nowej ścieżki przed jej wstawieniem.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do przesłania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
invalidValue (400) invalidMetadata Żądanie zawiera nieprawidłowe wartości metadanych, co uniemożliwia utworzenie ścieżki. Sprawdź, czy w żądaniu podano prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Można też uwzględnić właściwość snippet.isDraft, ale nie jest to wymagane.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.
invalidValue (400) nameTooLong Wartość snippet.name podana w żądaniu jest za długa. 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 powiązane z żądaniem są niewystarczające do pobrania żądanych zasobów. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć co najmniej 1 z określonych ścieżek z napisami. Ten błąd występuje, gdy parametr videoId identyfikuje rzeczywisty film, ale parametr id identyfikuje identyfikatory ścieżek z napisami, które nie istnieją, lub identyfikatory ścieżek powiązane z innymi filmami. Sprawdź, czy wartości parametrów id i videoId żądania są prawidłowe.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.

captions.update

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

channelBanners

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

channelBanners.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) bannerAlbumFull Album z grafiką kanału na YouTube zawiera zbyt wiele obrazów. Otwórz stronę http://photos.google.com, przejdź do strony albumów i usuń niektóre obrazy z tego albumu.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.

channelSections

W tabelach poniżej 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 żądań.

channelSections.delete

Typ błędu Szczegóły błędu Opis
badRequest (400) notEditable Tej sekcji kanału nie można usunąć.
forbidden (403) channelSectionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w 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 określać wartość identyfikującą usuwaną sekcję kanału.
notFound (404) channelNotFound Nie znaleziono kanału.
notFound (404) channelSectionNotFound Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować.

channelSections.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Aby wstawić lub zaktualizować obiekt localizations dla danego zasobu, musisz ustawić właściwość snippet.defaultLanguage zasobu channelSection.
badRequest (400) invalidLanguage Jeden z kluczy językowych obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections.
badRequest (400) notEditable Nie można utworzyć tej sekcji kanału.
badRequest (400) styleRequired Zasób channelSection musi mieć określoną wartość pola snippet.style.
badRequest (400) targetInvalidCountry Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400) targetInvalidLanguage Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400) targetInvalidRegion Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections.
badRequest (400) typeRequired Zasób channelSection musi mieć określoną wartość pola snippet.type.
forbidden (403) channelSectionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale.
invalidValue (400) channelNotActive Co najmniej 1 z podanych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 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 oczekuje się kanałów.
invalidValue (400) contentDetailsNeeded Wstawiany zasób musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelSectionExceeded Nie można zrealizować prośby, ponieważ kanał ma już maksymalną liczbę sekcji.
invalidValue (400) maxChannelsExceeded Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanału.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę.
invalidValue (400) ownChannelInChannels Nie możesz dodać własnego kanału do sekcji kanałów, która pojawia się na tym kanale.
invalidValue (400) playlistIsPrivate Co najmniej 1 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 określić właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania.
invalidValue (400) snippetNeeded Aby utworzyć sekcję kanału, musisz określić snippet.
invalidValue (400) titleLengthExceeded Wartość właściwości snippet.title jest za długa.
invalidValue (400) titleRequired Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, określają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 udało się znaleźć co najmniej 1 z podanych playlist.

channelSections.list

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

channelSections.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Aby wstawić lub zaktualizować obiekt localizations dla danego zasobu, musisz ustawić właściwość snippet.defaultLanguage zasobu channelSection.
badRequest (400) invalidLanguage Nie udało się zweryfikować jednego z kluczy językowych obiektu localizations. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections.
badRequest (400) notEditable Tej sekcji kanału nie można edytować.
badRequest (400) styleRequired Zasób channelSection musi mieć określoną wartość pola snippet.style.
badRequest (400) targetInvalidCountry Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400) targetInvalidLanguage Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections.
badRequest (400) targetInvalidRegion Weryfikacja jednej z wartości na liście targeting.regions nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections.
badRequest (400) typeRequired Zasób channelSection musi mieć określoną wartość pola snippet.type.
forbidden (403) channelSectionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale.
invalidValue (400) channelNotActive Co najmniej 1 z podanych kanałów jest nieaktywny.
invalidValue (400) channelsDuplicated Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały.
invalidValue (400) channelsNeeded Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał.
invalidValue (400) channelsNotExpected Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie oczekuje się kanałów.
invalidValue (400) contentDetailsNeeded Zasób, który aktualizujesz, musi zawierać obiekt contentDetails dla tego typu sekcji kanału.
invalidValue (400) idInvalid Właściwość id określa nieprawidłowy identyfikator sekcji kanału.
invalidValue (400) idRequired Właściwość id musi określać wartość identyfikującą aktualizowaną sekcję kanału.
invalidValue (400) inValidPosition Właściwość snippet.position zawiera nieprawidłową wartość.
invalidValue (400) maxChannelsExceeded Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanału.
invalidValue (400) maxPlaylistExceeded Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist.
invalidValue (400) onePlaylistNeeded Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę.
invalidValue (400) ownChannelInChannels Nie możesz dodać własnego kanału do sekcji kanałów, która pojawia się na tym kanale.
invalidValue (400) playlistIsPrivate Co najmniej 1 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 określić właściwość contentDetails.playlists[].
invalidValue (400) playlistsNotExpected Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania.
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, określają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 udało się znaleźć co najmniej 1 z podanych playlist.

kanały

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

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 podać 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 można znaleźć kategorii określonej przez parametr categoryId.
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 Nie udało się zweryfikować jednej z wartości w obiekcie brandingSettings. Użyj metody channels.list, aby pobrać dotychczasowe ustawienia kanału, i zaktualizuj wartości właściwości zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels.
badRequest (400) channelTitleUpdateForbidden Podczas aktualizowania 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 Wartość defaultLanguage musi być ustawiona na aktualizację localizations.
badRequest (400) invalidBrandingOption Jedno z określonych ustawień marki nie istnieje. Użyj metody channels.list, aby pobrać prawidłowe wartości, i pamiętaj, aby zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels.
badRequest (400) invalidCustomMessage Metadane żądania określają nieprawidłową wiadomość niestandardową. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, który wysłał żądanie.
badRequest (400) invalidDuration Metadane żądania określają nieprawidłowy czas trwania w części invideoPromotion.
badRequest (400) invalidDuration Metadane żądania określają nieprawidłowy typ pozycji, który ma służyć do określenia, jak promowany element ma być umieszczony w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, do którego wysłano żądanie.
badRequest (400) invalidRecentlyUploadedBy Metadane żądania określają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, który wysłał żądanie.
badRequest (400) invalidTimingOffset Metadane żądania określają nieprawidłowe przesunięcie czasu w części invideoPromotion.
badRequest (400) invalidTimingOffset Metadane żądania określają nieprawidłowe przesunięcie czasowe, które służy do określania, kiedy promowany produkt powinien być wyświetlany 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, w którym promowany produkt powinien być wyświetlany w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, który wysłał żądanie.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody channels.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu kanałów.
badRequest (400) tooManyPromotedItems W sekcji invideoPromotion przekroczono dozwoloną liczbę promowanych produktó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 udało się znaleźć kanału, który próbuje zaktualizować żądanie do interfejsu API. Sprawdź wartość właściwości id w zasobie channel, który wysłało żądanie, aby upewnić się, że identyfikator kanału jest prawidłowy.
forbidden (403) websiteLinkNotAllowed Podany adres URL witryny jest niedozwolony.
notFound (404) channelNotFound Nie można znaleźć kanału określonego przez parametr id lub nie ma on opcji brandingu.
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 określonego identyfikatora kanału recentlyUploadedBy.
notFound (404) unknownVideoId Nie znaleziono identyfikatora filmu określonego jako promowany produkt.
required (400) requiredItemIdType Metadane żądania muszą określać typ produktu w części invideoPromotion.
required (400) requiredItemId Metadane żądania muszą określać element w części invideoPromotion.
required (400) requiredTimingOffset Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie wysyłanym przez żądanie.
required (400) requiredTimingOffset Metadane żądania muszą określać przesunięcie czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysyła żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie, który wysyła żądanie.
required (400) requiredTiming Metadane żądania muszą określać czas dla każdego elementu w części invideoPromotion.
required (400) requiredVideoId Metadane żądania muszą zawierać identyfikator filmu, aby można było zidentyfikować promowany produkt.
required (400) requiredWebsiteUrl Metadane żądania muszą zawierać adres URL witryny w sekcji invideoPromotion. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie wysyłanym przez żądanie.

commentThreads

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

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 treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) commentsDisabled Film określony przez parametr videoId ma wyłączone komentarze.
forbidden (403) forbidden Nie udało się pobrać co najmniej 1 wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) channelNotFound Nie udało się znaleźć kanału określonego przez parametr 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 upewnić się, że są prawidłowe.
notFound (404) videoNotFound Nie udało się znaleźć filmu określonego przez parametr videoId.

commentThreads.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) channelOrVideoIdMissing Każdy wątek komentarzy musi być połączony z kanałem lub filmem. Upewnij się, że zasób określa wartości właściwości snippet.channelId i snippet.videoId. Komentarz do filmu pojawia się na stronie odtwarzania filmu.
badRequest (400) commentTextRequired Wstawiany zasób comment musi mieć określoną wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Metadane żądania są nieprawidłowe.
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie udało się utworzyć wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Konto YouTube używane do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika, aby można było wstawić komentarz lub wątek komentarzy.
notFound (404) channelNotFound Nie udało się znaleźć określonego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa.
notFound (404) videoNotFound Nie udało się znaleźć określonego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa.

komentarze

W tabelach poniżej 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 żądań.

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 z żądanych komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej 1 z podanych komentarzy. Sprawdź, czy wartości parametrów id i parentId żądania są prawidłowe.

comments.setModerationStatus

Typ błędu Szczegóły błędu Opis
badRequest (400) banWithoutReject Parametru banAuthor można używać tylko wtedy, gdy wartość parametru moderationStatus to rejected.
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400) processingFailure Serwer interfejsu API nie 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ę ustawić stanu moderacji co najmniej 1 komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć co najmniej 1 komentarza, który próbowano zaktualizować. 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 mieć określoną wartość właściwości snippet.textOriginal. Komentarze nie mogą być puste.
badRequest (400) commentTextTooLong Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Użytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu określony we właściwości snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżący widz 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 Wstawiany komentarz musi być powiązany z komentarzem nadrzędnym. Jednak zasób comment w treści żądania do interfejsu API nie określał 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 treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie można utworzyć komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Konto YouTube używane do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika, aby można było wstawić komentarz lub wątek komentarzy.
notFound (404) parentCommentNotFound Nie udało się znaleźć określonego komentarza nadrzędnego. Sprawdź, czy wartość właściwości snippet.parentId w treści żądania jest prawidłowa.

comments.delete

Typ błędu Szczegóły błędu Opis
badRequest (400) processingFailure Serwer interfejsu API nie mógł przetworzyć żądania. 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ń. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) commentNotFound Nie udało się znaleźć określonego komentarza. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

comments.update

Typ błędu Szczegóły błędu Opis
badRequest (400) commentTextTooLong Aktualizowany zasób comment zawiera zbyt wiele znaków we właściwości snippet.textOriginal.
badRequest (400) invalidCommentMetadata Metadane żądania są nieprawidłowe.
badRequest (400) operationNotSupported Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania.
badRequest (400) processingFailure Serwer interfejsu API nie 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 treści żądania, aby upewnić się, że jest prawidłowa.
forbidden (403) forbidden Nie udało się zaktualizować komentarza z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) ineligibleAccount Aby zaktualizować komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika.
notFound (404) commentNotFound Nie udało się znaleźć określonego komentarza. Sprawdź wartość właściwości id w treści żądania, aby upewnić się, że jest prawidłowa.

członkowie

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

members.list

Typ błędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania kanału.
badRequest (400) invalidMode Wartość parametru mode jest nieprawidłowa. Ten błąd może wystąpić, jeśli parametr pageToken określa token, który został pobrany w innym trybie niż określony.
badRequest (400) invalidPageToken Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, gdy token strony użyty w żądaniu wygasł.
badRequest (400) invalidHasAccessToLevel Wartość parametru hasAccessToLevel jest nieprawidłowa. Nie ma poziomu o określonym identyfikatorze id.
badRequest (400) invalidFilterByMemberChannelId Wartość parametru filterByMemberChannelId jest nieprawidłowa. Ten błąd występuje, jeśli wartość parametru filterByMemberChannelId określa więcej niż 100 kanałów.

membershipsLevels

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

membershipsLevels.list

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

playlistItems

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

playlistItems.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma odpowiednich uprawnień do usunięcia określonego elementu playlisty.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty określonego w parametrze 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łane filmy.

playlistItems.insert

Typ błędu Szczegóły błędu Opis
duplicate videoAlreadyInPlaylist Film, który próbujesz dodać do playlisty, już się na niej znajduje.
forbidden (403) playlistContainsMaximumNumberOfVideos Playlista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403) playlistItemsNotAccessible Żądanie nie ma odpowiednich uprawnień do wstawienia określonego elementu playlisty.
invalidValue (400) invalidContentDetails Właściwość contentDetails w żądaniu jest nieprawidłowa. Możliwą przyczyną jest to, że pole contentDetails.note ma więcej niż 280 znaków.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu.
invalidValue (400) invalidResourceType Wartość type podana w identyfikatorze zasobu nie jest obsługiwana w przypadku tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie korzysta z ręcznego sortowania. (np. elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw w ustawieniach playlisty zmienić opcję Kolejność na Ręcznie. Te ustawienia można zmienić w Menedżerze filmów na YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Film, który próbujesz dodać do playlisty, znajduje się już na innej playliście serialu.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wstawiania filmów do określonej playlisty. Nie możesz na przykład wstawić filmu do playlisty Przesłane filmy.
notFound (404) playlistNotFound Nie można znaleźć playlisty określonej w parametrze 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 W żądaniu nie podano wartości wymaganego atrybutu playlistId.
required (400) resourceIdRequired Żądanie musi zawierać zasób, w którym obiekt snippet określa resourceId.

playlistItems.list

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma odpowiednich uprawnień do pobrania określonej playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId w żądaniu.
notFound (404) videoNotFound Nie można znaleźć filmu określonego w parametrze videoId żądania.
required (400) playlistIdRequired Żądanie subskrypcji nie zawiera wartości wymaganego atrybutu 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 umieścić filmu na playliście Do obejrzenia.

playlistItems.update

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie ma odpowiednich uprawnień do zaktualizowania określonego elementu playlisty.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu.
invalidValue (400) invalidResourceType Wartość type podana w identyfikatorze zasobu nie jest obsługiwana w przypadku tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) invalidSnippet Żądanie nie zawiera prawidłowej właściwości snippet.
invalidValue (400) manualSortRequired Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie używa sortowania ręcznego. (Na przykład elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować opcję Kolejność playlisty na Ręczna w ustawieniach playlisty. Te ustawienia można zmienić w Menedżerze filmów na 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 playlistach z przesłanymi filmami.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty określonego we właściwości id żądania.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId w żądaniu.
required (400) channelIdRequired W żądaniu nie podano wartości wymaganego atrybutu 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, aby zidentyfikować aktualizowany element playlisty.

playlisty

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

playlists.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
notFound (404) playlistNotFound Nie można znaleźć playlisty określonej w parametrze 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 Przesłane filmy.

playlists.list

Typ błędu Szczegóły błędu Opis
forbidden (403) channelClosed Kanał określony w parametrze channelId został zamknięty.
forbidden (403) channelSuspended Kanał określony w parametrze channelId został zawieszony.
forbidden (403) playlistForbidden Playlista określona w parametrze 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 można znaleźć playlisty określonej w parametrze id żądania.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości wyświetlania określonej playlisty. Nie możesz na przykład wyświetlić playlisty Do obejrzenia.

playlists.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Wartość defaultLanguage musi być ustawiona na aktualizację localizations.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlists.
badRequest (400) maxPlaylistExceeded Nie można utworzyć playlisty, ponieważ kanał ma już maksymalną dozwoloną 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 Żądanie musi określać tytuł playlisty.

playlists.update

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

subskrypcje

W tabelach poniżej 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 żądań.

subscriptions.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) subscriptionForbidden Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale.
notFound (404) subscriptionNotFound Nie można znaleźć subskrypcji, którą próbujesz usunąć. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

subscriptions.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) subscriptionDuplicate Subskrypcja, którą próbujesz utworzyć, już istnieje.
badRequest (400) subscriptionForbidden Osiągnięto maksymalną liczbę subskrypcji.
badRequest (400) subscriptionForbidden W ostatnim czasie 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 zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale.
notFound (404) publisherNotFound Nie znaleziono zasobu określonego przez właściwość snippet.resourceId żądania.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta zidentyfikowanego w żądaniu.
required (400) publisherRequired Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId do identyfikowania kanału, który jest subskrybowany.

subscriptions.list

Typ błędu Szczegóły błędu Opis
forbidden (403) accountClosed Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte.
forbidden (403) accountSuspended Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone.
forbidden (403) subscriptionForbidden Osoba wysyłająca żądanie nie ma uprawnień dostępu do żądanych subskrypcji.
notFound (404) subscriberNotFound Nie można znaleźć subskrybenta powiązanego z żądaniem.

miniatury

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

thumbnails.set

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidImage Podana treść obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści obrazu.
forbidden (403) forbidden Nie można ustawić miniatury dla określonego filmu. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) forbidden Uwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów.
notFound (404) videoNotFound Nie można znaleźć filmu, do którego próbujesz wstawić obraz miniatury. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa.
tooManyRequests (429) uploadRateLimitExceeded Na kanale przesłano ostatnio zbyt wiele miniatur. Spróbuj ponownie później.

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

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 tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videos. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.

videos.insert

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie.
badRequest (400) invalidDescription Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400) invalidFilename Nazwa pliku wideo podana w nagłówku Slug jest nieprawidłowa.
badRequest (400) invalidPublishAt Metadane żądania określają nieprawidłowy czas zaplanowanej publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania określają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoGameRating Metadane żądania określają nieprawidłową ocenę gry wideo.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId.
badRequest (400) mediaBodyRequired Prośba nie zawiera treści wideo.
badRequest (400) uploadLimitExceeded Osiągnięto dzienny limit przesyłania filmów na kanał. Jest to ograniczenie platformy YouTube i jest całkowicie niezależne od limitu interfejsu API projektu w chmurze Google Cloud.
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 Żądana lista przebojów wideo nie jest obsługiwana lub jest niedostępna.
forbidden (403) forbidden Żądanie nie ma odpowiednich uprawnień dostępu do pliku wideo lub informacji o przetwarzaniu. Części fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu.
forbidden (403) forbidden Prośba nie ma dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie jest prawidłowo autoryzowane do używania parametru myRating.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz odzyskać. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.delete

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie można usunąć filmu, który próbujesz usunąć. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz usunąć. Sprawdź wartość parametru id w żądaniu, aby upewnić się, że jest prawidłowa.

videos.update

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie do interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka szczegółów filmu.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie.
badRequest (400) invalidDefaultBroadcastPrivacySetting Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji.
badRequest (400) invalidDescription Metadane żądania określają nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania określają nieprawidłowy czas zaplanowanej publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania określają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId.
forbidden (403) forbidden Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) forbiddenEmbedSetting Żądanie próbuje ustawić nieprawidłowe ustawienie umieszczania filmu. Niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzaczy umieszczonych w przypadku transmisji 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ź, czy wartość pola id w treści żądania jest prawidłowa.

videos.rate

Typ błędu Szczegóły błędu Opis
badRequest (400) emailNotVerified Przed wystawieniem oceny użytkownik musi zweryfikować swój adres e-mail.
badRequest (400) invalidRating Żądanie zawierał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 Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył oceny dla tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

videos.reportAbuse

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidAbuseReason Żądanie zawierało nieoczekiwaną wartość pola reason_id lub kombinację pól reason_id i secondary_reason_id.
badRequest (400) rateLimitExceeded Użytkownik wysłał zbyt wiele żądań w danym okresie.
forbidden (403) forbidden
notFound (404) videoNotFound Nie udało się znaleźć filmu, którego dotyczy zgłoszenie nadużycia.

znaki wodne,

W tabelach poniżej 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 żądań.

watermarks.set

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

watermarks.unset

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Nie można cofnąć ustawienia znaku wodnego dla wybranego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość.