W tym dokumencie opisujemy różne typy błędów, które mogą być zwracane przez operacje YouTube Data API. Listę błędów poszczególnych metod znajdziesz w dokumentacji tej metody.
Ogólne błędy
W tabelach poniżej znajdziesz komunikaty o błędach interfejsu API, które nie dotyczą określonej metody API.
Core API errors
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie zostać 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 określa co najmniej 2 parametry, których nie można użyć w tym samym żądaniu. |
badRequest (400) |
invalidFilters |
Żądanie określa nieprawidłowy parametr filtra. |
badRequest (400) |
invalidPageToken |
Żądanie określa nieprawidłowy token strony. |
badRequest (400) |
missingRequiredParameter |
W żądaniu brakuje wymaganego parametru. |
badRequest (400) |
unexpectedParameter |
Żądanie określa nieoczekiwany parametr. |
forbidden (403) |
accountDelegationForbidden |
Uwierzytelniony użytkownik nie może działać w imieniu 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 ten odnosi się do tego drugiego. |
forbidden (403) |
authenticatedUserAccountSuspended |
Konto YouTube uwierzytelnionego użytkownika jest zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd ten odnosi się do tego drugiego. |
forbidden (403) |
authenticatedUserNotChannel |
W tym przypadku musi uwierzytelnić użytkownika do kanału, ale tego nie zrobił. Jeśli żądanie zostało uwierzytelnione i używa parametru przekazania onBehalfOfContentOwner , ustaw też 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 prośbie został zawieszony. |
forbidden (403) |
cmsUserAccountNotFound |
Użytkownik systemu CMS nie może działać w imieniu określonego właściciela treści. |
forbidden (403) |
insufficientCapabilities |
Użytkownik systemu CMS ma niewystarczające możliwości. |
forbidden (403) |
insufficientPermissions |
Token OAuth 2.0 podany w żądaniu określa zakresy 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 |
Wykorzystanie 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. Musisz 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 on dostępny dla wywołanej metody. |
badRequest (400) |
invalidPart |
Parametr part żądania określa niektóre 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 odłączone konto Google, co oznacza, że ma konto Google, ale nie ma kanału w YouTube. Tacy użytkownicy mają dostęp do wielu funkcji zależnych od autoryzacji użytkownika, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later . Przykładowo użytkownik będzie musiał mieć kanał w YouTube, aby móc przesłać film. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, ma już konto Google, ale mógł je wcześniej nie połączyć z kanałem w YouTube.Ten błąd często pojawia się, gdy próbujesz użyć procedury konta 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 dotyczącym interfejsu API YouTube dotyczącym obsługi konta Google szczegółowo opisujemy błąd youtubeSignupRequired . Chociaż w poście na blogu pojawi się opis błędu związanego z interfejsem API w wersji 2.1, jego znaczenie nadal będzie obowiązywać. |
aktywności
activities.insert
nie jest już obsługiwana.
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów activities
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
activities.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
Dane dotyczące aktywności na stronie głównej użytkownika nie są dostępne za pomocą tego interfejsu API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na wartość true . |
forbidden (403) |
forbidden |
Żądanie nie jest poprawnie autoryzowane. |
notFound (404) |
channelNotFound |
Nie można znaleźć identyfikatora kanału zdefiniowanego w parametrze 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. |
captions
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów captions
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
captions.delete
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem nie wystarczą do usunięcia ścieżki napisów. Żądanie może nie zostać 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 są niewystarczające do pobrania ścieżki napisów. Prośba mogła nie zostać poprawnie autoryzowana lub zamówienie wideo nie umożliwiało dodania napisów dla osób trzecich. |
invalidValue (400) |
couldNotConvert |
Nie udało się przekonwertować danych ścieżki napisów na żądany język lub format. Sprawdź, czy żądane wartości tfmt i tlang są prawidłowe, a snippet.status podanej ścieżki audio nie zawiera wartości failed . |
notFound (404) |
captionNotFound |
Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
captions.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
contentRequired |
Żądanie nie zawiera treści ścieżki napisów. |
conflict (409) |
captionExists |
Podany film ma już ścieżkę napisów z snippet.language i snippet.name . Film może mieć wiele ścieżek dla tego samego języka, ale każdy z nich musi mieć inną nazwę.Istnieje kilka sposobów na rozwiązanie problemu. Przed wstawieniem nowej ścieżki możesz usunąć obecną, a następnie wstawić nową. Możesz też zmienić nazwę nowej ścieżki. |
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem są niewystarczające do przesłania ścieżki z napisami. Żądanie może nie zostać prawidłowo autoryzowane. |
invalidValue (400) |
invalidMetadata |
Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie ścieżki. Potwierdź, że żądanie określa prawidłowe wartości właściwości snippet.language , snippet.name i snippet.videoId . Możesz też dodać właściwość snippet.isDraft , ale nie jest to wymagane. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId . |
captions.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
forbidden |
Nie udało się pobrać co najmniej 1 ścieżki napisów, ponieważ uprawnienia powiązane z żądaniem nie są wystarczające do pobrania żądanych zasobów. Żądanie może nie zostać prawidłowo autoryzowane. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć co najmniej 1 z podanych ścieżek napisów. Ten błąd występuje, jeśli parametr videoId identyfikuje rzeczywisty film, ale parametr id identyfikuje identyfikatory ścieżek napisów, które nie istnieją, lub identyfikatory ścieżek powiązanych z innymi filmami. Sprawdź, czy wartości parametrów id i videoId żądania są prawidłowe. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId . |
captions.update
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
contentRequired |
Prośba nie przesłała 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 wystarczają do zaktualizowania ścieżki napisów. Żądanie może nie zostać prawidłowo autoryzowane. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć wskazanej ścieżki napisów. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
Banery kanału
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channelBanners
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
channelBanners.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
bannerAlbumFull |
Twój album z grafikami kanału w YouTube zawiera zbyt wiele obrazów. Otwórz stronę http://photos.google.com, przejdź na stronę albumów i usuń część zdjęć z tego albumu. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści graficznych. |
Sekcje-Kanałów
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channelSections
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
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 przypadku tego kanału. |
invalidValue (400) |
idInvalid |
Właściwość id określa nieprawidłowy identyfikator sekcji kanału. |
invalidValue (400) |
idRequired |
Właściwość id musi zawierać wartość identyfikującą usuwaną sekcję kanału. |
notFound (404) |
channelNotFound |
Nie znaleziono kanału. |
notFound (404) |
channelSectionNotFound |
Nie możemy znaleźć sekcji kanału, którą próbujesz zaktualizować. |
channelSections.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Właściwość snippet.defaultLanguage zasobu channelSection musi być ustawiona, aby można było wstawiać lub aktualizować obiekt localizations dla tego zasobu. |
badRequest (400) |
invalidLanguage |
Jeden z kluczy języków obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Nie można utworzyć tej sekcji kanału. |
badRequest (400) |
styleRequired |
Zasób channelSection musi określać wartość w polu snippet.style . |
badRequest (400) |
targetInvalidCountry |
Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">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 w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
Zasób channelSection musi określać 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 podanych kanałów nie jest aktywny. |
invalidValue (400) |
channelsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane kanały. |
invalidValue (400) |
channelsNeeded |
Jeśli właściwość snippet.type ma wartość multipleChannels , musisz określić właściwość contentDetails.channels[] oraz co najmniej 1 kanał. |
invalidValue (400) |
channelsNotExpected |
Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[] , ale kanały nie są przeznaczone do tego typu kanału. |
invalidValue (400) |
contentDetailsNeeded |
Wstawiony zasób musi zawierać obiekt contentDetails dla tego typu kanału. |
invalidValue (400) |
inValidPosition |
Właściwość snippet.position zawiera nieprawidłową wartość. |
invalidValue (400) |
maxChannelSectionExceeded |
Nie można przetworzyć żądania, ponieważ kanał ma już maksymalną liczbę sekcji. |
invalidValue (400) |
maxChannelsExceeded |
Nie udało się dodać zbyt wielu kanałów do sekcji kanału. |
invalidValue (400) |
maxPlaylistExceeded |
Nie udało się dodać zbyt wielu playlist do sekcji kanału. |
invalidValue (400) |
onePlaylistNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist , to właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę. |
invalidValue (400) |
ownChannelInChannels |
Nie możesz umieścić własnego kanału w sekcji, która pojawia się na nim. |
invalidValue (400) |
playlistIsPrivate |
Co najmniej jedna z określonych playlist jest prywatna i dlatego nie można jej dodać do sekcji kanału. |
invalidValue (400) |
playlistsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane playlisty. |
invalidValue (400) |
playlistsNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists , musisz określić właściwość contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
W zasobie podanym w żądaniu określono wartość właściwości contentDetails.playlists[] , ale w przypadku tego typu sekcji kanału nie należy oczekiwać playlist. |
invalidValue (400) |
snippetNeeded |
Aby utworzyć sekcję kanału, musisz określić snippet . |
invalidValue (400) |
titleLengthExceeded |
Wartość właściwości snippet.title jest za długa. |
invalidValue (400) |
titleRequired |
Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels , musisz określić tytuł sekcji, podając wartość właściwości snippet.title . |
notFound (404) |
channelNotFound |
Nie udało się znaleźć co najmniej jednego z podanych kanałów. |
notFound (404) |
playlistNotFound |
Nie udało się znaleźć co najmniej jednej z określonych playlist. |
channelSections.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
channelSectionForbidden |
Zgłaszający nie ma dostępu do wybranych sekcji kanału. |
invalidValue (400) |
idInvalid |
Żądanie określa nieprawidłowy identyfikator sekcji kanału. |
invalidValue (400) |
invalidCriteria |
Nie można zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału powiązanego z prośbą. |
notFound (404) |
channelSectionNotFound |
Nie można znaleźć sekcji kanału powiązanej z żądaniem. |
channelSections.update
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Właściwość snippet.defaultLanguage zasobu channelSection musi być ustawiona, aby można było wstawiać lub aktualizować obiekt localizations dla tego zasobu. |
badRequest (400) |
invalidLanguage |
Jeden z kluczy języków obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
Tej sekcji kanału nie można edytować. |
badRequest (400) |
styleRequired |
Zasób channelSection musi określać wartość w polu snippet.style . |
badRequest (400) |
targetInvalidCountry |
Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Jedna z wartości na liście targeting.languages nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">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 w dokumentacji zasobów a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
Zasób channelSection musi określać 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 podanych kanałów nie jest aktywny. |
invalidValue (400) |
channelsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane kanały. |
invalidValue (400) |
channelsNeeded |
Jeśli właściwość snippet.type ma wartość multipleChannels , musisz określić właściwość contentDetails.channels[] oraz co najmniej 1 kanał. |
invalidValue (400) |
channelsNotExpected |
Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[] , ale kanały nie są przeznaczone do tego typu kanału. |
invalidValue (400) |
contentDetailsNeeded |
Zasób, który aktualizujesz, musi zawierać obiekt contentDetails dla tego typu 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ść, która identyfikuje uaktualnioną sekcję kanału. |
invalidValue (400) |
inValidPosition |
Właściwość snippet.position zawiera nieprawidłową wartość. |
invalidValue (400) |
maxChannelsExceeded |
Nie udało się dodać zbyt wielu kanałów do sekcji kanału. |
invalidValue (400) |
maxPlaylistExceeded |
Nie udało się dodać zbyt wielu playlist do sekcji kanału. |
invalidValue (400) |
onePlaylistNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist , to właściwość contentDetails.playlists[] musi określać dokładnie jedną playlistę. |
invalidValue (400) |
ownChannelInChannels |
Nie możesz umieścić własnego kanału w sekcji, która pojawia się na nim. |
invalidValue (400) |
playlistIsPrivate |
Co najmniej jedna z określonych playlist jest prywatna i dlatego nie można jej dodać do sekcji kanału. |
invalidValue (400) |
playlistsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ określono zduplikowane playlisty. |
invalidValue (400) |
playlistsNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists , musisz określić właściwość contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
W zasobie podanym w żądaniu określono wartość właściwości contentDetails.playlists[] , ale w przypadku tego typu sekcji kanału nie należy oczekiwać playlist. |
invalidValue (400) |
snippetNeeded |
Musisz określić tag snippet , aby zaktualizować sekcję kanału. |
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 określić tytuł sekcji, podając wartość właściwości snippet.title . |
notFound (404) |
channelNotFound |
Nie udało się znaleźć co najmniej jednego z podanych kanałów. |
notFound (404) |
channelSectionNotFound |
Nie możemy znaleźć sekcji kanału, którą próbujesz zaktualizować. |
notFound (404) |
playlistNotFound |
Nie udało się znaleźć co najmniej jednej z określonych playlist. |
kanały
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów channels
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
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 . Jeśli uwierzytelnianie właściciela treści odbywa się za pomocą parametru onBehalfOfContentOwner , można określić tylko id lub managedByMe . |
forbidden (403) |
channelForbidden |
Kanał określony w parametrze id nie obsługuje żądania lub nie jest on poprawnie autoryzowany. |
notFound (404) |
categoryNotFound |
Nie można znaleźć kategorii określonego przez parametr categoryId . Aby pobrać listę prawidłowych wartości, użyj metody guideCategory.list. |
notFound (404) |
channelNotFound |
Nie można 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 weryfikacji. Użyj metody channels.list , aby pobrać istniejące ustawienia kanału i zaktualizować wartości właściwości zgodnie ze wskazówkami w dokumentacji zasobu channels . |
badRequest (400) |
channelTitleUpdateForbidden |
Podczas aktualizowania brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na aktualny tytuł kanału lub pominąć tę właściwość. Interfejs API zwróci błąd, jeśli zmienisz wartość usługi. |
badRequest (400) |
defaultLanguageNotSetError |
Musisz skonfigurować właściwość defaultLanguage , aby zaktualizować localizations . |
badRequest (400) |
invalidBrandingOption |
Jedno z podanych ustawień marki nie istnieje. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów channels . |
badRequest (400) |
invalidCustomMessage |
Metadane żądania wskazują nieprawidłowy komunikat niestandardowy. 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 określającej położenie promowanego elementu w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, który wysłał żądanie. |
badRequest (400) |
invalidRecentlyUploadedBy |
Metadane żądania podają 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 wskazują nieprawidłowe przesunięcie czasowe w części invideopromotion. |
badRequest (400) |
invalidTimingOffset |
Metadane żądania wskazują nieprawidłowe przesunięcie czasowe określające, kiedy promowany produkt powinien zostać wyświetlony w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysłał żą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. 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. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów kanału. |
badRequest (400) |
tooManyPromotedItems |
W części invideopromotion została przekroczona dozwolona liczba elementów objętych promocją. |
forbidden (403) |
channelForbidden |
Kanał określony w parametrze id nie obsługuje żądania lub nie jest ono prawidłowo autoryzowane. |
forbidden (403) |
promotedVideoNotAllowed |
Nie udało się znaleźć kanału, który próbujesz zaktualizować API. Sprawdź wartość właściwości id w zasobie channel , który wysłał żądanie, aby mieć pewność, ż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 za pomocą parametru id lub nie są dostępne żadne opcje promowania marki. |
notFound (404) |
channelNotFound |
Nie można 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. |
notFound (404) |
unknownVideoId |
Nie można znaleźć identyfikatora filmu określonego jako promowany produkt. |
required (400) |
requiredItemIdType |
Metadane żądania muszą określać typ elementu w sekcji invideopromotion. |
required (400) |
requiredItemId |
Metadane żądania muszą zawierać identyfikator elementu, który jest częścią invideopromotion. |
required (400) |
requiredTimingOffset |
Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mogło 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 czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie wysyłanym przez żądanie. |
required (400) |
requiredTimingType |
Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie. |
required (400) |
requiredTimingType |
Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie wysyłanym przez żądanie. |
required (400) |
requiredTiming |
Metadane żądania muszą zawierać informacje o czasie w elemencie 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. |
wątki
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów commentThreads
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
commentThreads.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
operationNotSupported |
Filtr identyfikatorów jest zgodny tylko z komentarzami opartymi na Google+. |
badRequest (400) |
processingFailure |
Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest on prawidłowy. |
forbidden (403) |
commentsDisabled |
Film zidentyfikowany przez parametr videoId wyłączył komentarze. |
forbidden (403) |
forbidden |
Nie można pobrać co najmniej 1 z wątków komentarzy z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału wskazanego w parametrze channelId lub allThreadsRelatedToChannelId . |
notFound (404) |
commentThreadNotFound |
Nie udało się znaleźć co najmniej 1 z podanych wątków komentarzy. Sprawdź, czy wartości parametru id żądania są prawidłowe. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId . |
commentThreads.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Każdy wątek komentarzy musi być połączony z kanałem lub filmem.
|
badRequest (400) |
commentTextRequired |
Wstawiony zasób comment musi określać wartość właściwości snippet.topLevelComment.snippet.textOriginal . Komentarze nie mogą być puste. |
badRequest (400) |
commentTextTooLong |
Wstawiony 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 |
Serwerowi interfejsu API nie udało się przetworzyć żądania. Może to być błąd przejściowy, ale zwykle wskazuje, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest on prawidłowy. |
forbidden (403) |
forbidden |
Nie udało się utworzyć wątku z komentarzem z powodu niewystarczających uprawnień. Żądanie może nie zostać prawidłowo autoryzowane. |
forbidden (403) |
ineligibleAccount |
Aby wstawić komentarz lub wątek komentarzy, konto YouTube użyte do autoryzacji żądania do interfejsu API musi zostać połączone z kontem Google użytkownika. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć tego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć podanego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa. |
użytkownicy
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów members
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
members.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Kanał twórcy, który autoryzował żądanie, 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 w innym trybie niż ten określony. |
badRequest (400) |
invalidPageToken |
Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, jeśli token strony użyty w prośbie wygasł. |
badRequest (400) |
invalidHasAccessToLevel |
Wartość parametru hasAccessToLevel jest nieprawidłowa. Nie ma poziomu o podanym id . |
badRequest (400) |
invalidFilterByMemberChannelId |
Wartość parametru filterByMemberChannelId jest nieprawidłowa. Ten błąd występuje wtedy, gdy wartość parametru filterByMemberChannelId określa więcej niż 100 kanałów. |
Poziomy wspierania
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów members
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
membershipsLevels.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Kanał twórcy, który autoryzował żądanie, nie ma włączonego wspierania. |
playlistaElementów
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów playlistItems
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
playlistItems.delete
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie jest prawidłowo autoryzowane do usunięcia wskazanego elementu playlisty. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć elementu playlisty z parametrem id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje usuwania filmów z określonej playlisty. Nie możesz np. usunąć filmu z przesłanej playlisty. |
playlistItems.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
duplicate |
videoAlreadyInPlaylist |
Film, który próbujesz dodać do playlisty, znajduje się już na playliście. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
Playlista zawiera już maksymalną dozwoloną liczbę elementów. |
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma uprawnień do wstawienia określonego elementu playlisty. |
invalidValue (400) |
invalidContentDetails |
Właściwość contentDetails w żądaniu jest nieprawidłowa. Prawdopodobna przyczyna 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 polu snippet zasobu. |
invalidValue (400) |
invalidResourceType |
Parametr type podany dla identyfikatora zasobu nie jest obsługiwany w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video . |
invalidValue (400) |
manualSortRequired |
Żądanie próbuje określić pozycję elementu playlisty, ale playlista nie jest sortowana ręcznie. (Na przykład elementy na playliście mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby pozycja z playlisty miała określoną pozycję, najpierw musisz w jej ustawieniach zmienić opcję Kolejność na Ręcznie. Te ustawienia możesz dostosować w Menedżerze filmów w YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Film, który próbujesz dodać do playlisty, znajduje się już na innej playliście. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje funkcji wstawiania filmów na określonej playliście. Na przykład nie możesz wstawić filmu do przesłanej playlisty. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który chcesz dodać do playlisty. Sprawdź, czy wartość właściwości videoId jest prawidłowa. |
required (400) |
channelIdRequired |
Żądanie nie określa wartości wymaganej właściwości channelId . |
required (400) |
playlistIdRequired |
Żądanie nie określa wartości wymaganej właściwości playlistId . |
required (400) |
resourceIdRequired |
Żądanie musi zawierać zasób, w którym obiekt snippet określa właściwość 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 można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu wskazanego w parametrze videoId żądania. |
required (400) |
playlistIdRequired |
Prośba o subskrypcję nie określa wartości wymaganej właściwości playlistId . |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje wyświetlania listy filmów z określonej playlisty. Na przykład nie możesz 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 wskazanego elementu playlisty. |
invalidValue (400) |
invalidPlaylistItemPosition |
Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w polu snippet zasobu. |
invalidValue (400) |
invalidResourceType |
Parametr type podany dla identyfikatora zasobu nie jest obsługiwany w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video . |
invalidValue (400) |
invalidSnippet |
Żądanie nie określa prawidłowej właściwości snippet . |
invalidValue (400) |
manualSortRequired |
Żądanie próbuje określić pozycję elementu playlisty, ale playlista nie jest sortowana ręcznie. (Na przykład elementy na playliście mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby pozycja z playlisty miała określoną pozycję, najpierw musisz w jej ustawieniach zmienić opcję Kolejność na Ręcznie. Te ustawienia możesz dostosować w Menedżerze filmów w YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje aktualizowania filmów na określonej playliście. Na przykład nie możesz zaktualizować filmu na przesłanej playliście. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć playlisty z właściwością id żądania. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania. |
required (400) |
channelIdRequired |
Żądanie nie określa wartości wymaganej właściwości channelId . |
required (400) |
playlistIdRequired |
Żądanie nie określa wartości wymaganej właściwości playlistId . |
required (400) |
playlistItemIdRequired |
Aby wskazać element, który jest aktualizowany, playlista musi zawierać właściwość id . |
playlist(y)
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów playlists
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
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 zidentyfikowanej za pomocą parametru id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje usuwania określonej playlisty. Nie możesz na przykład usunąć przesłanej playlisty filmów. |
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 z parametrem id żądania nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
channelNotFound |
Nie można znaleźć kanału określonego w parametrze channelId . |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości wyświetlania określonej playlisty. Nie możesz na przykład dodać playlisty do obejrzenia później. |
playlists.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Musisz skonfigurować właściwość defaultLanguage , aby zaktualizować 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 zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów playlist. |
badRequest (400) |
maxPlaylistExceeded |
Nie można utworzyć playlisty, ponieważ na kanale jest już maksymalna dozwolona liczba playlist. |
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
invalidValue (400) |
invalidPlaylistSnippet |
Żądanie zawiera nieprawidłowy fragment playlisty. |
required (400) |
playlistTitleRequired |
Żądanie musi określać tytuł playlisty. |
playlists.update
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Musisz skonfigurować właściwość defaultLanguage , aby zaktualizować 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 zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów playlist. |
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
invalidValue (400) |
invalidPlaylistSnippet |
Żądanie zawiera nieprawidłowy fragment playlisty. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje aktualizowania określonej playlisty. Nie możesz na przykład zmieniać właściwości przesłanej playlisty. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania. |
required (400) |
playlistTitleRequired |
Żądanie musi określać tytuł playlisty. |
search
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów search
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
search.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
invalidChannelId |
Parametr channelId określa nieprawidłowy identyfikator kanału. |
badRequest (400) |
invalidLocation |
Wartość parametru location lub locationRadius została nieprawidłowo sformatowana. |
badRequest (400) |
invalidRelevanceLanguage |
Wartość parametru relevanceLanguage jest nieprawidłowo sformatowana. |
badRequest (400) |
invalidSearchFilter |
Żądanie zawiera nieprawidłową kombinację filtrów wyszukiwania lub ograniczeń. Pamiętaj, że parametr type musi mieć wartość video , jeśli ustawisz wartości parametrów eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated lub videoType . |
badRequest (400) |
invalidVideoId |
Parametr relatedToVideo określa nieprawidłowy identyfikator filmu. |
subskrypcje
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów subscriptions
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
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 przypadku tego kanału. |
notFound (404) |
subscriptionNotFound |
Nie udało się 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 |
Masz już maksymalną liczbę subskrypcji. |
badRequest (400) |
subscriptionForbidden |
Zbyt wiele nowych subskrypcji. 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 przypadku tego kanału. |
notFound (404) |
publisherNotFound |
Nie można znaleźć zasobu określonego we właściwości snippet.resourceId żądania. |
notFound (404) |
subscriberNotFound |
Nie udało się znaleźć subskrybenta określonego w żądaniu. |
required (400) |
publisherRequired |
Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId do identyfikacji subskrybowanego kanału. |
subscriptions.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
accountClosed |
Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte. |
forbidden (403) |
accountSuspended |
Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone. |
forbidden (403) |
subscriptionForbidden |
Osoba, która wysłała prośbę, nie ma dostępu do wybranych subskrypcji. |
notFound (404) |
subscriberNotFound |
Nie udało się znaleźć subskrybenta określonego w żądaniu. |
miniatury
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów thumbnails
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
thumbnails.set
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
invalidImage |
Dostarczona treść obrazu jest nieprawidłowa. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści graficznych. |
forbidden (403) |
forbidden |
Nie można ustawić miniatury dla określonego filmu. Żądanie może nie zostać 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, dla którego próbujesz wstawić miniaturę. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa. |
VideoAbuseReportReasons
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videoAbuseReportReasons
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
videoAbuseReportReasons.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie zostać prawidłowo autoryzowane. |
Kategorie filmów wideo
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videoCategories
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
videoCategories.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Nie można znaleźć kategorii filmu wskazywanej przez parametr id . Aby pobrać listę prawidłowych wartości, użyj metody videoCategory.list. |
filmy
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów videos
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
videos.insert
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Żądanie próbuje dodać zlokalizowane szczegóły filmu bez określania domyślnego języka szczegółów filmu. |
badRequest (400) |
invalidCategoryId |
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list . |
badRequest (400) |
invalidDescription |
Metadane żądania podaj nieprawidłowy opis filmu. |
badRequest (400) |
invalidFilename |
Nazwa pliku wideo podana w nagłówku Slug jest nieprawidłowa. |
badRequest (400) |
invalidPublishAt |
Metadane żądania wskazują nieprawidłowy czas publikacji. |
badRequest (400) |
invalidRecordingDetails |
Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania. |
badRequest (400) |
invalidTags |
Metadane żądania określają nieprawidłowe słowa kluczowe wideo. |
badRequest (400) |
invalidTitle |
Metadane żądania podają nieprawidłowy lub pusty tytuł filmu. |
badRequest (400) |
invalidVideoGameRating |
Metadane żądania wskazują nieprawidłową ocenę gry wideo. |
badRequest (400) |
invalidVideoMetadata |
Metadane żądania są nieprawidłowe. Ten błąd występuje, gdy żądanie aktualizuje część snippet zasobu video , ale nie ustawia wartości obu właściwości snippet.title i snippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści wideo. |
badRequest (400) |
uploadLimitExceeded |
Użytkownik przekroczył liczbę przesłanych filmów. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
Żądanie próbuje ustawić nieprawidłową licencję na film. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności filmu. |
videos.list
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
videoChartNotFound |
Żądany wykres wideo nie jest obsługiwany lub jest niedostępny. |
forbidden (403) |
forbidden |
Żądanie nie ma uprawnień dostępu do pliku wideo lub informacji o przetwarzaniu. Pamiętaj, że fragmenty 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 poprawnie autoryzowane do używania parametru myRating . |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz pobrać. 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 zostać prawidłowo autoryzowane. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz usunąć. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
videos.update
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Żądanie API próbuje dodać zlokalizowane szczegóły filmu bez określania domyślnego języka szczegółów filmu. |
badRequest (400) |
invalidCategoryId |
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list . |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności dla transmisji domyślnej. |
badRequest (400) |
invalidDescription |
Metadane żądania podaj nieprawidłowy opis filmu. |
badRequest (400) |
invalidPublishAt |
Metadane żądania wskazują nieprawidłowy czas publikacji. |
badRequest (400) |
invalidRecordingDetails |
Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania. |
badRequest (400) |
invalidTags |
Metadane żądania określają nieprawidłowe słowa kluczowe wideo. |
badRequest (400) |
invalidTitle |
Metadane żądania podają nieprawidłowy lub pusty tytuł filmu. |
badRequest (400) |
invalidVideoMetadata |
Metadane żądania są nieprawidłowe. Ten błąd występuje, gdy żądanie aktualizuje część snippet zasobu video , ale nie ustawia wartości obu właściwości snippet.title i snippet.categoryId . |
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie zostać prawidłowo autoryzowane. |
forbidden (403) |
forbiddenEmbedSetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie umieszczenia filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy podczas transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube. |
forbidden (403) |
forbiddenLicenseSetting |
Żądanie próbuje ustawić nieprawidłową licencję na film. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy pole id w treści żądania jest prawidłowe. |
videos.rate
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
emailNotVerified |
Przed wystawieniem oceny użytkownik musi potwierdzić swój adres e-mail. |
badRequest (400) |
invalidRating |
Żądanie zawiera nieoczekiwaną wartość parametru rating . |
badRequest (400) |
videoPurchaseRequired |
Wypożyczone filmy mogą być oceniane tylko przez użytkowników, którzy je wypożyczyli. |
forbidden (403) |
forbidden |
Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie zostać prawidłowo autoryzowane. |
forbidden (403) |
videoRatingDisabled |
Właściciel filmu, który próbujesz ocenić, wyłączył oceny tego filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
videos.reportAbuse
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
invalidAbuseReason |
Żądanie zawiera nieoczekiwaną wartość dla 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, które interfejs API zwraca w odpowiedzi na wywołania zasobów watermarks
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.
watermarks.set
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
Format podanego obrazu jest nieobsługiwany. |
badRequest (400) |
imageTooTall |
Przesłany obraz jest za wysoki. |
badRequest (400) |
imageTooWide |
Przesłany obraz jest za szeroki. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści graficznych. |
forbidden (403) |
forbidden |
Nie można ustawić znaku wodnego dla konkretnego kanału. Żądanie może nie zostać prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość. |
watermarks.unset
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
forbidden (403) |
forbidden |
Znaku wodnego nie można cofnąć w przypadku określonego kanału. Żądanie może nie zostać prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość. |
komentarza
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania zasobów
comments
. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
iparentId
żądania są prawidłowe.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
można używać tylko wtedy, gdy wartość parametrumoderationStatus
jestrejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania są prawidłowe.comments.insert
badRequest (400)
commentTextRequired
comment
musi określać wartość właściwościsnippet.textOriginal
. Komentarze nie mogą być puste.badRequest (400)
commentTextTooLong
comment
zawiera zbyt wiele znaków we właściwościsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. W zasobiecommentThread
właściwośćsnippet.canReply
wskazuje, czy bieżący przeglądający może odpowiedzieć w wątku.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
w treści żądania do interfejsu API nie określa jednak wartości właściwościsnippet.parentId
.badRequest (400)
processingFailure
comment
w treści żądania, aby upewnić się, że jest on prawidłowy.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
jest prawidłowa.comments.markAsSpam
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania są prawidłowe.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
żądania jest prawidłowa.comments.update
badRequest (400)
commentTextTooLong
comment
, który jest aktualizowany, zawiera zbyt wiele znaków we właściwościsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
w treści żądania, aby upewnić się, że jest on prawidłowy.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
jest prawidłowa.