W tym dokumencie opisujemy różne typy błędów, które mogą zwracać operacje YouTube Data API. Listę błędów dla poszczególnych metod znajdziesz też w dokumentacji referencyjnej dotyczącej danej metody.
Błędy ogólne
W tabelach poniżej znajdziesz komunikaty o błędach interfejsu API, które nie są specyficzne dla konkretnej metody interfejsu API.
Core API errors
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane. |
quotaExceeded (403) |
quotaExceeded |
Nie można zrealizować żądania, ponieważ został przekroczony Twój limit. |
Common request errors
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
incompatibleParameters |
Żądanie zawiera co najmniej 2 parametry, których nie można używać w tym samym żądaniu. |
badRequest (400) |
invalidFilters |
Żądanie zawiera nieprawidłowy parametr filtra. |
badRequest (400) |
invalidPageToken |
Żądanie zawiera nieprawidłowy token strony. |
badRequest (400) |
missingRequiredParameter |
W żądaniu brakuje wymaganego parametru. |
badRequest (400) |
unexpectedParameter |
Żądanie określa nieoczekiwany parametr. |
forbidden (403) |
accountDelegationForbidden |
Uwierzytelniony użytkownik nie może działać w imieniu określonego konta Google. |
forbidden (403) |
authenticatedUserAccountClosed |
Konto YouTube uwierzytelnionego użytkownika jest zamknięte. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd dotyczy tego drugiego konta. |
forbidden (403) |
authenticatedUserAccountSuspended |
Konto YouTube uwierzytelnionego użytkownika zostało zawieszone. Jeśli uwierzytelniony użytkownik działa w imieniu innego konta Google, błąd dotyczy tego drugiego konta. |
forbidden (403) |
authenticatedUserNotChannel |
W przypadku tego żądania uwierzytelniony użytkownik musi zostać rozpoznany jako kanał, ale tak się nie dzieje. Jeśli Twoje żądanie jest uwierzytelnione i używa parametru przekazywania uprawnień onBehalfOfContentOwner, musisz też ustawić parametr onBehalfOfContentOwnerChannel. |
forbidden (403) |
channelClosed |
Kanał określony w żądaniu został zamknięty. |
forbidden (403) |
channelNotFound |
Nie udało się znaleźć kanału wskazanego w żądaniu. |
forbidden (403) |
channelSuspended |
Kanał określony w żądaniu został zawieszony. |
forbidden (403) |
cmsUserAccountNotFound |
Użytkownik CMS nie może działać w imieniu określonego właściciela treści. |
forbidden (403) |
insufficientCapabilities |
Użytkownik CMS ma niewystarczające uprawnienia. |
forbidden (403) |
insufficientPermissions |
Token OAuth 2.0 podany w żądaniu określa zakresy, które są niewystarczające do uzyskania dostępu do żądanych danych. |
notFound (404) |
contentOwnerAccountNotFound |
Nie znaleziono podanego konta właściciela treści. |
Request context errors
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
invalidLanguage |
Wartość parametru hl nie określa prawidłowego kodu języka. |
badRequest (400) |
invalidMine |
Użycie parametru mine w żądaniu nie jest obsługiwane. |
badRequest (400) |
invalidMine |
Parametru mine nie można używać w żądaniach, w których uwierzytelniony użytkownik jest partnerem YouTube. Usuń parametr mine, uwierzytelnij się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działaj jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest dostępny dla wywołanej metody. |
badRequest (400) |
invalidPart |
Parametr part żądania określa pewne części, których nie można zapisać jednocześnie. |
badRequest (400) |
invalidRegionCode |
Parametr regionCode określa nieprawidłowy kod regionu. |
badRequest (400) |
unexpectedPart |
Parametr part żądania określa nieoczekiwaną wartość. |
badRequest (400) |
unknownPart |
Parametr part żądania określa nieznaną wartość. |
badRequest (400) |
unsupportedLanguageCode |
Wartość parametru hl nie określa obsługiwanego kodu języka. |
badRequest (400) |
unsupportedRegionCode |
Parametr regionCode określa nieobsługiwany kod regionu. |
unauthorized (401) |
authorizationRequired |
Żądanie używa parametru mine, ale nie jest prawidłowo autoryzowane. |
unauthorized (401) |
youtubeSignupRequired |
Ten błąd oznacza, że użytkownik ma niepołączone konto Google, czyli ma konto Google, ale nie ma kanału w YouTube. Tacy użytkownicy mają dostęp do wielu funkcji, które wymagają autoryzacji, takich jak ocenianie filmów czy dodawanie filmów do playlisty watch_later. Aby na przykład przesłać film, użytkownik musi mieć kanał w YouTube. Użytkownik, który ma konto Gmail lub urządzenie z Androidem, na pewno ma konto Google, ale może nie mieć jeszcze powiązanego z nim kanału YouTube.Ten błąd często pojawia się, gdy próbujesz użyć przepływu konta usługi OAuth 2.0. YouTube nie obsługuje kont usługi, więc jeśli spróbujesz uwierzytelnić się za pomocą takiego konta, pojawi się ten błąd. Więcej informacji o błędzie youtubeSignupRequired znajdziesz w poście na blogu interfejsu API YouTube, w którym przedstawiono obsługę kont Google. Chociaż post na blogu wyjaśnia błąd w interfejsie API w wersji 2.1, znaczenie błędu jest nadal aktualne. |
aktywności
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami activities. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
activities.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
homeParameterDeprecated |
Dane o aktywności użytkownika na stronie głównej nie są dostępne w tym interfejsie API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na true. |
forbidden (403) |
forbidden |
Żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
channelNotFound |
Nie można znaleźć identyfikatora kanału określonego przez parametr channelId żądania. |
notFound (404) |
homeChannelNotFound |
Nie można znaleźć kanału na stronie głównej YouTube dla obecnie uwierzytelnionego użytkownika. |
unauthorized (401) |
authorizationRequired |
Żądanie używa parametru home, ale nie jest prawidłowo autoryzowane. |
napisy
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami captions. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
captions.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem nie są wystarczające, aby usunąć ścieżkę z napisami. Żądanie może nie być prawidłowo autoryzowane. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
captions.download
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane. |
invalidValue (400) |
couldNotConvert |
Nie udało się przekonwertować danych ścieżki z napisami na żądany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe, a wartość snippet.status żądanego ścieżki napisów nie jest równa failed. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
captions.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
contentRequired |
Żądanie nie zawiera treści ścieżki z napisami. |
conflict (409) |
captionExists |
Określony film ma już ścieżkę z napisami o podanym snippet.language i snippet.name. Film może mieć kilka ścieżek w tym samym języku, ale każda z nich musi mieć inną nazwę.Ten błąd można rozwiązać na kilka sposobów. Możesz usunąć istniejącą ścieżkę, a potem wstawić nową lub zmienić nazwę nowej ścieżki przed jej wstawieniem. |
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem nie są wystarczające do przesłania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane. |
invalidValue (400) |
invalidMetadata |
Żądanie zawiera nieprawidłowe wartości metadanych, co uniemożliwia utworzenie ścieżki. Sprawdź, czy w żądaniu podano prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Można też uwzględnić właściwość snippet.isDraft, ale nie jest to wymagane. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId. |
invalidValue (400) |
nameTooLong |
Wartość snippet.name podana w żądaniu jest za długa. Maksymalna długość to 150 znaków. |
captions.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Nie udało się pobrać co najmniej 1 ścieżki z napisami, ponieważ uprawnienia powiązane z żądaniem są niewystarczające do pobrania żądanych zasobów. Żądanie może nie być prawidłowo autoryzowane. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć co najmniej 1 z określonych ścieżek z napisami. Ten błąd występuje, gdy parametr videoId identyfikuje rzeczywisty film, ale parametr id identyfikuje identyfikatory ścieżek z napisami, które nie istnieją, lub identyfikatory ścieżek powiązane z innymi filmami. Sprawdź, czy wartości parametrów id i videoId żądania są prawidłowe. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId. |
captions.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
contentRequired |
W ramach żądania nie przesłano zaktualizowanego pliku z napisami. Rzeczywista zawartość ścieżki jest wymagana, jeśli parametr sync jest ustawiony na true. |
forbidden (403) |
forbidden |
Uprawnienia powiązane z żądaniem nie są wystarczające do zaktualizowania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane. |
notFound (404) |
captionNotFound |
Nie udało się znaleźć określonej ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
channelBanners
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami channelBanners. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channelBanners.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
bannerAlbumFull |
Album z grafiką kanału na YouTube zawiera zbyt wiele obrazów. Otwórz stronę http://photos.google.com, przejdź do strony albumów i usuń niektóre obrazy z tego albumu. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści obrazu. |
channelSections
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami channelSections. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channelSections.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
notEditable |
Tej sekcji kanału nie można usunąć. |
forbidden (403) |
channelSectionForbidden |
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale. |
invalidValue (400) |
idInvalid |
Właściwość id określa nieprawidłowy identyfikator sekcji kanału. |
invalidValue (400) |
idRequired |
Właściwość id musi określać wartość identyfikującą usuwaną sekcję kanału. |
notFound (404) |
channelNotFound |
Nie znaleziono kanału. |
notFound (404) |
channelSectionNotFound |
Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować. |
channelSections.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Aby wstawić lub zaktualizować obiekt localizations dla danego zasobu, musisz ustawić właściwość snippet.defaultLanguage zasobu channelSection. |
badRequest (400) |
invalidLanguage |
Jeden z kluczy językowych obiektu localizations nie przeszedł weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections. |
badRequest (400) |
notEditable |
Nie można utworzyć tej sekcji kanału. |
badRequest (400) |
styleRequired |
Zasób channelSection musi mieć określoną wartość pola snippet.style. |
badRequest (400) |
targetInvalidCountry |
Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections. |
badRequest (400) |
targetInvalidLanguage |
Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections. |
badRequest (400) |
targetInvalidRegion |
Jedna z wartości na liście targeting.regions nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections. |
badRequest (400) |
typeRequired |
Zasób channelSection musi mieć określoną wartość pola snippet.type. |
forbidden (403) |
channelSectionForbidden |
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale. |
invalidValue (400) |
channelNotActive |
Co najmniej 1 z podanych kanałów jest nieaktywny. |
invalidValue (400) |
channelsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały. |
invalidValue (400) |
channelsNeeded |
Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał. |
invalidValue (400) |
channelsNotExpected |
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie oczekuje się kanałów. |
invalidValue (400) |
contentDetailsNeeded |
Wstawiany zasób musi zawierać obiekt contentDetails dla tego typu sekcji kanału. |
invalidValue (400) |
inValidPosition |
Właściwość snippet.position zawiera nieprawidłową wartość. |
invalidValue (400) |
maxChannelSectionExceeded |
Nie można zrealizować prośby, ponieważ kanał ma już maksymalną liczbę sekcji. |
invalidValue (400) |
maxChannelsExceeded |
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanału. |
invalidValue (400) |
maxPlaylistExceeded |
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist. |
invalidValue (400) |
onePlaylistNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę. |
invalidValue (400) |
ownChannelInChannels |
Nie możesz dodać własnego kanału do sekcji kanałów, która pojawia się na tym kanale. |
invalidValue (400) |
playlistIsPrivate |
Co najmniej 1 z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału. |
invalidValue (400) |
playlistsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty. |
invalidValue (400) |
playlistsNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy określić właściwość contentDetails.playlists[]. |
invalidValue (400) |
playlistsNotExpected |
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania. |
invalidValue (400) |
snippetNeeded |
Aby utworzyć sekcję kanału, musisz określić snippet. |
invalidValue (400) |
titleLengthExceeded |
Wartość właściwości snippet.title jest za długa. |
invalidValue (400) |
titleRequired |
Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, określając wartość właściwości snippet.title. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć co najmniej 1 z podanych kanałów. |
notFound (404) |
playlistNotFound |
Nie udało się znaleźć co najmniej 1 z podanych playlist. |
channelSections.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
channelSectionForbidden |
Zgłaszający nie ma uprawnień dostępu do żądanych sekcji kanału. |
invalidValue (400) |
idInvalid |
Żądanie określa nieprawidłowy identyfikator sekcji kanału. |
invalidValue (400) |
invalidCriteria |
Nie udało się zrealizować żądania, ponieważ kryteria filtrowania są nieprawidłowe. |
notFound (404) |
channelNotFound |
Nie można znaleźć kanału powiązanego z żądaniem. |
notFound (404) |
channelSectionNotFound |
Nie znaleziono sekcji kanału powiązanej z żądaniem. |
channelSections.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Aby wstawić lub zaktualizować obiekt localizations dla danego zasobu, musisz ustawić właściwość snippet.defaultLanguage zasobu channelSection. |
badRequest (400) |
invalidLanguage |
Nie udało się zweryfikować jednego z kluczy językowych obiektu localizations. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections. |
badRequest (400) |
notEditable |
Tej sekcji kanału nie można edytować. |
badRequest (400) |
styleRequired |
Zasób channelSection musi mieć określoną wartość pola snippet.style. |
badRequest (400) |
targetInvalidCountry |
Jedna z wartości na liście targeting.countries nie przeszła weryfikacji. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections. |
badRequest (400) |
targetInvalidLanguage |
Weryfikacja jednej z wartości na liście targeting.languages nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie z wytycznymi w dokumentacji zasobu channelSections. |
badRequest (400) |
targetInvalidRegion |
Weryfikacja jednej z wartości na liście targeting.regions nie powiodła się. Użyj metody channelSections.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channelSections. |
badRequest (400) |
typeRequired |
Zasób channelSection musi mieć określoną wartość pola snippet.type. |
forbidden (403) |
channelSectionForbidden |
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale. |
invalidValue (400) |
channelNotActive |
Co najmniej 1 z podanych kanałów jest nieaktywny. |
invalidValue (400) |
channelsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane kanały. |
invalidValue (400) |
channelsNeeded |
Jeśli właściwość snippet.type ma wartość multipleChannels, musisz określić właściwość contentDetails.channels[] i podać co najmniej 1 kanał. |
invalidValue (400) |
channelsNotExpected |
Zasób podany w żądaniu określa wartość właściwości contentDetails.channels[], ale w przypadku tego typu sekcji kanału nie oczekuje się kanałów. |
invalidValue (400) |
contentDetailsNeeded |
Zasób, który aktualizujesz, musi zawierać obiekt contentDetails dla tego typu sekcji kanału. |
invalidValue (400) |
idInvalid |
Właściwość id określa nieprawidłowy identyfikator sekcji kanału. |
invalidValue (400) |
idRequired |
Właściwość id musi określać wartość identyfikującą aktualizowaną sekcję kanału. |
invalidValue (400) |
inValidPosition |
Właściwość snippet.position zawiera nieprawidłową wartość. |
invalidValue (400) |
maxChannelsExceeded |
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić zbyt wiele kanałów w sekcji kanału. |
invalidValue (400) |
maxPlaylistExceeded |
Żądanie nie zostało zrealizowane, ponieważ próbowano uwzględnić w sekcji kanału zbyt wiele playlist. |
invalidValue (400) |
onePlaylistNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist, właściwość contentDetails.playlists[] musi określać dokładnie 1 playlistę. |
invalidValue (400) |
ownChannelInChannels |
Nie możesz dodać własnego kanału do sekcji kanałów, która pojawia się na tym kanale. |
invalidValue (400) |
playlistIsPrivate |
Co najmniej 1 z podanych playlist jest prywatna, dlatego nie można jej uwzględnić w sekcji kanału. |
invalidValue (400) |
playlistsDuplicated |
Żądanie nie zostało zrealizowane, ponieważ zawierało zduplikowane playlisty. |
invalidValue (400) |
playlistsNeeded |
Jeśli właściwość snippet.type ma wartość singlePlaylist lub multiplePlaylists, należy określić właściwość contentDetails.playlists[]. |
invalidValue (400) |
playlistsNotExpected |
Zasób podany w żądaniu zawierał wartość właściwości contentDetails.playlists[], ale w przypadku tego typu sekcji kanału nie oczekuje się list odtwarzania. |
invalidValue (400) |
snippetNeeded |
Aby zaktualizować sekcję kanału, musisz podać snippet. |
invalidValue (400) |
titleLengthExceeded |
Wartość właściwości snippet.title jest za długa. |
invalidValue (400) |
titleRequired |
Jeśli właściwość snippet.type ma wartość multiplePlaylists lub multipleChannels, musisz ustawić tytuł sekcji, określając wartość właściwości snippet.title. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć co najmniej 1 z podanych kanałów. |
notFound (404) |
channelSectionNotFound |
Nie można znaleźć sekcji kanału, którą próbujesz zaktualizować. |
notFound (404) |
playlistNotFound |
Nie udało się znaleźć co najmniej 1 z podanych playlist. |
kanały
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami channels. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
channels.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
invalidCriteria |
Można określić maksymalnie jeden z tych filtrów:id, mySubscribers, categoryId, mine, managedByMe, forUsername. W przypadku uwierzytelniania właściciela treści za pomocą parametru onBehalfOfContentOwner można podać tylko id lub managedByMe. |
forbidden (403) |
channelForbidden |
Kanał określony przez parametr id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
categoryNotFound |
Nie można znaleźć kategorii określonej przez parametr categoryId. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału określonego w parametrze id. |
channels.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
brandingValidationError |
Nie udało się zweryfikować jednej z wartości w obiekcie brandingSettings. Użyj metody channels.list, aby pobrać dotychczasowe ustawienia kanału, i zaktualizuj wartości właściwości zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels. |
badRequest (400) |
channelTitleUpdateForbidden |
Podczas aktualizowania brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na bieżący tytuł kanału lub pominąć tę właściwość. Jeśli zmienisz wartość właściwości, interfejs API zwróci błąd. |
badRequest (400) |
defaultLanguageNotSetError |
Wartość defaultLanguage musi być ustawiona na aktualizację localizations. |
badRequest (400) |
invalidBrandingOption |
Jedno z określonych ustawień marki nie istnieje. Użyj metody channels.list, aby pobrać prawidłowe wartości, i pamiętaj, aby zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu channels. |
badRequest (400) |
invalidCustomMessage |
Metadane żądania określają nieprawidłową wiadomość niestandardową. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, który wysłał żądanie. |
badRequest (400) |
invalidDuration |
Metadane żądania określają nieprawidłowy czas trwania w części invideoPromotion. |
badRequest (400) |
invalidDuration |
Metadane żądania określają nieprawidłowy typ pozycji, który ma służyć do określenia, jak promowany element ma być umieszczony w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, do którego wysłano żądanie. |
badRequest (400) |
invalidRecentlyUploadedBy |
Metadane żądania określają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, który wysłał żądanie. |
badRequest (400) |
invalidTimingOffset |
Metadane żądania określają nieprawidłowe przesunięcie czasu w części invideoPromotion. |
badRequest (400) |
invalidTimingOffset |
Metadane żądania określają nieprawidłowe przesunięcie czasowe, które służy do określania, kiedy promowany produkt powinien być wyświetlany w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, do którego wysłano żądanie. |
badRequest (400) |
invalidTimingType |
Metadane żądania określają nieprawidłową metodę określania czasu, w którym promowany produkt powinien być wyświetlany w odtwarzaczu wideo. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, który wysłał żądanie. |
badRequest (400) |
localizationValidationError |
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody channels.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu kanałów. |
badRequest (400) |
tooManyPromotedItems |
W sekcji invideoPromotion przekroczono dozwoloną liczbę promowanych produktów. |
forbidden (403) |
channelForbidden |
Kanał określony w parametrze id nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane. |
forbidden (403) |
promotedVideoNotAllowed |
Nie udało się znaleźć kanału, który próbuje zaktualizować żądanie do interfejsu API. Sprawdź wartość właściwości id w zasobie channel, który wysłało żądanie, aby upewnić się, że identyfikator kanału jest prawidłowy. |
forbidden (403) |
websiteLinkNotAllowed |
Podany adres URL witryny jest niedozwolony. |
notFound (404) |
channelNotFound |
Nie można znaleźć kanału określonego przez parametr id lub nie ma on opcji brandingu. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału określonego w parametrze id. |
notFound (404) |
unknownChannelId |
Nie znaleziono podanego identyfikatora kanału. |
notFound (404) |
unknownChannelId |
Nie znaleziono określonego identyfikatora kanału recentlyUploadedBy. |
notFound (404) |
unknownVideoId |
Nie znaleziono identyfikatora filmu określonego jako promowany produkt. |
required (400) |
requiredItemIdType |
Metadane żądania muszą określać typ produktu w części invideoPromotion. |
required (400) |
requiredItemId |
Metadane żądania muszą określać element w części invideoPromotion. |
required (400) |
requiredTimingOffset |
Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie wysyłanym przez żądanie. |
required (400) |
requiredTimingOffset |
Metadane żądania muszą określać przesunięcie czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysyła żądanie. |
required (400) |
requiredTimingType |
Metadane żądania muszą określać metodę czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie. |
required (400) |
requiredTimingType |
Metadane żądania muszą określać metodę czasu, aby YouTube mógł określić, kiedy wyświetlić promowany element. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie, który wysyła żądanie. |
required (400) |
requiredTiming |
Metadane żądania muszą określać czas dla każdego elementu w części invideoPromotion. |
required (400) |
requiredVideoId |
Metadane żądania muszą zawierać identyfikator filmu, aby można było zidentyfikować promowany produkt. |
required (400) |
requiredWebsiteUrl |
Metadane żądania muszą zawierać adres URL witryny w sekcji invideoPromotion. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie wysyłanym przez żądanie. |
commentThreads
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami commentThreads. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
commentThreads.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
operationNotSupported |
Żądanie do interfejsu API jest nieprawidłowe lub ma nieprawidłowy format. Dlatego serwer interfejsu API nie zrozumiał żądania. |
badRequest (400) |
processingFailure |
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa. |
forbidden (403) |
commentsDisabled |
Film określony przez parametr videoId ma wyłączone komentarze. |
forbidden (403) |
forbidden |
Nie udało się pobrać co najmniej 1 wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału określonego przez parametr allThreadsRelatedToChannelId. |
notFound (404) |
commentThreadNotFound |
Nie udało się znaleźć co najmniej 1 z podanych wątków komentarzy. Sprawdź wartości parametru id żądania, aby upewnić się, że są prawidłowe. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu określonego przez parametr videoId. |
commentThreads.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Każdy wątek komentarzy musi być połączony z kanałem lub filmem. Upewnij się, że zasób określa wartości właściwości snippet.channelId i snippet.videoId. Komentarz do filmu pojawia się na stronie odtwarzania filmu. |
badRequest (400) |
commentTextRequired |
Wstawiany zasób comment musi mieć określoną wartość właściwości snippet.topLevelComment.snippet.textOriginal. Komentarze nie mogą być puste. |
badRequest (400) |
commentTextTooLong |
Wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal. |
badRequest (400) |
invalidCommentThreadMetadata |
Metadane żądania są nieprawidłowe. |
badRequest (400) |
processingFailure |
Serwer interfejsu API nie mógł przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa. |
forbidden (403) |
forbidden |
Nie udało się utworzyć wątku komentarzy z powodu niewystarczających uprawnień. Żądanie może nie być prawidłowo autoryzowane. |
forbidden (403) |
ineligibleAccount |
Konto YouTube używane do autoryzacji żądania do interfejsu API musi być połączone z kontem Google użytkownika, aby można było wstawić komentarz lub wątek komentarzy. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć określonego kanału. Sprawdź, czy wartość właściwości snippet.channelId jest prawidłowa. |
notFound (404) |
videoNotFound |
Nie udało się znaleźć określonego filmu. Sprawdź, czy wartość właściwości snippet.videoId jest prawidłowa. |
członkowie
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
members.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania kanału. |
badRequest (400) |
invalidMode |
Wartość parametru mode jest nieprawidłowa.
Ten błąd może wystąpić, jeśli parametr pageToken określa token, który został pobrany w innym trybie niż określony. |
badRequest (400) |
invalidPageToken |
Wartość parametru pageToken jest nieprawidłowa. Ten błąd występuje, gdy token strony użyty w żądaniu wygasł. |
badRequest (400) |
invalidHasAccessToLevel |
Wartość parametru hasAccessToLevel jest nieprawidłowa. Nie ma poziomu o określonym identyfikatorze id. |
badRequest (400) |
invalidFilterByMemberChannelId |
Wartość parametru filterByMemberChannelId jest nieprawidłowa. Ten błąd występuje, jeśli wartość parametru filterByMemberChannelId określa więcej niż 100 kanałów. |
membershipsLevels
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami members. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
membershipsLevels.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania kanału. |
playlistItems
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami playlistItems. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
playlistItems.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma odpowiednich uprawnień do usunięcia określonego elementu playlisty. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć elementu playlisty określonego w parametrze id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości usuwania filmów z określonej playlisty. Nie możesz na przykład usunąć filmu z playlisty Przesłane filmy. |
playlistItems.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
duplicate |
videoAlreadyInPlaylist |
Film, który próbujesz dodać do playlisty, już się na niej znajduje. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
Playlista zawiera już maksymalną dozwoloną liczbę elementów. |
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma odpowiednich uprawnień do wstawienia określonego elementu playlisty. |
invalidValue (400) |
invalidContentDetails |
Właściwość contentDetails w żądaniu jest nieprawidłowa. Możliwą przyczyną jest to, że pole contentDetails.note ma więcej niż 280 znaków. |
invalidValue (400) |
invalidPlaylistItemPosition |
Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu. |
invalidValue (400) |
invalidResourceType |
Wartość type podana w identyfikatorze zasobu nie jest obsługiwana w przypadku tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video. |
invalidValue (400) |
manualSortRequired |
Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie korzysta z ręcznego sortowania. (np. elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw w ustawieniach playlisty zmienić opcję Kolejność na Ręcznie. Te ustawienia można zmienić w Menedżerze filmów na YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Film, który próbujesz dodać do playlisty, znajduje się już na innej playliście serialu. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości wstawiania filmów do określonej playlisty. Nie możesz na przykład wstawić filmu do playlisty Przesłane filmy. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty określonej w parametrze playlistId żądania. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź wartość właściwości videoId, aby upewnić się, że jest prawidłowa. |
required (400) |
channelIdRequired |
Żądanie nie zawiera wartości wymaganej właściwości channelId. |
required (400) |
playlistIdRequired |
W żądaniu nie podano wartości wymaganego atrybutu playlistId. |
required (400) |
resourceIdRequired |
Żądanie musi zawierać zasób, w którym obiekt snippet określa resourceId. |
playlistItems.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma odpowiednich uprawnień do pobrania określonej playlisty. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId w żądaniu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu określonego w parametrze videoId żądania. |
required (400) |
playlistIdRequired |
Żądanie subskrypcji nie zawiera wartości wymaganego atrybutu playlistId. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości wyświetlania listy filmów na określonej playliście. Nie możesz na przykład umieścić filmu na playliście Do obejrzenia. |
playlistItems.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma odpowiednich uprawnień do zaktualizowania określonego elementu playlisty. |
invalidValue (400) |
invalidPlaylistItemPosition |
Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu. |
invalidValue (400) |
invalidResourceType |
Wartość type podana w identyfikatorze zasobu nie jest obsługiwana w przypadku tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video. |
invalidValue (400) |
invalidSnippet |
Żądanie nie zawiera prawidłowej właściwości snippet. |
invalidValue (400) |
manualSortRequired |
Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie używa sortowania ręcznego. (Na przykład elementy playlisty mogą być posortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować opcję Kolejność playlisty na Ręczna w ustawieniach playlisty. Te ustawienia można zmienić w Menedżerze filmów na YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości aktualizowania filmów na określonej playliście. Nie możesz na przykład zaktualizować filmu na playlistach z przesłanymi filmami. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć elementu playlisty określonego we właściwości id żądania. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId w żądaniu. |
required (400) |
channelIdRequired |
W żądaniu nie podano wartości wymaganego atrybutu channelId. |
required (400) |
playlistIdRequired |
Żądanie nie zawiera wartości wymaganej właściwości playlistId. |
required (400) |
playlistItemIdRequired |
Zasób elementu playlisty określony w żądaniu musi używać właściwości id, aby zidentyfikować aktualizowany element playlisty. |
playlisty
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami playlists. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
playlists.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty określonej w parametrze id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości usunięcia określonej playlisty. Nie możesz na przykład usunąć playlisty Przesłane filmy. |
playlists.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
channelClosed |
Kanał określony w parametrze channelId został zamknięty. |
forbidden (403) |
channelSuspended |
Kanał określony w parametrze channelId został zawieszony. |
forbidden (403) |
playlistForbidden |
Playlista określona w parametrze id żądania nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane. |
notFound (404) |
channelNotFound |
Nie udało się znaleźć kanału określonego w parametrze channelId. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty określonej w parametrze id żądania. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości wyświetlania określonej playlisty. Nie możesz na przykład wyświetlić playlisty Do obejrzenia. |
playlists.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Wartość defaultLanguage musi być ustawiona na aktualizację localizations. |
badRequest (400) |
localizationValidationError |
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlists. |
badRequest (400) |
maxPlaylistExceeded |
Nie można utworzyć playlisty, ponieważ kanał ma już maksymalną dozwoloną liczbę playlist. |
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
invalidValue (400) |
invalidPlaylistSnippet |
Żądanie zawiera nieprawidłowy fragment playlisty. |
required (400) |
playlistTitleRequired |
Żądanie musi określać tytuł playlisty. |
playlists.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Wartość defaultLanguage musi być ustawiona na aktualizację localizations. |
badRequest (400) |
localizationValidationError |
Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości, i zaktualizuj je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlist. |
forbidden (403) |
playlistForbidden |
Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane. |
invalidValue (400) |
invalidPlaylistSnippet |
Żądanie zawiera nieprawidłowy fragment playlisty. |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje możliwości aktualizowania określonej playlisty. Nie możesz na przykład aktualizować właściwości playlisty z przesłanymi przez Ciebie filmami. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty określonej w parametrze id żądania. |
required (400) |
playlistTitleRequired |
Żądanie musi określać tytuł playlisty. |
szukaj
W tabelach poniżej 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 żądań.
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 jest 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ń. Jeśli ustawisz wartość parametru eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated lub videoType, musisz ustawić parametr type na video. |
subskrypcje
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami subscriptions. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
subscriptions.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
subscriptionForbidden |
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale. |
notFound (404) |
subscriptionNotFound |
Nie można znaleźć subskrypcji, którą próbujesz usunąć. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
subscriptions.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
subscriptionDuplicate |
Subskrypcja, którą próbujesz utworzyć, już istnieje. |
badRequest (400) |
subscriptionForbidden |
Osiągnięto maksymalną liczbę subskrypcji. |
badRequest (400) |
subscriptionForbidden |
W ostatnim czasie zasubskrybowałeś zbyt wiele kanałów. Spróbuj ponownie za kilka godzin. |
badRequest (400) |
subscriptionForbidden |
Subskrybowanie własnego kanału nie jest obsługiwane. |
forbidden (403) |
subscriptionForbidden |
Żądanie nie zostało prawidłowo uwierzytelnione lub nie jest obsługiwane w tym kanale. |
notFound (404) |
publisherNotFound |
Nie znaleziono zasobu określonego przez właściwość snippet.resourceId żądania. |
notFound (404) |
subscriberNotFound |
Nie można znaleźć subskrybenta zidentyfikowanego w żądaniu. |
required (400) |
publisherRequired |
Zasób subskrypcji określony w żądaniu musi używać właściwości snippet.resourceId do identyfikowania kanału, który jest subskrybowany. |
subscriptions.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
accountClosed |
Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zamknięte. |
forbidden (403) |
accountSuspended |
Nie udało się pobrać subskrypcji, ponieważ konto subskrybenta jest zawieszone. |
forbidden (403) |
subscriptionForbidden |
Osoba wysyłająca żądanie nie ma uprawnień dostępu do żądanych subskrypcji. |
notFound (404) |
subscriberNotFound |
Nie można znaleźć subskrybenta powiązanego z żądaniem. |
miniatury
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami thumbnails. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
thumbnails.set
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
invalidImage |
Podana treść obrazu jest nieprawidłowa. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści obrazu. |
forbidden (403) |
forbidden |
Nie można ustawić miniatury dla określonego filmu. Żądanie może nie być prawidłowo autoryzowane. |
forbidden (403) |
forbidden |
Uwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, do którego próbujesz wstawić obraz miniatury. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa. |
tooManyRequests (429) |
uploadRateLimitExceeded |
Na kanale przesłano ostatnio zbyt wiele miniatur. Spróbuj ponownie później. |
videoAbuseReportReasons
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami videoAbuseReportReasons. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videoAbuseReportReasons.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane. |
videoCategories
W tabelach poniżej znajdziesz komunikaty o błędach, które interfejs API zwraca w odpowiedzi na wywołania związane z zasobami videoCategories. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videoCategories.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
notFound (404) |
videoCategoryNotFound |
Nie można znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list. |
filmy
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami videos. Metody te mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
videos.insert
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Żądanie próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka szczegółów filmu. |
badRequest (400) |
invalidCategoryId |
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie. |
badRequest (400) |
invalidDescription |
Metadane żądania zawierają nieprawidłowy opis filmu. |
badRequest (400) |
invalidFilename |
Nazwa pliku wideo podana w nagłówku Slug jest nieprawidłowa. |
badRequest (400) |
invalidPublishAt |
Metadane żądania określają nieprawidłowy czas zaplanowanej publikacji. |
badRequest (400) |
invalidRecordingDetails |
Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania. |
badRequest (400) |
invalidTags |
Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu. |
badRequest (400) |
invalidTitle |
Metadane żądania określają nieprawidłowy lub pusty tytuł filmu. |
badRequest (400) |
invalidVideoGameRating |
Metadane żądania określają nieprawidłową ocenę gry wideo. |
badRequest (400) |
invalidVideoMetadata |
Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId. |
badRequest (400) |
mediaBodyRequired |
Prośba nie zawiera treści wideo. |
badRequest (400) |
uploadLimitExceeded |
Osiągnięto dzienny limit przesyłania filmów na kanał. Jest to ograniczenie platformy YouTube i jest całkowicie niezależne od limitu interfejsu API projektu w chmurze Google Cloud. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
Żądanie próbuje ustawić nieprawidłową licencję dla filmu. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności filmu. |
videos.list
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
videoChartNotFound |
Żądana lista przebojów wideo nie jest obsługiwana lub jest niedostępna. |
forbidden (403) |
forbidden |
Żądanie nie ma odpowiednich uprawnień dostępu do pliku wideo lub informacji o przetwarzaniu. Części fileDetails, processingDetails i suggestions są dostępne tylko dla właściciela filmu. |
forbidden (403) |
forbidden |
Prośba nie ma dostępu do informacji o ocenach użytkowników. Ten błąd może wystąpić, ponieważ żądanie nie jest prawidłowo autoryzowane do używania parametru myRating. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz odzyskać. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
videos.delete
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Nie można usunąć filmu, który próbujesz usunąć. Żądanie może nie być prawidłowo autoryzowane. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz usunąć. Sprawdź wartość parametru id w żądaniu, aby upewnić się, że jest prawidłowa. |
videos.update
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Żądanie do interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka szczegółów filmu. |
badRequest (400) |
invalidCategoryId |
Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji. |
badRequest (400) |
invalidDescription |
Metadane żądania określają nieprawidłowy opis filmu. |
badRequest (400) |
invalidPublishAt |
Metadane żądania określają nieprawidłowy czas zaplanowanej publikacji. |
badRequest (400) |
invalidRecordingDetails |
Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania. |
badRequest (400) |
invalidTags |
Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu. |
badRequest (400) |
invalidTitle |
Metadane żądania określają nieprawidłowy lub pusty tytuł filmu. |
badRequest (400) |
invalidVideoMetadata |
Metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId. |
forbidden (403) |
forbidden |
Dostęp zabroniony. Żądanie może nie być prawidłowo autoryzowane. |
forbidden (403) |
forbiddenEmbedSetting |
Żądanie próbuje ustawić nieprawidłowe ustawienie umieszczania filmu. Niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzaczy umieszczonych w przypadku transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube. |
forbidden (403) |
forbiddenLicenseSetting |
Żądanie próbuje ustawić nieprawidłową licencję dla filmu. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość pola id w treści żądania jest prawidłowa. |
videos.rate
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
emailNotVerified |
Przed wystawieniem oceny użytkownik musi zweryfikować swój adres e-mail. |
badRequest (400) |
invalidRating |
Żądanie zawierało nieoczekiwaną wartość parametru rating. |
badRequest (400) |
videoPurchaseRequired |
Filmy do wypożyczenia mogą oceniać tylko użytkownicy, którzy je wypożyczyli. |
forbidden (403) |
forbidden |
Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie być prawidłowo autoryzowane. |
forbidden (403) |
videoRatingDisabled |
Właściciel filmu, który próbujesz ocenić, wyłączył oceny dla tego filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
videos.reportAbuse
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
invalidAbuseReason |
Żądanie zawierało nieoczekiwaną wartość pola reason_id lub kombinację pól reason_id i secondary_reason_id. |
badRequest (400) |
rateLimitExceeded |
Użytkownik wysłał zbyt wiele żądań w danym okresie. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
Nie udało się znaleźć filmu, którego dotyczy zgłoszenie nadużycia. |
znaki wodne,
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami watermarks. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.
watermarks.set
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
badRequest (400) |
imageFormatUnsupported |
Przesłany obraz jest w nieobsługiwanym formacie. |
badRequest (400) |
imageTooTall |
Przesłany obraz jest za wysoki. |
badRequest (400) |
imageTooWide |
Przesłany obraz jest za szeroki. |
badRequest (400) |
mediaBodyRequired |
Żądanie nie zawiera treści obrazu. |
forbidden (403) |
forbidden |
Nie można ustawić znaku wodnego dla określonego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość. |
watermarks.unset
| Typ błędu | Szczegóły błędu | Opis |
|---|---|---|
forbidden (403) |
forbidden |
Nie można cofnąć ustawienia znaku wodnego dla wybranego kanału. Żądanie może nie być prawidłowo autoryzowane lub parametr channelId ma nieprawidłową wartość. |
komentarze
W tabelach poniżej znajdziesz komunikaty o błędach zwracane przez interfejs API w odpowiedzi na wywołania związane z zasobami
comments. Te metody mogą też zwracać błędy wymienione w sekcji Typowe błędy żądań.comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidiparentIdżądania są prawidłowe.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthormożna używać tylko wtedy, gdy wartość parametrumoderationStatustorejected.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidżądania są prawidłowe.comments.insertbadRequest (400)commentTextRequiredcommentmusi mieć określoną wartość właściwościsnippet.textOriginal. Komentarze nie mogą być puste.badRequest (400)commentTextTooLongcommentzawiera zbyt wiele znaków we właściwościsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentId. W zasobiecommentThreadwłaściwośćsnippet.canReplywskazuje, czy bieżący widz może odpowiedzieć na wątek.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentw treści żądania do interfejsu API nie określał wartości właściwościsnippet.parentId.badRequest (400)processingFailurecommentw treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdw treści żądania jest prawidłowa.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidżądania jest prawidłowa.comments.updatebadRequest (400)commentTextTooLongcommentzawiera zbyt wiele znaków we właściwościsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentw treści żądania, aby upewnić się, że jest prawidłowa.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidw treści żądania, aby upewnić się, że jest prawidłowa.