YouTube Data API - Errors
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.name i snippet.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 id i videoId 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. |
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. |
szukaj
W poniższych tabelach znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami search
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądania.
search.list
Typ błędu |
Szczegóły błędu |
Opis |
badRequest (400) |
invalidChannelId |
Parametr channelId zawiera nieprawidłowy identyfikator kanału. |
badRequest (400) |
invalidLocation |
Wartość parametru location lub locationRadius ma nieprawidłowy format. |
badRequest (400) |
invalidRelevanceLanguage |
Wartość parametru relevanceLanguage ma nieprawidłowy format. |
badRequest (400) |
invalidSearchFilter |
Żądanie zawiera nieprawidłową kombinację filtrów wyszukiwania lub ograniczeń. Jeśli ustawisz wartość parametru eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated lub videoType , parametr type musi mieć wartość video . |
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_id i secondary_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ść. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-02-06 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-02-06 UTC."],[[["The YouTube Data API commonly returns errors such as `forbidden (403)` for authorization issues, `badRequest (400)` for invalid requests, and `notFound (404)` for missing resources."],["Specific API methods like `activities`, `captions`, `channelBanners`, `channelSections`, `playlists`, and `videos` have unique error conditions, including missing parameters, content issues, and permission constraints."],["Errors related to channel management, such as creating, deleting, listing, or updating channel sections or playlists, often involve issues with invalid IDs, missing required fields, exceeding limits, or conflicting configurations."],["Comment and comment thread errors can arise from insufficient permissions, disabled commenting, character limits, private comments, or attempting to reply to non-existent parent comments."],["Errors related to video operations may include problems with category IDs, descriptions, titles, privacy settings, invalid licensing, missing content, exceeding upload limits, and improper reporting of abuse."]]],[]]
komentarze
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
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
iparentId
są prawidłowe.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
można używać tylko wtedy, gdy wartość parametrumoderationStatus
torejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania są prawidłowe.comments.insert
badRequest (400)
commentTextRequired
comment
musi zawierać wartość właściwościsnippet.textOriginal
. Komentarze nie mogą być puste.badRequest (400)
commentTextTooLong
comment
zawiera zbyt wiele znaków w właściwościsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. W zasobiecommentThread
właściwośćsnippet.canReply
wskazuje, czy bieżący użytkownik może odpowiedzieć na wątek.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
w ciele żądania interfejsu API nie zawierał wartości właściwościsnippet.parentId
.badRequest (400)
processingFailure
comment
w ciele żądania, aby mieć pewność, że jest on prawidłowy.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
w treści żądania, aby mieć pewność, że jest prawidłowa.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania, aby się upewnić, że jest prawidłowa.comments.update
badRequest (400)
commentTextTooLong
comment
zawiera w atrybuciesnippet.textOriginal
za dużo znaków.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
w ciele żądania, aby mieć pewność, że jest on prawidłowy.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
w treści żądania, aby mieć pewność, że jest prawidłowa.