YouTube Data API - Errors

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

YouTube hat die Kanalbulletin-Funktion eingestellt. Die Methode 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.
  • Wenn der Kommentar für einen Kanal gilt, muss die im Anfragetext angegebene Ressource einen Wert für das Attribut snippet.channelId enthalten. Kommentare zu einem Kanal werden auf dem Tab Diskussion angezeigt.
  • Wenn der Kommentar auf ein Video zutrifft, achte darauf, dass die Ressource sowohl für die snippet.channelId- als auch für die snippet.videoId-Property Werte enthält. Ein Kommentar, der für ein Video gilt, wird auf der Wiedergabeseite des Videos angezeigt.
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.

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

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Der ID-Filter ist nur mit Kommentaren kompatibel, die auf Google+ basieren.
forbidden (403) forbidden Mindestens einer der angeforderten Kommentare kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens einer der angegebenen Kommentare wurde nicht gefunden. Prüfen Sie, ob die Werte der Parameter id und parentId der Anfrage korrekt sind.

comments.setModerationStatus

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) banWithoutReject Der Parameter banAuthor kann nur verwendet werden, wenn der Parameterwert moderationStatus den Wert rejected hat.
badRequest (400) operationNotSupported Kommentare, die nicht auf Google+ basieren, bieten nur eingeschränkte Moderationsfunktionen.
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.
forbidden (403) forbidden Der Moderationsstatus von einem oder mehreren Kommentaren kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens ein Kommentar, den die Anfrage zu aktualisieren versucht, wurde nicht gefunden. Prüfen Sie, ob die Werte des id-Parameters der Anfrage korrekt sind.

comments.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Die Ressource comment, die eingefügt wird, muss einen Wert für das Attribut 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.textOriginal.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Der API-Nutzer kann keine Kommentare als Antwort auf den Kommentar der obersten Ebene einfügen, der von der Property snippet.parentId angegeben wird. In einer commentThread-Ressource gibt die Eigenschaft snippet.canReply an, ob der aktuelle Betrachter auf den Thread antworten kann.
badRequest (400) parentCommentIsPrivate Der angegebene übergeordnete Kommentar ist privat. Die API unterstützt keine Antworten auf private Kommentare.
badRequest (400) parentIdMissing Der eingefügte Kommentar muss mit einem übergeordneten Kommentar verknüpft sein. Die Ressource comment im Text der API-Anfrage hat jedoch keinen Wert für die Property snippet.parentId angegeben.
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 comment-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
forbidden (403) forbidden Der Kommentar kann 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) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert der Eigenschaft snippet.parentId im Anfragetext korrekt ist.

comments.markAsSpam

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Kommentare, die nicht auf Google+ basieren, können nicht als Spam markiert werden.
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.
forbidden (403) forbidden Mindestens ein Kommentar konnte aufgrund unzureichender Berechtigungen nicht als Spam markiert werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens ein Kommentar, den die Anfrage zu aktualisieren versucht, wurde nicht gefunden. Prüfen Sie, ob die Werte im Parameter id der Anfrage korrekt sind.

comments.delete

Fehlertyp Fehlerdetails Beschreibung
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.
forbidden (403) forbidden Der Kommentar konnte aufgrund unzureichender Berechtigungen nicht gelöscht werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters korrekt ist.

comments.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextTooLong Die Ressource comment, die aktualisiert wird, enthält zu viele Zeichen im Attribut snippet.textOriginal.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Nur Google+ Kommentare können aktualisiert werden.
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 comment-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
forbidden (403) forbidden Der Kommentar konnte aufgrund unzureichender Berechtigungen nicht aktualisiert 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 zu aktualisieren.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert der Eigenschaft id im Anfragetext 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.

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.