In diesem Dokument werden die verschiedenen Fehlertypen beschrieben, die YouTube Data API-Vorgänge zurückgeben können. Außerdem finden Sie in der Referenzdokumentation für diese Methode eine Liste mit Fehlern für jede einzelne Methode.
Allgemeine Fehler
In den folgenden Tabellen sind API-Fehlermeldungen aufgeführt, die sich nicht auf eine bestimmte API-Methode beziehen.
Core API errors
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
quotaExceeded (403) |
quotaExceeded |
Die Anfrage kann nicht abgeschlossen werden, weil Ihr Kontingent überschritten wurde. |
Common request errors
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
incompatibleParameters |
In der Anfrage sind zwei oder mehr Parameter angegeben, die nicht in derselben Anfrage verwendet werden können. |
badRequest (400) |
invalidFilters |
In der Anfrage ist ein ungültiger Filterparameter angegeben. |
badRequest (400) |
invalidPageToken |
In der Anfrage ist ein ungültiges Seitentoken angegeben. |
badRequest (400) |
missingRequiredParameter |
In der Anfrage fehlt ein erforderlicher Parameter. |
badRequest (400) |
unexpectedParameter |
In der Anfrage ist ein unerwarteter Parameter angegeben. |
forbidden (403) |
accountDelegationForbidden |
Der authentifizierte Nutzer kann nicht im Namen des angegebenen Google-Kontos handeln. |
forbidden (403) |
authenticatedUserAccountClosed |
Das YouTube-Konto des authentifizierten Nutzers ist geschlossen. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Konto. |
forbidden (403) |
authenticatedUserAccountSuspended |
Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Konto. |
forbidden (403) |
authenticatedUserNotChannel |
Für diese Anfrage muss der authentifizierte Nutzer einen Kanal auflösen. Dies ist jedoch nicht möglich. Wenn Ihre Anfrage authentifiziert ist und den Delegationsparameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen. |
forbidden (403) |
channelClosed |
Der in der Anfrage angegebene Kanal wurde geschlossen. |
forbidden (403) |
channelNotFound |
Der in der Anfrage angegebene Kanal wurde nicht gefunden. |
forbidden (403) |
channelSuspended |
Der in der Anfrage angegebene Kanal wurde gesperrt. |
forbidden (403) |
cmsUserAccountNotFound |
Der CMS-Nutzer ist nicht berechtigt, im Namen des angegebenen Rechteinhabers zu handeln. |
forbidden (403) |
insufficientCapabilities |
Die Berechtigungen des CMS-Nutzers sind unzureichend. |
forbidden (403) |
insufficientPermissions |
Das für die Anfrage bereitgestellte OAuth 2.0-Token gibt Bereiche an, die für den Zugriff auf die angeforderten Daten nicht ausreichen. |
notFound (404) |
contentOwnerAccountNotFound |
Das angegebene Rechteinhaber-Konto wurde nicht gefunden. |
Request context errors
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidLanguage |
Der Parameterwert hl enthält keinen gültigen Sprachcode. |
badRequest (400) |
invalidMine |
Die Verwendung des Parameters mine wird in der Anfrage nicht unterstützt. |
badRequest (400) |
invalidMine |
Der Parameter mine kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Du solltest entweder den Parameter mine entfernen, dich als YouTube-Nutzer authentifizieren, indem du den Parameter onBehalfOfContentOwner entfernst, oder als einer der Partnerkanäle fungieren, indem du den Parameter onBehalfOfContentOwnerChannel angibst, sofern für die aufgerufene Methode verfügbar. |
badRequest (400) |
invalidPart |
Der part -Parameter der Anfrage gibt einige Teile an, die nicht gleichzeitig geschrieben werden können. |
badRequest (400) |
invalidRegionCode |
Der Parameter regionCode gibt einen ungültigen Regionscode an. |
badRequest (400) |
unexpectedPart |
Der Parameter part der Anfrage gibt einen unerwarteten Wert an. |
badRequest (400) |
unknownPart |
Der Parameter part der Anfrage gibt einen unbekannten Wert an. |
badRequest (400) |
unsupportedLanguageCode |
Der Parameterwert hl gibt keinen unterstützten Sprachcode an. |
badRequest (400) |
unsupportedRegionCode |
Der Parameter regionCode gibt einen nicht unterstützten Regionscode an. |
unauthorized (401) |
authorizationRequired |
Die Anfrage verwendet den Parameter mine , ist aber nicht ordnungsgemäß autorisiert. |
unauthorized (401) |
youtubeSignupRequired |
Dieser Fehler weist darauf hin, dass der Nutzer die Verknüpfung eines Google-Kontos aufgehoben hat. Er hat also ein Google-Konto, aber keinen YouTube-Kanal. Derartige Nutzer haben Zugriff auf viele Funktionen, die von der Autorisierung eines Nutzers abhängig sind, z. B. das Bewerten von Videos oder das Hinzufügen von Videos zu einer watch_later -Playlist. Ein Nutzer benötigt jedoch beispielsweise einen YouTube-Kanal, um ein Video hochladen zu können. Ein Nutzer mit einem Gmail- oder Android-Gerät hat sicherlich ein Google-Konto, hat dieses aber möglicherweise noch nicht mit einem YouTube-Kanal verknüpft.Dieser Fehler tritt häufig auf, wenn du versuchst, den OAuth 2.0-Vorgang für ein Dienstkonto zu nutzen. YouTube unterstützt keine Dienstkonten. Wenn du versuchst, dich über ein Dienstkonto zu authentifizieren, wird diese Fehlermeldung angezeigt. Im YouTube API-Blogpost, in dem die Unterstützung für Google-Konten vorgestellt wird, wird auch der Fehler youtubeSignupRequired ausführlicher erörtert. Obwohl der Blogpost den Fehler für die API-Version 2.1 erläutert, ist die Bedeutung des Fehlers weiterhin zutreffend. |
Aktivitäten
activities.insert
wird nicht mehr unterstützt.
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von activities
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
activities.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
Die Daten zur Homepage-Aktivität des Nutzers sind über diese API nicht verfügbar. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true setzen. |
forbidden (403) |
forbidden |
Die Anfrage ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
channelNotFound |
Die vom Parameter channelId der Anfrage angegebene Kanal-ID wurde nicht gefunden. |
notFound (404) |
homeChannelNotFound |
Für den aktuell authentifizierten Nutzer wurde kein YouTube-Startseitenfeed gefunden. |
unauthorized (401) |
authorizationRequired |
Die Anfrage verwendet den Parameter home , ist aber nicht ordnungsgemäß autorisiert. |
captions
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von captions
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
captions.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Die mit der Anfrage verknüpften Berechtigungen reichen zum Löschen des Untertitel-Tracks nicht aus. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
captionNotFound |
Der Untertiteltrack wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
captions.download
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Die mit der Anfrage verknüpften Berechtigungen reichen zum Herunterladen des Untertitel-Tracks nicht aus. Möglicherweise ist die Anfrage nicht ordnungsgemäß autorisiert oder der Videoauftrag hat keine Untertitelbeiträge von Dritten aktiviert. |
invalidValue (400) |
couldNotConvert |
Die Untertiteldaten konnten nicht in die angeforderte Sprache und/oder das gewünschte Format konvertiert werden. Achte darauf, dass die angeforderten Werte für tfmt und tlang gültig sind und der Wert für snippet.status des angeforderten Untertiteltracks nicht failed ist. |
notFound (404) |
captionNotFound |
Der Untertiteltrack wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
captions.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
contentRequired |
Die Anfrage enthält keine Untertitelinhalte. |
conflict (409) |
captionExists |
Das angegebene Video hat bereits einen Untertiteltrack mit den angegebenen snippet.language und snippet.name . Ein Video kann mehrere Titel für dieselbe Sprache haben, aber jeder Titel muss einen anderen Namen haben.Es gibt mehrere Möglichkeiten, den Fehler zu beheben. Sie können den vorhandenen Track löschen und dann einen neuen einfügen oder den Namen des neuen Tracks ändern, bevor Sie ihn einfügen. |
forbidden (403) |
forbidden |
Die mit der Anfrage verknüpften Berechtigungen reichen zum Hochladen des Untertitel-Tracks nicht aus. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
invalidValue (400) |
invalidMetadata |
Die Anfrage enthält ungültige Metadatenwerte, die verhindern, dass der Titel erstellt wird. Prüfen Sie, ob in der Anfrage gültige Werte für die Attribute snippet.language , snippet.name und snippet.videoId angegeben sind. Die Property snippet.isDraft kann ebenfalls enthalten sein, ist aber nicht erforderlich. |
notFound (404) |
videoNotFound |
Das durch den Parameter videoId identifizierte Video wurde nicht gefunden. |
captions.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Mindestens ein Untertitel-Track konnte nicht abgerufen werden, da die mit der Anfrage verknüpften Berechtigungen zum Abrufen der angeforderten Ressourcen nicht ausreichen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
captionNotFound |
Mindestens einer der angegebenen Untertitel-Tracks wurde nicht gefunden. Dieser Fehler tritt auf, wenn der Parameter videoId ein tatsächliches Video identifiziert, der Parameter id jedoch entweder die IDs von Untertitel-Tracks, die nicht vorhanden sind, oder Tracking-IDs, die mit anderen Videos verknüpft sind. Prüfen Sie, ob die Werte der Parameter id und videoId der Anfrage korrekt sind. |
notFound (404) |
videoNotFound |
Das durch den Parameter videoId identifizierte Video wurde nicht gefunden. |
captions.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
contentRequired |
Durch die Anfrage wurde keine aktualisierte Untertiteldatei hochgeladen. Der tatsächliche Titelinhalt ist erforderlich, wenn der Parameter sync auf true festgelegt ist. |
forbidden (403) |
forbidden |
Die mit der Anfrage verknüpften Berechtigungen reichen zur Aktualisierung des Untertitel-Tracks nicht aus. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
captionNotFound |
Der angegebene Untertiteltrack wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
Kanalbanner
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von channelBanners
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
channelBanners.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
bannerAlbumFull |
Dein Album für YouTube-Kanalbilder enthält zu viele Bilder. Rufen Sie http://photos.google.com auf, rufen Sie die Seite des Albums auf und entfernen Sie einige Bilder aus den Alben. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält nicht den Bildinhalt. |
Kanalabschnitte
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von channelSections
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
channelSections.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
notEditable |
Dieser Kanalabschnitt kann nicht gelöscht werden. |
forbidden (403) |
channelSectionForbidden |
Die Anfrage ist für diesen Kanal nicht richtig authentifiziert oder wird nicht unterstützt. |
invalidValue (400) |
idInvalid |
Die Property id gibt eine ungültige Kanalabschnitts-ID an. |
invalidValue (400) |
idRequired |
In der Property id muss ein Wert angegeben werden, der den zu löschenden Kanalabschnitt kennzeichnet. |
notFound (404) |
channelNotFound |
Der Kanal wurde nicht gefunden. |
notFound (404) |
channelSectionNotFound |
Der Kanalabschnitt, den du aktualisieren möchtest, wurde nicht gefunden. |
channelSections.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Das Attribut snippet.defaultLanguage der Ressource channelSection muss so eingestellt sein, dass das Objekt localizations für diese Ressource erfolgreich eingefügt oder aktualisiert wird. |
badRequest (400) |
invalidLanguage |
Einer der Sprachschlüssel des localizations -Objekts konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
notEditable |
Dieser Kanalabschnitt kann nicht erstellt werden. |
badRequest (400) |
styleRequired |
Die Ressource channelSection muss einen Wert für das Feld snippet.style angeben. |
badRequest (400) |
targetInvalidCountry |
Einer der Werte in der targeting.countries -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
targetInvalidLanguage |
Einer der Werte in der targeting.languages -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
targetInvalidRegion |
Einer der Werte in der targeting.regions -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
typeRequired |
Die Ressource channelSection muss einen Wert für das Feld snippet.type angeben. |
forbidden (403) |
channelSectionForbidden |
Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt. |
invalidValue (400) |
channelNotActive |
Mindestens einer der angegebenen Channels ist nicht aktiv. |
invalidValue (400) |
channelsDuplicated |
Die Anfrage ist fehlgeschlagen, weil doppelte Kanäle angegeben wurden. |
invalidValue (400) |
channelsNeeded |
Wenn die snippet.type -Property den Wert multipleChannels hat, muss die contentDetails.channels[] -Property angegeben und mindestens ein Kanal angegeben werden. |
invalidValue (400) |
channelsNotExpected |
Die Ressource, die in der Anfrage angegeben ist, hat einen Wert für die Property contentDetails.channels[] angegeben. Für diesen Kanalabschnitt werden jedoch keine Kanäle erwartet. |
invalidValue (400) |
contentDetailsNeeded |
Die Ressource, die du einfügst, muss für diesen Kanalabschnitt ein contentDetails -Objekt enthalten. |
invalidValue (400) |
inValidPosition |
Die Eigenschaft snippet.position enthält einen ungültigen Wert. |
invalidValue (400) |
maxChannelSectionExceeded |
Die Anfrage kann nicht abgeschlossen werden, da der Kanal bereits die maximale Anzahl an Kanalabschnitten enthält. |
invalidValue (400) |
maxChannelsExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
maxPlaylistExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
onePlaylistNeeded |
Wenn die snippet.type -Property den Wert singlePlaylist hat, muss die contentDetails.playlists[] -Property genau eine Playlist angeben. |
invalidValue (400) |
ownChannelInChannels |
Du kannst deinen eigenen Kanal nicht in einen Kanalabschnitt aufnehmen, der auf diesem Kanal erscheint. |
invalidValue (400) |
playlistIsPrivate |
Mindestens eine der angegebenen Playlists ist privat und kann daher nicht im Kanalabschnitt enthalten werden. |
invalidValue (400) |
playlistsDuplicated |
Die Anfrage ist fehlgeschlagen, weil doppelte Playlists angegeben wurden. |
invalidValue (400) |
playlistsNeeded |
Wenn die Eigenschaft snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss die Eigenschaft contentDetails.playlists[] angegeben werden. |
invalidValue (400) |
playlistsNotExpected |
Die Ressource, die in der Anfrage angegeben ist, hat einen Wert für die contentDetails.playlists[] -Property angegeben. Für diesen Kanalabschnitt werden jedoch keine Playlists erwartet. |
invalidValue (400) |
snippetNeeded |
Du musst einen snippet angeben, um den Kanalabschnitt zu erstellen. |
invalidValue (400) |
titleLengthExceeded |
Der Wert der snippet.title -Property ist zu lang. |
invalidValue (400) |
titleRequired |
Wenn die snippet.type -Property den Wert multiplePlaylists oder multipleChannels hat, musst du den Titel des Abschnitts festlegen. Dazu gibst du einen Wert für die Property snippet.title an. |
notFound (404) |
channelNotFound |
Mindestens einer der angegebenen Channels wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Mindestens eine der angegebenen Playlists wurde nicht gefunden. |
channelSections.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
channelSectionForbidden |
Der Antragsteller hat keinen Zugriff auf die angeforderten Kanalabschnitte. |
invalidValue (400) |
idInvalid |
In der Anfrage ist eine ungültige Kanalabschnitts-ID angegeben. |
invalidValue (400) |
invalidCriteria |
Die Anfrage konnte nicht abgeschlossen werden, da die Filterkriterien ungültig sind. |
notFound (404) |
channelNotFound |
Der mit der Anfrage verknüpfte Kanal wurde nicht gefunden. |
notFound (404) |
channelSectionNotFound |
Der mit der Anfrage verknüpfte Kanalabschnitt wurde nicht gefunden. |
channelSections.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Das Attribut snippet.defaultLanguage der Ressource channelSection muss so eingestellt sein, dass das Objekt localizations für diese Ressource erfolgreich eingefügt oder aktualisiert wird. |
badRequest (400) |
invalidLanguage |
Einer der Sprachschlüssel des localizations -Objekts konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
notEditable |
Dieser Kanalabschnitt kann nicht bearbeitet werden. |
badRequest (400) |
styleRequired |
Die Ressource channelSection muss einen Wert für das Feld snippet.style angeben. |
badRequest (400) |
targetInvalidCountry |
Einer der Werte in der targeting.countries -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
targetInvalidLanguage |
Einer der Werte in der targeting.languages -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
targetInvalidRegion |
Einer der Werte in der targeting.regions -Liste ist fehlgeschlagen. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
typeRequired |
Die Ressource channelSection muss einen Wert für das Feld snippet.type angeben. |
forbidden (403) |
channelSectionForbidden |
Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt. |
invalidValue (400) |
channelNotActive |
Mindestens einer der angegebenen Channels ist nicht aktiv. |
invalidValue (400) |
channelsDuplicated |
Die Anfrage ist fehlgeschlagen, weil doppelte Kanäle angegeben wurden. |
invalidValue (400) |
channelsNeeded |
Wenn die snippet.type -Property den Wert multipleChannels hat, muss die contentDetails.channels[] -Property angegeben und mindestens ein Kanal angegeben werden. |
invalidValue (400) |
channelsNotExpected |
Die Ressource, die in der Anfrage angegeben ist, hat einen Wert für die Property contentDetails.channels[] angegeben. Für diesen Kanalabschnitt werden jedoch keine Kanäle erwartet. |
invalidValue (400) |
contentDetailsNeeded |
Die Ressource, die Sie aktualisieren, muss ein contentDetails -Objekt für diesen Kanalabschnitt enthalten. |
invalidValue (400) |
idInvalid |
Die Property id gibt eine ungültige Kanalabschnitts-ID an. |
invalidValue (400) |
idRequired |
Die Eigenschaft id muss einen Wert angeben, der den zu aktualisierenden Kanalabschnitt identifiziert. |
invalidValue (400) |
inValidPosition |
Die Eigenschaft snippet.position enthält einen ungültigen Wert. |
invalidValue (400) |
maxChannelsExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
maxPlaylistExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
onePlaylistNeeded |
Wenn die snippet.type -Property den Wert singlePlaylist hat, muss die contentDetails.playlists[] -Property genau eine Playlist angeben. |
invalidValue (400) |
ownChannelInChannels |
Du kannst deinen eigenen Kanal nicht in einen Kanalabschnitt aufnehmen, der auf diesem Kanal erscheint. |
invalidValue (400) |
playlistIsPrivate |
Mindestens eine der angegebenen Playlists ist privat und kann daher nicht im Kanalabschnitt enthalten werden. |
invalidValue (400) |
playlistsDuplicated |
Die Anfrage ist fehlgeschlagen, weil doppelte Playlists angegeben wurden. |
invalidValue (400) |
playlistsNeeded |
Wenn die Eigenschaft snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss die Eigenschaft contentDetails.playlists[] angegeben werden. |
invalidValue (400) |
playlistsNotExpected |
Die Ressource, die in der Anfrage angegeben ist, hat einen Wert für die contentDetails.playlists[] -Property angegeben. Für diesen Kanalabschnitt werden jedoch keine Playlists erwartet. |
invalidValue (400) |
snippetNeeded |
Du musst einen snippet angeben, um den Kanalabschnitt zu aktualisieren. |
invalidValue (400) |
titleLengthExceeded |
Der Wert der snippet.title -Property ist zu lang. |
invalidValue (400) |
titleRequired |
Wenn die snippet.type -Property den Wert multiplePlaylists oder multipleChannels hat, musst du den Titel des Abschnitts festlegen. Dazu gibst du einen Wert für die Property snippet.title an. |
notFound (404) |
channelNotFound |
Mindestens einer der angegebenen Channels wurde nicht gefunden. |
notFound (404) |
channelSectionNotFound |
Der Kanalabschnitt, den du aktualisieren möchtest, wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Mindestens eine der angegebenen Playlists wurde nicht gefunden. |
Kanäle
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von channels
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
channels.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidCriteria |
Es kann maximal einer der folgenden Filter angegeben werden:id , mySubscribers , categoryId , mine , managedByMe , forUsername . Bei der Authentifizierung des Rechteinhabers über den Parameter onBehalfOfContentOwner darf nur id oder managedByMe angegeben werden. |
forbidden (403) |
channelForbidden |
Der im Parameter id angegebene Kanal unterstützt die Anfrage nicht oder sie ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
categoryNotFound |
Die durch den Parameter categoryId identifizierte Kategorie wurde nicht gefunden. Mit der Methode guideCategories.list rufen Sie eine Liste gültiger Werte ab. |
notFound (404) |
channelNotFound |
Der im Parameter id angegebene Kanal wurde nicht gefunden. |
channels.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
brandingValidationError |
Einer der Werte im brandingSettings -Objekt ist fehlgeschlagen. Verwenden Sie die Methode channels.list , um die vorhandenen Einstellungen für den Kanal abzurufen und die Attributwerte gemäß den Richtlinien in der Ressourcendokumentation für channels zu aktualisieren. |
badRequest (400) |
channelTitleUpdateForbidden |
Wenn du die brandingSettings part eines Kanals aktualisierst, musst du den Wert der brandingSettings.channel.title -Property auf den aktuellen Titel des Kanals festlegen oder die Property weglassen. Die API gibt einen Fehler zurück, wenn Sie den Wert der Eigenschaft ändern. |
badRequest (400) |
defaultLanguageNotSetError |
Die defaultLanguage muss so festgelegt werden, dass localizations aktualisiert wird. |
badRequest (400) |
invalidBrandingOption |
Eine der von Ihnen angegebenen Branding-Einstellungen ist nicht vorhanden. Verwenden Sie die Methode channels.list , um gültige Werte abzurufen und sie gemäß den Richtlinien in der channels -Ressourcendokumentation zu aktualisieren. |
badRequest (400) |
invalidCustomMessage |
Die Metadaten der Anfrage geben eine ungültige benutzerdefinierte Nachricht an. Prüfen Sie den Wert des Attributs invideoPromotion.items[].customMessage in der Ressource, die die Anfrage gesendet hat. |
badRequest (400) |
invalidDuration |
Die Anforderungsmetadaten geben im Abschnitt invideoPromotion eine ungültige Dauer an. |
badRequest (400) |
invalidDuration |
In den Metadaten der Anfrage ist ein ungültiger Positionstyp für die Positionierung des beworbenen Elements im Videoplayer angegeben. Prüfen Sie den Wert des Attributs invideoPromotion.position.type in der Ressource, die die Anfrage gesendet hat. |
badRequest (400) |
invalidRecentlyUploadedBy |
Die Metadaten der Anfrage enthalten eine ungültige Kanal-ID. Prüfen Sie den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, die die Anfrage gesendet hat. |
badRequest (400) |
invalidTimingOffset |
Die Anforderungsmetadaten geben im Abschnitt invideoPromotion einen ungültigen Zeitversatz an. |
badRequest (400) |
invalidTimingOffset |
Die Anforderungsmetadaten geben einen ungültigen Zeitversatz an, um zu bestimmen, wann das hochgestufte Element im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, die die Anfrage gesendet hat. |
badRequest (400) |
invalidTimingType |
Die Anforderungsmetadaten geben eine ungültige Timing-Methode an, mit der bestimmt wird, wann das hochgestufte Element im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource, die die Anfrage gesendet hat. |
badRequest (400) |
localizationValidationError |
Einer der Werte im Lokalisierungsobjekt ist fehlgeschlagen. Verwenden Sie die Methode channels.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Ressourcendokumentation für Kanäle zu aktualisieren. |
badRequest (400) |
tooManyPromotedItems |
Die Anzahl der zulässigen in der Werbeaktion angegebenen Artikel wurde überschritten. |
forbidden (403) |
channelForbidden |
Der im Parameter id angegebene Kanal unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
forbidden (403) |
promotedVideoNotAllowed |
Der Kanal, den die API-Anfrage zu aktualisieren versucht, wird nicht gefunden. Prüfe den Wert der id -Property in der Ressource channel , die von der Anfrage gesendet wurde, um sicherzustellen, dass die Kanal-ID korrekt ist. |
forbidden (403) |
websiteLinkNotAllowed |
Die angegebene Website-URL ist nicht zulässig. |
notFound (404) |
channelNotFound |
Der durch den Parameter id angegebene Kanal kann nicht gefunden werden oder verfügt über keine Branding-Optionen. |
notFound (404) |
channelNotFound |
Der im Parameter id angegebene Kanal wurde nicht gefunden. |
notFound (404) |
unknownChannelId |
Die angegebene Kanal-ID wurde nicht gefunden. |
notFound (404) |
unknownChannelId |
Die angegebene kürzlich hochgeladene Channel-ID wurde nicht gefunden. |
notFound (404) |
unknownVideoId |
Die als gesponserte Datei angegebene Video-ID kann nicht gefunden werden. |
required (400) |
requiredItemIdType |
In den Metadaten der Anfrage muss im Teil „invideoPromotion“ ein Elementtyp angegeben werden. |
required (400) |
requiredItemId |
In den Metadaten der Anfrage muss eine Artikel-ID für die invideoPromotion angegeben werden. |
required (400) |
requiredTimingOffset |
Die Metadaten der Anfrage müssen einen standardmäßigen Zeitversatz angeben, damit YouTube ermitteln kann, wann das beworbene Element angezeigt wird. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.offsetMs in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTimingOffset |
Die Metadaten der Anfrage müssen einen Zeitversatz angeben, damit YouTube ermitteln kann, wann das beworbene Element angezeigt wird. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTimingType |
In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element angezeigt wird. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTimingType |
In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element angezeigt wird. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTiming |
Die Metadaten der Anfrage müssen für jedes Element im Abschnitt invideoPromotion einen Zeitpunkt angeben. |
required (400) |
requiredVideoId |
In den Metadaten der Anfrage muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren. |
required (400) |
requiredWebsiteUrl |
In den Metadaten der Anfrage muss im Bereich „invideoPromotion“ eine Website-URL angegeben werden. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die von der Anfrage gesendet wird. |
Kommentarthreads
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von commentThreads
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
commentThreads.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
operationNotSupported |
Der ID-Filter ist nur mit Kommentaren kompatibel, die auf Google+ basieren. |
badRequest (400) |
processingFailure |
Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch normalerweise darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der commentThread -Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist. |
forbidden (403) |
commentsDisabled |
Für das durch den Parameter videoId identifizierte Video wurden Kommentare deaktiviert. |
forbidden (403) |
forbidden |
Mindestens einer der angeforderten Kommentarthreads kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
channelNotFound |
Der durch den Parameter channelId oder allThreadsRelatedToChannelId identifizierte Kanal wurde nicht gefunden. |
notFound (404) |
commentThreadNotFound |
Mindestens einer der angegebenen Kommentarthreads wurde nicht gefunden. Prüfen Sie, ob die Werte des id -Parameters der Anfrage korrekt sind. |
notFound (404) |
videoNotFound |
Das durch den Parameter videoId identifizierte Video wurde nicht gefunden. |
commentThreads.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Jeder Kommentarthread muss mit einem Kanal oder Video verknüpft sein.
|
badRequest (400) |
commentTextRequired |
Die Ressource comment , die eingefügt wird, muss einen Wert für das Attribut snippet.topLevelComment.snippet.textOriginal angeben. Kommentare dürfen nicht leer sein. |
badRequest (400) |
commentTextTooLong |
Die eingefügte comment -Ressource enthält zu viele Zeichen für das Attribut snippet.topLevelComment.snippet.textOriginal . |
badRequest (400) |
invalidCommentThreadMetadata |
Die Metadaten der Anfrage sind ungültig. |
badRequest (400) |
processingFailure |
Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch normalerweise darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der commentThread -Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist. |
forbidden (403) |
forbidden |
Der Kommentarthread konnte aufgrund unzureichender Berechtigungen nicht erstellt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
forbidden (403) |
ineligibleAccount |
Das YouTube-Konto, mit dem die API-Anfrage autorisiert wird, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einzufügen. |
notFound (404) |
channelNotFound |
Der angegebene Kanal wurde nicht gefunden. Prüfe, ob der Wert der Property snippet.channelId korrekt ist. |
notFound (404) |
videoNotFound |
Das angegebene Video wurde nicht gefunden. Prüfe, ob der Wert der Property snippet.videoId korrekt ist. |
Mitglieder
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von members
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
members.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert. |
badRequest (400) |
invalidMode |
Der Parameterwert für mode ist ungültig.
Dieser Fehler kann auftreten, wenn ein pageToken -Parameter ein Token angibt, das mit einem anderen als dem angegebenen Modus abgerufen wurde. |
badRequest (400) |
invalidPageToken |
Der Parameterwert pageToken ist ungültig. Dieser Fehler tritt auf, wenn das in der Anfrage verwendete Seitentoken abgelaufen ist. |
badRequest (400) |
invalidHasAccessToLevel |
Der Parameterwert hasAccessToLevel ist ungültig. Es gibt keine Ebene mit dem angegebenen id . |
badRequest (400) |
invalidFilterByMemberChannelId |
Der Parameterwert filterByMemberChannelId ist ungültig. Dieser Fehler tritt auf, wenn der Parameterwert filterByMemberChannelId mehr als 100 Kanäle angibt. |
Mitgliedschaftsstufen
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von members
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
membershipsLevels.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert. |
PlaylistItems
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von playlistItems
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
playlistItems.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen. |
notFound (404) |
playlistItemNotFound |
Das Playlist-Element, das durch den Parameter id der Anfrage identifiziert wird, wurde nicht gefunden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Löschen von Videos aus der angegebenen Playlist nicht. Du kannst beispielsweise kein Video aus deiner Playlist mit hochgeladenen Videos löschen. |
playlistItems.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
duplicate |
videoAlreadyInPlaylist |
Das Video, das du der Playlist hinzufügen möchtest, befindet sich bereits in der Playlist. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
Die Playlist enthält bereits die maximal zulässige Anzahl von Elementen. |
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element einzufügen. |
invalidValue (400) |
invalidContentDetails |
Die Property contentDetails in der Anfrage ist ungültig. Möglicherweise ist das Feld contentDetails.note länger als 280 Zeichen. |
invalidValue (400) |
invalidPlaylistItemPosition |
Bei der Anfrage wird versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position in der snippet der Ressource. |
invalidValue (400) |
invalidResourceType |
Die für die Ressourcen-ID angegebene type wird für diesen Vorgang nicht unterstützt. Die Ressourcen-ID gibt das Element an, das der Playlist hinzugefügt wird, z.B. youtube#video . |
invalidValue (400) |
manualSortRequired |
In der Anfrage wird versucht, die Position des Playlist-Elements festzulegen. In der Playlist wird jedoch keine manuelle Sortierung verwendet. Playlist-Elemente können zum Beispiel nach Datum oder Beliebtheit sortiert sein. Sie können den Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die in der Anfrage eingefügt wird. Wenn du möchtest, dass der Playlist-Eintrag eine bestimmte Position in der Liste hat, musst du die Playlist-Option Playlist in den Playlist-Einstellungen zuerst zu Manuell ändern. Diese Einstellungen können im YouTube-Video-Manager angepasst werden. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Das Video, das du der Playlist hinzufügen möchtest, ist bereits in einer anderen Serien-Playlist enthalten. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Einfügen von Videos in die angegebene Playlist nicht. Du kannst beispielsweise kein Video in deine Playlist mit hochgeladenen Videos einfügen. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
notFound (404) |
videoNotFound |
Das Video, das du der Playlist hinzufügen möchtest, wurde nicht gefunden. Prüfe, ob der Wert der Property videoId korrekt ist. |
required (400) |
channelIdRequired |
In der Anfrage ist kein Wert für die erforderliche channelId -Property angegeben. |
required (400) |
playlistIdRequired |
In der Anfrage ist kein Wert für die erforderliche playlistId -Property angegeben. |
required (400) |
resourceIdRequired |
Die Anfrage muss eine Ressource enthalten, in der das Objekt snippet eine resourceId angibt. |
playlistItems.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, die angegebene Playlist abzurufen. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
notFound (404) |
videoNotFound |
Das mit dem Parameter videoId der Anfrage identifizierte Video wurde nicht gefunden. |
required (400) |
playlistIdRequired |
In der Aboanfrage ist kein Wert für die erforderliche playlistId -Property angegeben. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt nicht die Möglichkeit, Videos in der angegebenen Playlist aufzulisten. In der Playlist „Später ansehen“ kannst du beispielsweise kein Video auflisten. |
playlistItems.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu aktualisieren. |
invalidValue (400) |
invalidPlaylistItemPosition |
Bei der Anfrage wird versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position in der snippet der Ressource. |
invalidValue (400) |
invalidResourceType |
Die für die Ressourcen-ID angegebene type wird für diesen Vorgang nicht unterstützt. Die Ressourcen-ID gibt das Element an, das der Playlist hinzugefügt wird, z.B. youtube#video . |
invalidValue (400) |
invalidSnippet |
In der Anfrage ist keine gültige snippet -Property angegeben. |
invalidValue (400) |
manualSortRequired |
In der Anfrage wird versucht, die Position des Playlist-Elements festzulegen. In der Playlist wird jedoch keine manuelle Sortierung verwendet. Playlist-Elemente können zum Beispiel nach Datum oder Beliebtheit sortiert sein. Sie können den Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die in der Anfrage eingefügt wird. Wenn du möchtest, dass der Playlist-Eintrag eine bestimmte Position in der Liste hat, musst du die Playlist-Option Playlist in den Playlist-Einstellungen zuerst zu Manuell ändern. Diese Einstellungen können im YouTube-Video-Manager angepasst werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt nicht die Aktualisierung von Videos in der angegebenen Playlist. Du kannst zum Beispiel ein Video in deiner Playlist mit hochgeladenen Videos nicht aktualisieren. |
notFound (404) |
playlistItemNotFound |
Das Playlist-Element, das mit der Eigenschaft id der Anfrage identifiziert wurde, wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
required (400) |
channelIdRequired |
In der Anfrage ist kein Wert für die erforderliche channelId -Property angegeben. |
required (400) |
playlistIdRequired |
In der Anfrage ist kein Wert für die erforderliche playlistId -Property angegeben. |
required (400) |
playlistItemIdRequired |
Die in der Anfrage angegebene Playlist-Elementressource muss das Attribut id verwenden, um das Playlist-Element zu identifizieren, das aktualisiert wird. |
Playlists
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von playlists
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
playlists.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistForbidden |
Dieser Vorgang ist verboten oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Löschen der angegebenen Playlist nicht. Du kannst zum Beispiel deine Playlist mit hochgeladenen Videos nicht löschen. |
playlists.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
channelClosed |
Der im Parameter channelId angegebene Kanal wurde geschlossen. |
forbidden (403) |
channelSuspended |
Der im Parameter channelId angegebene Kanal wurde gesperrt. |
forbidden (403) |
playlistForbidden |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wird, unterstützt die Anfrage nicht oder sie ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
channelNotFound |
Der im Parameter channelId angegebene Kanal wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Auflisten der angegebenen Playlist nicht. Du kannst die Playlist „Später ansehen“ beispielsweise nicht auflisten. |
playlists.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Die defaultLanguage muss so festgelegt werden, dass localizations aktualisiert wird. |
badRequest (400) |
localizationValidationError |
Einer der Werte im Lokalisierungsobjekt ist fehlgeschlagen. Verwende die Methode playlists.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zu Ressourcen für Playlists zu aktualisieren. |
badRequest (400) |
maxPlaylistExceeded |
Die Playlist kann nicht erstellt werden, weil der Kanal bereits die maximal zulässige Anzahl an Playlists enthält. |
forbidden (403) |
playlistForbidden |
Dieser Vorgang ist verboten oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
invalidValue (400) |
invalidPlaylistSnippet |
Die Anfrage enthält ein ungültiges Playlist-Snippet. |
required (400) |
playlistTitleRequired |
In der Anfrage muss ein Titel für die Playlist angegeben werden. |
playlists.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Die defaultLanguage muss so festgelegt werden, dass localizations aktualisiert wird. |
badRequest (400) |
localizationValidationError |
Einer der Werte im Lokalisierungsobjekt ist fehlgeschlagen. Verwende die Methode playlists.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zu Ressourcen für Playlists zu aktualisieren. |
forbidden (403) |
playlistForbidden |
Dieser Vorgang ist verboten oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
invalidValue (400) |
invalidPlaylistSnippet |
Die Anfrage enthält ein ungültiges Playlist-Snippet. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt die Aktualisierung der angegebenen Playlist nicht. Beispielsweise kannst du die Eigenschaften deiner Playlist mit hochgeladenen Videos nicht aktualisieren. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
required (400) |
playlistTitleRequired |
In der Anfrage muss ein Titel für die Playlist angegeben werden. |
search
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von search
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
search.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidChannelId |
Der Parameter channelId hat eine ungültige Kanal-ID angegeben. |
badRequest (400) |
invalidLocation |
Der Parameterwert für location und/oder locationRadius ist falsch formatiert. |
badRequest (400) |
invalidRelevanceLanguage |
Der Parameterwert für relevanceLanguage ist falsch formatiert. |
badRequest (400) |
invalidSearchFilter |
Die Anfrage enthält eine ungültige Kombination von Suchfiltern und/oder -einschränkungen. Sie müssen den Parameter type auf video setzen, wenn Sie einen Wert für die Parameter eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated oder videoType festlegen. |
badRequest (400) |
invalidVideoId |
Der Parameter relatedToVideo hat eine ungültige Video-ID angegeben. |
Abos
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von subscriptions
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
subscriptions.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
subscriptionForbidden |
Die Anfrage ist für diesen Kanal nicht richtig authentifiziert oder wird nicht unterstützt. |
notFound (404) |
subscriptionNotFound |
Das Abo, das du löschen möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
subscriptions.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
Das Abo, das Sie erstellen möchten, ist bereits vorhanden. |
badRequest (400) |
subscriptionForbidden |
Du hast die maximale Anzahl von Abos erreicht. |
badRequest (400) |
subscriptionForbidden |
Zu viele aktuelle Abos. Bitte versuchen Sie es in ein paar Stunden noch einmal. |
badRequest (400) |
subscriptionForbidden |
Das Abonnieren deines eigenen Kanals wird nicht unterstützt. |
forbidden (403) |
subscriptionForbidden |
Die Anfrage ist für diesen Kanal nicht richtig authentifiziert oder wird nicht unterstützt. |
notFound (404) |
publisherNotFound |
Die von der Eigenschaft snippet.resourceId der Anfrage angegebene Ressource wurde nicht gefunden. |
notFound (404) |
subscriberNotFound |
Der in der Anfrage angegebene Abonnent wurde nicht gefunden. |
required (400) |
publisherRequired |
Die in der Anfrage angegebene Aboressource muss die Property snippet.resourceId verwenden, um den abonnierten Kanal zu identifizieren. |
subscriptions.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
accountClosed |
Abos konnten nicht abgerufen werden, weil das Konto des Abonnenten geschlossen ist. |
forbidden (403) |
accountSuspended |
Abos konnten nicht abgerufen werden, da das Konto des Abonnenten gesperrt ist. |
forbidden (403) |
subscriptionForbidden |
Der Antragsteller hat keinen Zugriff auf die angeforderten Abos. |
notFound (404) |
subscriberNotFound |
Der in der Anfrage angegebene Abonnent wurde nicht gefunden. |
Miniaturansichten
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von thumbnails
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
thumbnails.set
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidImage |
Der angegebene Bildinhalt ist ungültig. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält nicht den Bildinhalt. |
forbidden (403) |
forbidden |
Das Thumbnail kann für das angegebene Video nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
forbidden (403) |
forbidden |
Der authentifizierte Nutzer ist nicht berechtigt, benutzerdefinierte Video-Thumbnails hochzuladen und festzulegen. |
notFound (404) |
videoNotFound |
Das Video, für das Sie ein Thumbnail einfügen möchten, wurde nicht gefunden. Prüfen Sie, ob der Wert des videoId -Parameters korrekt ist. |
VideoAbuseReportReasons
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von videoAbuseReportReasons
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
videoAbuseReportReasons.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
Videokategorien
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von videoCategories
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
videoCategories.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Die durch den Parameter id identifizierte Videokategorie wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen. |
Videos
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von videos
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
videos.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
In der Anfrage wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben. |
badRequest (400) |
invalidCategoryId |
Die Property snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list , um unterstützte Kategorien abzurufen. |
badRequest (400) |
invalidDescription |
Die Metadaten der Anfrage enthalten eine ungültige Videobeschreibung. |
badRequest (400) |
invalidFilename |
Der im Slug -Header angegebene Dateiname des Videos ist ungültig. |
badRequest (400) |
invalidPublishAt |
Die Metadaten der Anfrage geben einen ungültigen geplanten Veröffentlichungszeitpunkt an. |
badRequest (400) |
invalidRecordingDetails |
Das Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufzeichnungsdetails an. |
badRequest (400) |
invalidTags |
Die Metadaten der Anfrage enthalten ungültige Video-Keywords. |
badRequest (400) |
invalidTitle |
Die Metadaten der Anfrage geben einen ungültigen oder leeren Videotitel an. |
badRequest (400) |
invalidVideoGameRating |
Die Metadaten der Anfrage geben eine ungültige Bewertung für ein Videospiel an. |
badRequest (400) |
invalidVideoMetadata |
Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn die Anfrage den snippet -Teil einer video -Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält nicht den Videocontent. |
badRequest (400) |
uploadLimitExceeded |
Der Nutzer hat die Anzahl der Videos überschritten, die er hochladen kann. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
Es wird versucht, eine ungültige Lizenz für das Video festzulegen. |
forbidden (403) |
forbiddenPrivacySetting |
Es wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen. |
videos.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
videoChartNotFound |
Das angeforderte Videodiagramm wird nicht unterstützt oder ist nicht verfügbar. |
forbidden (403) |
forbidden |
Die Anfrage ist nicht berechtigt, auf die Videodatei oder die Verarbeitungsinformationen zuzugreifen. Beachte, dass die Abschnitte fileDetails , processingDetails und suggestions nur dem Rechteinhaber des Videos zur Verfügung stehen. |
forbidden (403) |
forbidden |
Die Anfrage kann nicht auf Nutzerbewertungen zugreifen. Dieser Fehler kann auftreten, wenn die Anfrage zur Verwendung des Parameters myRating nicht ordnungsgemäß autorisiert ist. |
notFound (404) |
videoNotFound |
Das Video, das du abrufen möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
videos.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Das Video, das du löschen möchtest, kann nicht gelöscht werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
videoNotFound |
Das Video, das du löschen möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
videos.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Die API-Anfrage versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben. |
badRequest (400) |
invalidCategoryId |
Die Property snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list , um unterstützte Kategorien abzurufen. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
In der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen. |
badRequest (400) |
invalidDescription |
Die Metadaten der Anfrage enthalten eine ungültige Videobeschreibung. |
badRequest (400) |
invalidPublishAt |
Die Metadaten der Anfrage geben einen ungültigen geplanten Veröffentlichungszeitpunkt an. |
badRequest (400) |
invalidRecordingDetails |
Das Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufzeichnungsdetails an. |
badRequest (400) |
invalidTags |
Die Metadaten der Anfrage enthalten ungültige Video-Keywords. |
badRequest (400) |
invalidTitle |
Die Metadaten der Anfrage geben einen ungültigen oder leeren Videotitel an. |
badRequest (400) |
invalidVideoMetadata |
Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn die Anfrage den snippet -Teil einer video -Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt. |
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
forbidden (403) |
forbiddenEmbedSetting |
In der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachte, dass einige Kanäle möglicherweise nicht dazu berechtigt sind, eingebettete Player für Livestreams anzubieten. Weitere Informationen finden Sie in der YouTube-Hilfe. |
forbidden (403) |
forbiddenLicenseSetting |
Es wird versucht, eine ungültige Lizenz für das Video festzulegen. |
forbidden (403) |
forbiddenPrivacySetting |
Es wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen. |
notFound (404) |
videoNotFound |
Das Video, das du aktualisieren möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des Felds id im Anfragetext korrekt ist. |
videos.rate
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
emailNotVerified |
Der Nutzer muss vor der Bewertung seine E-Mail-Adresse bestätigen. |
badRequest (400) |
invalidRating |
Die Anfrage enthält einen unerwarteten Wert für den Parameter rating . |
badRequest (400) |
videoPurchaseRequired |
Leihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben. |
forbidden (403) |
forbidden |
Das Video, das du bewerten möchtest, kann nicht bewertet werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
forbidden (403) |
videoRatingDisabled |
Der Inhaber des Videos, das du bewerten möchtest, hat die Altersfreigaben für das Video deaktiviert. |
notFound (404) |
videoNotFound |
Das Video, das du bewerten möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des id -Parameters korrekt ist. |
videos.reportAbuse
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidAbuseReason |
Die Anfrage enthält einen unerwarteten Wert für das Feld reason_id oder eine Kombination der Felder reason_id und secondary_reason_id . |
badRequest (400) |
rateLimitExceeded |
Der Nutzer hat in einem bestimmten Zeitraum zu viele Anfragen gesendet. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
Das Video, für das du einen Missbrauch melden möchtest, wurde nicht gefunden. |
Wasserzeichen
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von watermarks
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.
watermarks.set
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
Das Format des bereitgestellten Bilds wird nicht unterstützt. |
badRequest (400) |
imageTooTall |
Das bereitgestellte Bild ist zu hoch. |
badRequest (400) |
imageTooWide |
Das bereitgestellte Bild ist zu breit. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält nicht den Bildinhalt. |
forbidden (403) |
forbidden |
Das Wasserzeichen kann für den angegebenen Kanal nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert oder der Parameter channelId ist ungültig. |
watermarks.unset
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Die Festlegung des Wasserzeichens kann für den angegebenen Kanal nicht aufgehoben werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert oder der Parameter channelId ist ungültig. |
Kommentare
Die folgenden Tabellen enthalten Fehlermeldungen, die von der API als Antwort auf Aufrufe von
comments
-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler aufgeführt sind.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
undparentId
der Anfrage korrekt sind.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
kann nur verwendet werden, wenn der ParameterwertmoderationStatus
den Wertrejected
hat.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
-Parameters der Anfrage korrekt sind.comments.insert
badRequest (400)
commentTextRequired
comment
, die eingefügt wird, muss einen Wert für das Attributsnippet.textOriginal
angeben. Kommentare dürfen nicht leer sein.badRequest (400)
commentTextTooLong
comment
-Ressource enthält zu viele Zeichen für das Attributsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
angegeben wird. In einercommentThread
-Ressource gibt die Eigenschaftsnippet.canReply
an, ob der aktuelle Betrachter auf den Thread antworten kann.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
im Text der API-Anfrage hat jedoch keinen Wert für die Propertysnippet.parentId
angegeben.badRequest (400)
processingFailure
comment
-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
im Anfragetext korrekt ist.comments.markAsSpam
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
der Anfrage korrekt sind.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
-Parameters korrekt ist.comments.update
badRequest (400)
commentTextTooLong
comment
, die aktualisiert wird, enthält zu viele Zeichen im Attributsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
im Anfragetext korrekt ist.