YouTube Data API - Errors

In diesem Dokument werden die verschiedenen Arten von Fehlern beschrieben, die bei YouTube Data API-Vorgängen zurückgegeben werden können. In der Referenzdokumentation für jede Methode finden Sie auch eine Liste der Fehler.

Allgemeine Fehler

In den folgenden Tabellen werden API-Fehlermeldungen aufgeführt, die nicht für eine bestimmte API-Methode spezifisch sind.

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, da Sie Ihr Kontingent überschritten haben.

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 wird 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. Wenn der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das betreffende Konto.
forbidden (403) authenticatedUserAccountSuspended Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Wenn der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das betreffende Konto.
forbidden (403) authenticatedUserNotChannel Für diese Anfrage muss der authentifizierte Nutzer auf einen Kanal verweisen, tut dies aber nicht. Wenn Ihre Anfrage authentifiziert ist und den Delegierungsparameter 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 darf nicht im Namen des angegebenen Rechteinhabers handeln.
forbidden (403) insufficientCapabilities Der CMS-Nutzer hat nicht genügend Berechtigungen.
forbidden (403) insufficientPermissions Das für die Anfrage bereitgestellte OAuth 2.0-Token enthält Bereiche, die für den Zugriff auf die angeforderten Daten nicht ausreichen.
notFound (404) contentOwnerAccountNotFound Das angegebene Konto des Rechteinhabers wurde nicht gefunden.

Request context errors

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidLanguage Der Parameterwert hl gibt keinen gültigen Sprachcode an.
badRequest (400) invalidMine Die Verwendung des Parameters mine in der Anfrage wird nicht unterstützt.
badRequest (400) invalidMine Der Parameter mine kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Entferne entweder den Parameter mine, authentifiziere dich als YouTube-Nutzer, indem du den Parameter onBehalfOfContentOwner entfernst, oder handle als einer der Kanäle des Partners, indem du den Parameter onBehalfOfContentOwnerChannel angibst, sofern er für die aufgerufene Methode verfügbar ist.
badRequest (400) invalidPart Der Parameter part 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 enthält einen unerwarteten Wert.
badRequest (400) unknownPart Der Parameter part der Anfrage enthält einen unbekannten Wert.
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 ein nicht verknüpftes Google-Konto hat. Das bedeutet, dass er zwar ein Google-Konto, aber keinen YouTube-Kanal hat. Diese Nutzer können auf viele Funktionen zugreifen, die von der Nutzerautorisierung abhängen, z. B. Videos bewerten oder Videos einer watch_later-Playlist hinzufügen. Der Nutzer benötigt jedoch beispielsweise einen YouTube-Kanal, um ein Video hochladen zu können. Nutzer mit einem Gmail-Konto oder einem Android-Gerät haben mit Sicherheit ein Google-Konto, haben 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 Dienstkonten zu verwenden. YouTube unterstützt keine Dienstkonten. Wenn du versuchst, dich mit einem Dienstkonto zu authentifizieren, wird dieser Fehler angezeigt.

Im Blogpost zur YouTube API, in dem die Google-Kontounterstützung vorgestellt wird, wird der Fehler youtubeSignupRequired ausführlicher beschrieben. Im Blogpost wird der Fehler zwar für API-Version 2.1 erklärt, die Bedeutung des Fehlers ist aber auch für andere Versionen gültig.

Aktivitäten

Die Funktion „Kanalnachrichten“ wurde auf YouTube eingestellt. Die Methode activities.insert wird nicht mehr unterstützt.

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit activities-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

activities.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) homeParameterDeprecated Die Aktivitätsdaten der Startseite 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 Kanal-ID, die über den Parameter channelId der Anfrage angegeben wurde, konnte nicht gefunden werden.
notFound (404) homeChannelNotFound Für den aktuell authentifizierten Nutzer kann kein YouTube-Startseitenfeed gefunden werden.
unauthorized (401) authorizationRequired Die Anfrage verwendet den Parameter home, ist aber nicht ordnungsgemäß autorisiert.

captions

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit captions-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

captions.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack zu löschen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) captionNotFound Der Untertiteltrack konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

captions.download

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack herunterzuladen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
invalidValue (400) couldNotConvert Die Untertitel-Track-Daten konnten nicht in die gewünschte Sprache und/oder das gewünschte Format konvertiert werden. Achte darauf, dass die angeforderten Werte für tfmt und tlang gültig sind und dass die snippet.status des angeforderten Untertitel-Tracks nicht failed ist.
notFound (404) captionNotFound Der Untertiteltrack konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

captions.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Die Anfrage enthält keinen Untertitel-Track-Inhalt.
conflict (409) captionExists Für das angegebene Video gibt es bereits einen Untertiteltrack mit den angegebenen snippet.language und snippet.name. Ein Video kann mehrere Tracks für dieselbe Sprache haben, aber jeder Track muss einen anderen Namen haben.

Es gibt mehrere Möglichkeiten, den Fehler zu beheben. Sie können den vorhandenen Titel löschen und dann einen neuen einfügen oder den Namen des neuen Titels ändern, bevor Sie ihn einfügen.
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack hochzuladen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
invalidValue (400) invalidMetadata Die Anfrage enthält ungültige Metadatenwerte, die das Erstellen des Titels verhindern. Prüfen Sie, ob in der Anfrage gültige Werte für die Properties snippet.language, snippet.name und snippet.videoId angegeben sind. Die Property snippet.isDraft kann auch enthalten sein, ist aber nicht erforderlich.
notFound (404) videoNotFound Das mit dem Parameter videoId angegebene Video konnte nicht gefunden werden.
invalidValue (400) nameTooLong Die in der Anfrage angegebene snippet.name ist zu lang. Er darf höchstens 150 Zeichen lang sein.

captions.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Mindestens ein Untertiteltrack konnte nicht abgerufen werden, weil die mit der Anfrage verknüpften Berechtigungen nicht ausreichen, um die angeforderten Ressourcen abzurufen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) captionNotFound Mindestens einer der angegebenen Untertiteltracks konnte nicht gefunden werden. Dieser Fehler tritt auf, wenn mit dem Parameter videoId ein tatsächliches Video angegeben wird, mit dem Parameter id aber entweder Untertitel-Track-IDs, die nicht vorhanden sind, oder Track-IDs, die mit anderen Videos verknüpft sind. Prüfe, ob die Werte der Parameter id und videoId der Anfrage korrekt sind.
notFound (404) videoNotFound Das mit dem Parameter videoId angegebene Video konnte nicht gefunden werden.

captions.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Bei der Anfrage wurde keine aktualisierte Untertiteldatei hochgeladen. Der tatsächliche Inhalt des Titels ist erforderlich, wenn der Parameter sync auf true festgelegt ist.
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack zu aktualisieren. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) captionNotFound Der angegebene Untertiteltrack konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

channelBanners

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit channelBanners-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

channelBanners.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) bannerAlbumFull Dein YouTube-Album mit Kanalbildern enthält zu viele Bilder. Rufen Sie http://photos.google.com auf, rufen Sie die Seite „Alben“ auf und entfernen Sie einige Bilder aus diesem Album.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Bildinhalte.

channelSections

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit channelSections-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

channelSections.delete

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) notEditable Dieser Kanalbereich kann nicht gelöscht werden.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht richtig authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) idInvalid Für die Property id wurde eine ungültige Kanalbereichs-ID angegeben.
invalidValue (400) idRequired Für die Property id muss ein Wert angegeben werden, der den zu löschenden Kanalbereich identifiziert.
notFound (404) channelNotFound Der Kanal wurde nicht gefunden.
notFound (404) channelSectionNotFound Der Kanalbereich, den du aktualisieren möchtest, wurde nicht gefunden.

channelSections.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError Das Attribut snippet.defaultLanguage der channelSection-Ressource muss festgelegt sein, damit das localizations-Objekt für diese Ressource eingefügt oder aktualisiert werden kann.
badRequest (400) invalidLanguage Einer der Sprachschlüssel des localizations-Objekts hat die Validierung nicht bestanden. Verwende 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 Kanalbereich kann nicht erstellt werden.
badRequest (400) styleRequired Für die channelSection-Ressource muss ein Wert für das Feld snippet.style angegeben werden.
badRequest (400) targetInvalidCountry Einer der Werte in der Liste targeting.countries konnte nicht validiert werden. Verwende 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 Liste targeting.languages konnte nicht validiert werden. Verwende 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 Liste targeting.regions konnte nicht validiert werden. Verwende 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 Für die channelSection-Ressource muss ein Wert für das Feld snippet.type angegeben werden.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht richtig authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) channelNotActive Mindestens einer der angegebenen Kanäle ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, da doppelte Kanäle angegeben wurden.
invalidValue (400) channelsNeeded Wenn die Property snippet.type den Wert multipleChannels hat, muss die Property contentDetails.channels[] angegeben werden und mindestens ein Channel muss angegeben werden.
invalidValue (400) channelsNotExpected In der mit der Anfrage bereitgestellten Ressource wurde ein Wert für die Property contentDetails.channels[] angegeben. Für diesen Kanalbereich sind jedoch keine Kanäle vorgesehen.
invalidValue (400) contentDetailsNeeded Die eingefügte Ressource muss ein contentDetails-Objekt für diesen Kanalabschnitt enthalten.
invalidValue (400) inValidPosition Die Property 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 Kanalbereichen hat.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, im Kanalbereich zu viele Kanäle anzugeben.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalbereich aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn die Property snippet.type den Wert singlePlaylist hat, muss für die Property contentDetails.playlists[] genau eine Playlist angegeben werden.
invalidValue (400) ownChannelInChannels Du kannst deinen eigenen Kanal nicht in einen Kanalbereich aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Mindestens eine der angegebenen Playlists ist privat und kann daher nicht in den Kanalbereich aufgenommen werden.
invalidValue (400) playlistsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Playlists angegeben wurden.
invalidValue (400) playlistsNeeded Wenn die Property snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss die Property contentDetails.playlists[] angegeben werden.
invalidValue (400) playlistsNotExpected In der mit der Anfrage bereitgestellten Ressource ist ein Wert für die Property contentDetails.playlists[] angegeben. Für diesen Kanalbereich sind jedoch keine Playlists vorgesehen.
invalidValue (400) snippetNeeded Sie müssen eine snippet angeben, um den Kanalbereich zu erstellen.
invalidValue (400) titleLengthExceeded Der Wert der Property snippet.title ist zu lang.
invalidValue (400) titleRequired Wenn die Property snippet.type den Wert multiplePlaylists oder multipleChannels hat, müssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert für die Property snippet.title angeben.
notFound (404) channelNotFound Mindestens einer der angegebenen Kanäle konnte nicht gefunden werden.
notFound (404) playlistNotFound Mindestens eine der angegebenen Playlists konnte nicht gefunden werden.

channelSections.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) channelSectionForbidden Der Antragsteller ist nicht berechtigt, auf die angeforderten Kanalbereiche zuzugreifen.
invalidValue (400) idInvalid In der Anfrage ist eine ungültige Kanalbereichs-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 Kanalbereich kann nicht gefunden werden.

channelSections.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError Das Attribut snippet.defaultLanguage der channelSection-Ressource muss festgelegt sein, damit das localizations-Objekt für diese Ressource eingefügt oder aktualisiert werden kann.
badRequest (400) invalidLanguage Einer der Sprachschlüssel des localizations-Objekts hat die Validierung nicht bestanden. Verwende 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 Kanalbereich kann nicht bearbeitet werden.
badRequest (400) styleRequired Für die channelSection-Ressource muss ein Wert für das Feld snippet.style angegeben werden.
badRequest (400) targetInvalidCountry Einer der Werte in der Liste targeting.countries konnte nicht validiert werden. Verwende 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 Liste targeting.languages konnte nicht validiert werden. Verwende 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 Liste targeting.regions konnte nicht validiert werden. Verwende 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 Für die channelSection-Ressource muss ein Wert für das Feld snippet.type angegeben werden.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht richtig authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) channelNotActive Mindestens einer der angegebenen Kanäle ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, da doppelte Kanäle angegeben wurden.
invalidValue (400) channelsNeeded Wenn die Property snippet.type den Wert multipleChannels hat, muss die Property contentDetails.channels[] angegeben werden und mindestens ein Channel muss angegeben werden.
invalidValue (400) channelsNotExpected In der mit der Anfrage bereitgestellten Ressource wurde ein Wert für die Property contentDetails.channels[] angegeben. Für diesen Kanalbereich sind jedoch keine Kanäle vorgesehen.
invalidValue (400) contentDetailsNeeded Die zu aktualisierende Ressource muss ein contentDetails-Objekt für diesen Kanalabschnitt enthalten.
invalidValue (400) idInvalid Für die Property id wurde eine ungültige Kanalbereichs-ID angegeben.
invalidValue (400) idRequired Für die Property id muss ein Wert angegeben werden, der den aktualisierten Kanalbereich angibt.
invalidValue (400) inValidPosition Die Property snippet.position enthält einen ungültigen Wert.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, im Kanalbereich zu viele Kanäle anzugeben.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalbereich aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn die Property snippet.type den Wert singlePlaylist hat, muss für die Property contentDetails.playlists[] genau eine Playlist angegeben werden.
invalidValue (400) ownChannelInChannels Du kannst deinen eigenen Kanal nicht in einen Kanalbereich aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Mindestens eine der angegebenen Playlists ist privat und kann daher nicht in den Kanalbereich aufgenommen werden.
invalidValue (400) playlistsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Playlists angegeben wurden.
invalidValue (400) playlistsNeeded Wenn die Property snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss die Property contentDetails.playlists[] angegeben werden.
invalidValue (400) playlistsNotExpected In der mit der Anfrage bereitgestellten Ressource ist ein Wert für die Property contentDetails.playlists[] angegeben. Für diesen Kanalbereich sind jedoch keine Playlists vorgesehen.
invalidValue (400) snippetNeeded Sie müssen eine snippet angeben, um den Kanalbereich zu aktualisieren.
invalidValue (400) titleLengthExceeded Der Wert der Property snippet.title ist zu lang.
invalidValue (400) titleRequired Wenn die Property snippet.type den Wert multiplePlaylists oder multipleChannels hat, müssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert für die Property snippet.title angeben.
notFound (404) channelNotFound Mindestens einer der angegebenen Kanäle kann nicht gefunden werden.
notFound (404) channelSectionNotFound Der Kanalbereich, den du aktualisieren möchtest, wurde nicht gefunden.
notFound (404) playlistNotFound Mindestens eine der angegebenen Playlists konnte nicht gefunden werden.

Kanäle

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit channels-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen 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 von Rechteinhabern mit dem Parameter onBehalfOfContentOwner darf nur id oder managedByMe angegeben werden.
forbidden (403) channelForbidden Der vom Parameter id angegebene Channel unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) categoryNotFound Die Kategorie, die mit dem Parameter categoryId angegeben wurde, kann nicht gefunden werden. Mit der Methode guideCategories.list können Sie eine Liste der gültigen Werte abrufen.
notFound (404) channelNotFound Der im Parameter id angegebene Kanal kann nicht gefunden werden.

channels.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) brandingValidationError Einer der Werte im brandingSettings-Objekt konnte nicht validiert werden. Rufe mit der Methode channels.list die vorhandenen Einstellungen für den Kanal ab und aktualisiere die Attributwerte gemäß den Richtlinien in der channels-Ressourcendokumentation.
badRequest (400) channelTitleUpdateForbidden Wenn du die brandingSettings part eines Kanals aktualisierst, musst du den Wert der Property brandingSettings.channel.title auf den aktuellen Titel des Kanals festlegen oder die Property weglassen. Die API gibt einen Fehler zurück, wenn Sie den Wert der Property ändern.
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so festgelegt sein, dass localizations aktualisiert wird.
badRequest (400) invalidBrandingOption Eine der von Ihnen angegebenen Branding-Einstellungen existiert nicht. Verwende die Methode channels.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der channels-Ressourcendokumentation.
badRequest (400) invalidCustomMessage Die Anfragemetadaten enthalten eine ungültige benutzerdefinierte Nachricht. Prüfe den Wert des Attributs invideoPromotion.items[].customMessage in der Ressource, an die die Anfrage gesendet wurde.
badRequest (400) invalidDuration In den Anfragemetadaten ist im Abschnitt „invideoPromotion“ eine ungültige Dauer angegeben.
badRequest (400) invalidDuration In den Anfragemetadaten ist ein ungültiger Positionierungstyp für die Positionierung des beworbenen Artikels im Videoplayer angegeben. Prüfe den Wert des Attributs invideoPromotion.position.type in der Ressource, an die die Anfrage gesendet wurde.
badRequest (400) invalidRecentlyUploadedBy In den Anfragemetadaten ist eine ungültige Kanal-ID angegeben. Prüfe den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, an die die Anfrage gesendet wurde.
badRequest (400) invalidTimingOffset Die Anfragemetadaten enthalten im Bereich „invideoPromotion“ einen ungültigen Zeitversatz.
badRequest (400) invalidTimingOffset In den Anfragemetadaten ist ein ungültiger Zeitversatz für die Bestimmung angegeben, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfe den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, an die die Anfrage gesendet wurde.
badRequest (400) invalidTimingType In den Anfragemetadaten ist eine ungültige Zeitmethode für die Bestimmung angegeben, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfe den Wert des Attributs invideoPromotion.timing.type in der Ressource, an die die Anfrage gesendet wurde.
badRequest (400) localizationValidationError Einer der Werte im Objekt „localizations“ konnte nicht validiert werden. Verwende die Methode channels.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Anleitung für Channel-Ressourcen.
badRequest (400) tooManyPromotedItems Die zulässige Anzahl von beworbenen Elementen im Bereich „invideoPromotion“ wurde überschritten.
forbidden (403) channelForbidden Der im Parameter id angegebene Channel unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
forbidden (403) promotedVideoNotAllowed Der Kanal, der mit der API-Anfrage aktualisiert werden soll, kann nicht gefunden werden. Prüfe den Wert der Property id in der channel-Ressource, die mit 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 mit dem Parameter id angegebene Kanal kann nicht gefunden werden oder bietet keine Branding-Optionen.
notFound (404) channelNotFound Der im Parameter id angegebene Kanal kann nicht gefunden werden.
notFound (404) unknownChannelId Die angegebene Kanal-ID wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Kanal-ID von „vor Kurzem von“ wurde nicht gefunden.
notFound (404) unknownVideoId Die als beworbenes Element angegebene Video-ID wurde nicht gefunden.
required (400) requiredItemIdType In den Metadaten der Anfrage muss im Abschnitt „invideoPromotion“ ein Artikeltyp angegeben sein.
required (400) requiredItemId In den Anfragemetadaten muss im Bereich „invideoPromotion“ ein Element angegeben werden.
required (400) requiredTimingOffset In den Anfragemetadaten muss ein Standard-Zeitversatz angegeben werden, damit YouTube festlegen kann, wann das beworbene Element eingeblendet werden soll. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingOffset In den Anfragemetadaten muss ein Zeitversatz angegeben werden, damit YouTube festlegen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Anfragemetadaten muss eine Zeitmethode angegeben werden, damit YouTube ermitteln kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Anfragemetadaten muss eine Zeitmethode angegeben werden, damit YouTube ermitteln kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTiming Die Anfragemetadaten müssen für jedes Element im invideoPromotion-Teil ein Timing angeben.
required (400) requiredVideoId In den Anfragemetadaten muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren.
required (400) requiredWebsiteUrl In den Anfragemetadaten muss im Bereich „invideoPromotion“ eine Website-URL angegeben werden. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die die Anfrage sendet.

commentThreads

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit commentThreads-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

commentThreads.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher hat der API-Server die Anfrage nicht verstanden.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel 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 Video, das durch den Parameter videoId angegeben ist, sind 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 mit dem Parameter allThreadsRelatedToChannelId angegebene Kanal konnte nicht gefunden werden.
notFound (404) commentThreadNotFound Mindestens einer der angegebenen Kommentar-Threads konnte nicht gefunden werden. Prüfe die Werte des Parameters id der Anfrage, um sicherzustellen, dass sie korrekt sind.
notFound (404) videoNotFound Das mit dem Parameter videoId angegebene Video konnte nicht gefunden werden.

commentThreads.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelOrVideoIdMissing Jeder Kommentarfaden muss mit einem Kanal oder Video verknüpft sein. Achten Sie darauf, dass für die Ressource Werte für die Properties snippet.channelId und snippet.videoId angegeben sind. Ein Kommentar zu einem Video wird auf der Wiedergabeseite des Videos angezeigt.
badRequest (400) commentTextRequired Für die eingefügte comment-Ressource muss ein Wert für die Property snippet.topLevelComment.snippet.textOriginal angegeben werden. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte comment-Ressource enthält in der Property snippet.topLevelComment.snippet.textOriginal zu viele Zeichen.
badRequest (400) invalidCommentThreadMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel 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 Kommentar-Thread 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 wurde, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder einen Kommentarfaden einzufügen.
notFound (404) channelNotFound Der angegebene Kanal konnte nicht gefunden werden. Prüfen Sie, ob der Wert des Attributs snippet.channelId korrekt ist.
notFound (404) videoNotFound Das angegebene Video konnte nicht gefunden werden. Prüfen Sie, ob der Wert des Attributs snippet.videoId korrekt ist.

Kommentare

Die comments.markAsSpam-Methode wird nicht mehr unterstützt.

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit comments-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

comments.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher hat der API-Server die Anfrage nicht verstanden.
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 konnte nicht gefunden werden. Prüfe, 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 rejected ist.
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher hat der API-Server die Anfrage nicht verstanden.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist.
forbidden (403) forbidden Der Moderationsstatus eines oder mehrerer Kommentare kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens einer der Kommentare, die mit der Anfrage aktualisiert werden sollen, konnte nicht gefunden werden. Prüfe, ob die Werte des Parameters id der Anfrage korrekt sind.

comments.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Für die eingefügte comment-Ressource muss ein Wert für die Property snippet.textOriginal angegeben werden. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte comment-Ressource enthält in der Property snippet.textOriginal zu viele Zeichen.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Der API-Nutzer kann keinen Kommentar als Antwort auf den übergeordneten Kommentar einfügen, der durch das Attribut snippet.parentId gekennzeichnet ist. In einer commentThread-Ressource gibt das Attribut 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. Für die comment-Ressource im Textkörper der API-Anfrage wurde jedoch kein Wert für die snippet.parentId-Eigenschaft angegeben.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel 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 wurde, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder einen Kommentarfaden einzufügen.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfe, ob der Wert des Attributs snippet.parentId im Anfragetext korrekt ist.

comments.delete

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel 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üfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

comments.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextTooLong Die aktualisierte comment-Ressource enthält zu viele Zeichen in der snippet.textOriginal-Eigenschaft.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher hat der API-Server die Anfrage nicht verstanden.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel 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 wurde, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarfaden zu aktualisieren.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfe, ob der Wert des Attributs id im Anfragetext korrekt ist.

Mitglieder

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit members-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

members.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Auf dem Kanal des Creators, 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 für den Parameter pageToken ein Token angegeben ist, das mit einem anderen Modus als dem angegebenen abgerufen wurde.
badRequest (400) invalidPageToken Der Parameterwert für pageToken ist ungültig. Dieser Fehler tritt auf, wenn das in der Anfrage verwendete Seitentoken abgelaufen ist.
badRequest (400) invalidHasAccessToLevel Der Parameterwert für hasAccessToLevel ist ungültig. Es gibt keine Ebene mit der angegebenen id.
badRequest (400) invalidFilterByMemberChannelId Der Parameterwert für filterByMemberChannelId ist ungültig. Dieser Fehler tritt auf, wenn für den Parameter filterByMemberChannelId mehr als 100 Kanäle angegeben werden.

membershipsLevels

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit members-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

membershipsLevels.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Auf dem Kanal des Creators, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert.

playlistItems

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit playlistItems-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen 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 mit dem id-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht das Löschen von Videos aus der angegebenen Playlist. Du kannst beispielsweise kein Video aus der Playlist „Hochgeladene Videos“ löschen.

playlistItems.insert

Fehlertyp Fehlerdetails Beschreibung
duplicate videoAlreadyInPlaylist Das Video, das du der Playlist hinzufügen möchtest, ist bereits in der Playlist enthalten.
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 festzulegen. 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 identifiziert das Element, das der Playlist hinzugefügt wird, z. B. youtube#video.
invalidValue (400) manualSortRequired Bei der Anfrage wird versucht, die Position des Playlist-Elements festzulegen, aber die Playlist wird nicht manuell sortiert. Playlist-Elemente können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können den Fehler beheben, indem Sie das snippet.position-Element aus der Ressource entfernen, die über die Anfrage eingefügt wird. Wenn du das Playlist-Element an einer bestimmten Position in der Liste haben möchtest, musst du zuerst in den Einstellungen der Playlist die Option Sortierung auf Manuell setzen. 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 nicht das Einfügen von Videos in die angegebene Playlist. Du kannst beispielsweise kein Video in die Playlist „Hochgeladene Videos“ einfügen.
notFound (404) playlistNotFound Die Playlist, die mit dem playlistId-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
notFound (404) videoNotFound Das Video, das du der Playlist hinzufügen möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert der Property videoId korrekt ist.
required (400) channelIdRequired In der Anfrage ist kein Wert für die erforderliche Property channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für die erforderliche Property playlistId angegeben.
required (400) resourceIdRequired Die Anfrage muss eine Ressource enthalten, in der das snippet-Objekt ein 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 playlistId-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
notFound (404) videoNotFound Das mit dem Parameter videoId der Anfrage angegebene Video konnte nicht gefunden werden.
required (400) playlistIdRequired In der Aktivierungsanfrage ist kein Wert für die erforderliche Property playlistId angegeben.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Auflistung von Videos in der angegebenen Playlist. Du kannst beispielsweise kein Video in deiner „Später ansehen“-Playlist hinzufügen.

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 festzulegen. 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 identifiziert das Element, 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 Bei der Anfrage wird versucht, die Position des Playlist-Elements festzulegen, aber die Playlist wird nicht manuell sortiert. Playlist-Elemente können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können den Fehler beheben, indem Sie das snippet.position-Element aus der Ressource entfernen, die über die Anfrage eingefügt wird. Wenn du möchtest, dass das Playlist-Element eine bestimmte Position in der Liste hat, musst du zuerst die Option Sortierung in den Einstellungen der Playlist auf Manuell setzen. 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 beispielsweise kein Video in der Playlist „Hochgeladene Videos“ aktualisieren.
notFound (404) playlistItemNotFound Das Playlist-Element, das mit der id-Eigenschaft der Anfrage angegeben wurde, kann nicht gefunden werden.
notFound (404) playlistNotFound Die Playlist, die mit dem playlistId-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
required (400) channelIdRequired In der Anfrage ist kein Wert für die erforderliche Property channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für die erforderliche Property playlistId angegeben.
required (400) playlistItemIdRequired Die in der Anfrage angegebene Playlist-Elementressource muss das id-Attribut verwenden, um das zu aktualisierende Playlist-Element zu identifizieren.

Playlists

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit playlists-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen 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 id-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Löschen der angegebenen Playlist nicht. Du kannst beispielsweise die Playlist mit deinen 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 mit dem id-Parameter der Anfrage angegebene Playlist unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) channelNotFound Der im Parameter channelId angegebene Kanal kann nicht gefunden werden.
notFound (404) playlistNotFound Die Playlist, die mit dem id-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt keine Listen der angegebenen Playlist. Du kannst beispielsweise deine Playlist „Später ansehen“ nicht auflisten.

playlists.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so festgelegt sein, dass localizations aktualisiert wird.
badRequest (400) localizationValidationError Einer der Werte im Objekt „localizations“ konnte nicht validiert werden. Verwende die Methode playlists.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Playlist-Ressourcendokumentation.
badRequest (400) maxPlaylistExceeded Die Playlist kann nicht erstellt werden, da der Kanal bereits die maximal zulässige Anzahl an Playlists hat.
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 Bei der Anfrage muss ein Playlist-Titel angegeben werden.

playlists.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so festgelegt sein, dass localizations aktualisiert wird.
badRequest (400) localizationValidationError Einer der Werte im Objekt „localizations“ konnte nicht validiert werden. Verwende die Methode playlists.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Playlist-Ressourcendokumentation.
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 nicht die Aktualisierung der angegebenen Playlist. So kannst du beispielsweise die Eigenschaften der Playlist mit deinen hochgeladenen Videos nicht aktualisieren.
notFound (404) playlistNotFound Die Playlist, die mit dem id-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
required (400) playlistTitleRequired In der Anfrage muss ein Playlist-Titel angegeben werden.

Abos

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit subscriptions-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

subscriptions.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) subscriptionForbidden Die Anfrage ist nicht richtig authentifiziert oder wird für diesen Kanal nicht unterstützt.
notFound (404) subscriptionNotFound Das Abo, das Sie löschen möchten, wurde nicht gefunden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

subscriptions.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) subscriptionDuplicate Das Abo, das Sie erstellen möchten, ist bereits vorhanden.
badRequest (400) subscriptionForbidden Sie haben die maximale Anzahl von Abos erreicht.
badRequest (400) subscriptionForbidden Vorläufiges Abolimit erreicht. Versuche es bitte in ein paar Stunden erneut.
badRequest (400) subscriptionForbidden Das Abonnieren deines eigenen Kanals wird nicht unterstützt.
forbidden (403) subscriptionForbidden Die Anfrage ist nicht richtig authentifiziert oder wird für diesen Kanal nicht unterstützt.
notFound (404) publisherNotFound Die über die snippet.resourceId-Eigenschaft der Anfrage angegebene Ressource kann nicht gefunden werden.
notFound (404) subscriberNotFound Der mit der Anfrage angegebene Abonnent konnte nicht gefunden werden.
required (400) publisherRequired Die in der Anfrage angegebene Aboressource muss das Attribut snippet.resourceId verwenden, um den abonnierten Kanal zu identifizieren.

subscriptions.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) accountClosed Abos konnten nicht abgerufen werden, da 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 ist nicht berechtigt, auf die angeforderten Abos zuzugreifen.
notFound (404) subscriberNotFound Der mit der Anfrage angegebene Abonnent konnte nicht gefunden werden.

Miniaturansichten

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit thumbnails-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

thumbnails.set

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidImage Der angegebene Bildinhalt ist ungültig.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Bildinhalte.
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, kann nicht gefunden werden. Prüfe den Wert des Parameters videoId der Anfrage, um sicherzustellen, dass er korrekt ist.
tooManyRequests (429) uploadRateLimitExceeded Auf dem Kanal wurden in letzter Zeit zu viele Thumbnails hochgeladen. Bitte versuchen Sie es später noch einmal.

videoAbuseReportReasons

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit videoAbuseReportReasons-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

videoAbuseReportReasons.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.

videoCategories

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit videoCategories-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

videoCategories.list

Fehlertyp Fehlerdetails Beschreibung
notFound (404) videoCategoryNotFound Die mit dem Parameter id angegebene Videokategorie kann nicht gefunden werden. Mit der Methode videoCategories.list kannst du eine Liste der gültigen Werte abrufen.

Videos

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit videos-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

videos.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Bei der Anfrage wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Für die Property snippet.categoryId ist eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDescription Die Anfragemetadaten enthalten eine ungültige Videobeschreibung.
badRequest (400) invalidFilename Der im Slug-Header angegebene Videodateiname ist ungültig.
badRequest (400) invalidPublishAt In den Anfragemetadaten ist ein ungültiger Zeitpunkt für die geplante Veröffentlichung angegeben.
badRequest (400) invalidRecordingDetails Das recordingDetails-Objekt in den Anfragemetadaten enthält ungültige Aufnahmedetails.
badRequest (400) invalidTags Die Anfragemetadaten enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle In den Anfragemetadaten ist ein ungültiger oder leerer Videotitel angegeben.
badRequest (400) invalidVideoGameRating In den Metadaten der Anfrage ist eine ungültige Altersfreigabe für Videospiele angegeben.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn mit der Anfrage der snippet-Teil einer video-Ressource aktualisiert wird, aber weder für die snippet.title- noch für die snippet.categoryId-Eigenschaft ein Wert festgelegt wird.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Videoinhalte.
badRequest (400) uploadLimitExceeded Der Nutzer hat die zulässige Anzahl der hochzuladenden Videos überschritten.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Bei der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting Bei der Anfrage 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 Der Zugriff auf die Videodatei oder die Verarbeitungsinformationen ist nicht ordnungsgemäß autorisiert. Die Teile fileDetails, processingDetails und suggestions sind nur für den Inhaber des Videos verfügbar.
forbidden (403) forbidden Die Anfrage kann nicht auf Informationen zu Nutzerbewertungen zugreifen. Dieser Fehler kann auftreten, wenn die Anfrage nicht ordnungsgemäß für die Verwendung des Parameters myRating autorisiert ist.
notFound (404) videoNotFound Das Video, das Sie abrufen möchten, konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

videos.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Das Video, das Sie löschen möchten, kann nicht gelöscht werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) videoNotFound Das Video, das Sie löschen möchten, wurde nicht gefunden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

videos.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Bei der API-Anfrage werden lokalisierte Videodetails hinzugefügt, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Für die Property snippet.categoryId ist eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDefaultBroadcastPrivacySetting Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.
badRequest (400) invalidDescription Die Anfragemetadaten enthalten eine ungültige Videobeschreibung.
badRequest (400) invalidPublishAt In den Anfragemetadaten ist ein ungültiger Zeitpunkt für die geplante Veröffentlichung angegeben.
badRequest (400) invalidRecordingDetails Das recordingDetails-Objekt in den Anfragemetadaten enthält ungültige Aufnahmedetails.
badRequest (400) invalidTags Die Anfragemetadaten enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle In den Anfragemetadaten ist ein ungültiger oder leerer Videotitel angegeben.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn mit der Anfrage der snippet-Teil einer video-Ressource aktualisiert wird, aber weder für die snippet.title- noch für die snippet.categoryId-Eigenschaft ein Wert festgelegt wird.
forbidden (403) forbidden Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403) forbiddenEmbedSetting Bei der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Einige Kanäle haben möglicherweise keine Berechtigung, eingebettete Player für Livestreams anzubieten. Weitere Informationen findest du in der YouTube-Hilfe.
forbidden (403) forbiddenLicenseSetting Bei der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting Bei der Anfrage 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 den Wert des Felds id im Anfragetext, um sicherzustellen, dass er 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 enthielt einen unerwarteten Wert für den Parameter rating.
badRequest (400) videoPurchaseRequired Videos, die du dir ausgeliehen hast, können nur von dir bewertet werden.
forbidden (403) forbidden Das Video, das Sie bewerten möchten, 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 Bewertungen für dieses Video deaktiviert.
notFound (404) videoNotFound Das Video, das du bewerten möchtest, wurde nicht gefunden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

videos.reportAbuse

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidAbuseReason Die Anfrage enthielt einen unerwarteten Wert für das Feld reason_id oder eine Kombination aus den Feldern reason_id und secondary_reason_id.
badRequest (400) rateLimitExceeded Der Nutzer hat innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet.
forbidden (403) forbidden
notFound (404) videoNotFound Das Video, für das du einen Missbrauch melden möchtest, konnte nicht gefunden werden.

Wasserzeichen

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe im Zusammenhang mit watermarks-Ressourcen zurückgibt. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Fehler bei Anfragen aufgeführt sind.

watermarks.set

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) imageFormatUnsupported Das von Ihnen bereitgestellte Bild hat ein nicht unterstütztes Format.
badRequest (400) imageTooTall Das von Ihnen bereitgestellte Bild ist zu hoch.
badRequest (400) imageTooWide Das von Ihnen bereitgestellte Bild ist zu breit.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Bildinhalte.
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 auf einen ungültigen Wert festgelegt.

watermarks.unset

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Das Wasserzeichen kann für den angegebenen Kanal nicht deaktiviert werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert oder der Parameter channelId ist auf einen ungültigen Wert festgelegt.