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. Eine Liste der Fehler für eine bestimmte Methode finden Sie auch in der Referenzdokumentation für diese Methode.

Allgemeine Fehler

In den folgenden Tabellen sind 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 richtig 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 werden mindestens zwei Parameter angegeben, die nicht in derselben Anfrage verwendet werden können.
badRequest (400) invalidFilters In der Anfrage wird ein ungültiger Filterparameter angegeben.
badRequest (400) invalidPageToken In der Anfrage wird 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 wurde geschlossen. Wenn der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das letztere.
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 letztere.
forbidden (403) authenticatedUserNotChannel Für diese Anfrage muss der authentifizierte Nutzer zu einem Kanal aufgelöst werden, was jedoch nicht der Fall ist. 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 Channel 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 die erforderlichen Berechtigungen.
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 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. Entfernen Sie entweder den Parameter mine, authentifizieren Sie sich als YouTube-Nutzer, indem Sie den Parameter onBehalfOfContentOwner entfernen, oder geben Sie den Parameter onBehalfOfContentOwnerChannel an, sofern er für die aufgerufene Methode verfügbar ist, um als einer der Kanäle des Partners zu agieren.
badRequest (400) invalidPart Im Parameter part der Anfrage werden einige Teile angegeben, 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 In der Anfrage wird der Parameter mine verwendet, sie ist aber nicht richtig autorisiert.
unauthorized (401) youtubeSignupRequired Dieser Fehler weist darauf hin, dass der Nutzer ein nicht verknüpftes Google-Konto hat. Das bedeutet, dass er ein Google-Konto, aber keinen YouTube-Kanal hat. Solche 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. Um ein Video hochladen zu können, benötigt der Nutzer beispielsweise einen YouTube-Kanal. Ein Nutzer mit einem Gmail-Konto oder einem Android-Gerät hat mit Sicherheit ein Google-Konto, hat dieses Google-Konto aber möglicherweise noch nicht mit einem YouTube-Kanal verknüpft.

Dieser Fehler tritt häufig auf, wenn Sie versuchen, den OAuth 2.0-Dienstkontoablauf zu verwenden. YouTube unterstützt keine Dienstkonten. Wenn Sie versuchen, sich mit einem Dienstkonto zu authentifizieren, erhalten Sie diesen Fehler.

Im YouTube API-Blogpost, in dem die Unterstützung von Google-Konten eingeführt wird, wird der Fehler youtubeSignupRequired ebenfalls genauer beschrieben. Im Blogbeitrag wird der Fehler für API-Version 2.1 erläutert, die Bedeutung des Fehlers ist jedoch weiterhin gültig.

Aktivitäten

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit activities-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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 richtig autorisiert.
notFound (404) channelNotFound Die Kanal-ID, die durch den channelId-Parameter der Anfrage angegeben wird, wurde nicht gefunden.
notFound (404) homeChannelNotFound Für den aktuell authentifizierten Nutzer wurde kein YouTube-Startseitenfeed gefunden.
unauthorized (401) authorizationRequired In der Anfrage wird der Parameter home verwendet, sie ist aber nicht richtig autorisiert.

captions

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit captions-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

captions.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertitel-Track zu löschen. Die Anfrage ist möglicherweise nicht richtig autorisiert.
notFound (404) captionNotFound Der Untertiteltrack konnte nicht gefunden werden. Prüfen Sie 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 Untertitel-Track herunterzuladen. Die Anfrage ist möglicherweise nicht richtig autorisiert.
invalidValue (400) couldNotConvert Die Untertitel-Track-Daten konnten nicht in die angeforderte Sprache und/oder das angeforderte Format konvertiert werden. Prüfe, ob die angeforderten Werte für tfmt und tlang gültig sind und ob die snippet.status des angeforderten Untertitel-Tracks nicht failed ist.
notFound (404) captionNotFound Der Untertiteltrack konnte nicht gefunden werden. Prüfen Sie 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 nicht die Inhalte des Untertitel-Tracks.
conflict (409) captionExists Für das angegebene Video ist bereits ein Untertitel-Track mit den angegebenen snippet.language und snippet.name vorhanden. Ein Video kann mehrere Untertitel-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 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 nicht aus, um den Untertitel-Track hochzuladen. Die Anfrage ist möglicherweise nicht richtig 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 Eigenschaften snippet.language, snippet.name und snippet.videoId angegeben sind. Das Attribut snippet.isDraft kann auch angegeben werden, ist aber nicht erforderlich.
notFound (404) videoNotFound Das Video, das durch den Parameter videoId angegeben wird, konnte nicht gefunden werden.
invalidValue (400) nameTooLong Der 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 Ein oder mehrere Untertitel-Tracks konnten nicht abgerufen werden, da die mit der Anfrage verknüpften Berechtigungen nicht ausreichen, um die angeforderten Ressourcen abzurufen. Die Anfrage ist möglicherweise nicht richtig 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 Untertitel-Track-IDs, die nicht vorhanden sind, oder Track-IDs, die mit anderen Videos verknüpft sind, identifiziert. Prüfen Sie die Werte der Parameter id und videoId der Anfrage, um sicherzustellen, dass sie korrekt sind.
notFound (404) videoNotFound Das Video, das durch den Parameter videoId angegeben wird, konnte nicht gefunden werden.

captions.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Mit der Anfrage wurde keine aktualisierte Untertiteldatei hochgeladen. Die tatsächlichen Trackinhalte sind erforderlich, wenn der Parameter sync auf true festgelegt ist.
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertitel-Track zu aktualisieren. Die Anfrage ist möglicherweise nicht richtig autorisiert.
notFound (404) captionNotFound Der angegebene Untertiteltrack wurde nicht gefunden. Prüfen Sie den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

channelBanners

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit channelBanners-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

channelBanners.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) bannerAlbumFull Dein Album mit YouTube-Kanalbildern enthält zu viele Bilder. Rufen Sie http://photos.google.com auf, gehen Sie zur Seite „Alben“ und entfernen Sie einige Bilder aus dem Album.
badRequest (400) mediaBodyRequired Die Anfrage enthält nicht den Bildinhalt.

channelSections

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit channelSections-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

channelSections.delete

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) notEditable Dieser Kanalabschnitt 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 Die Property id gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) idRequired Für das Attribut id muss ein Wert angegeben werden, der den zu löschenden Kanalabschnitt 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 Ressource channelSection muss festgelegt sein, damit das Objekt localizations für diese Ressource eingefügt oder aktualisiert werden kann.
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 sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) notEditable Dieser Kanalabschnitt 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. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) targetInvalidLanguage Einer der Werte in der Liste targeting.languages konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) targetInvalidRegion Einer der Werte in der Liste targeting.regions konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource 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 Channels ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, weil sie doppelte Channels enthält.
invalidValue (400) channelsNeeded Wenn das Attribut snippet.type den Wert multipleChannels hat, muss das Attribut contentDetails.channels[] angegeben werden und mindestens einen Channel enthalten.
invalidValue (400) channelsNotExpected In der mit der Anfrage bereitgestellten Ressource wurde ein Wert für die Property contentDetails.channels[] angegeben, aber für diesen Typ von Channelabschnitt sind keine Channels vorgesehen.
invalidValue (400) contentDetailsNeeded Die einzufügende Ressource muss für diesen Typ von Kanalabschnitt ein contentDetails-Objekt 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 maximal zulässige Anzahl an Kanalabschnitten hat.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalbereich aufzunehmen.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalbereich aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn das Attribut snippet.type den Wert singlePlaylist hat, muss für das Attribut contentDetails.playlists[] genau eine Playlist angegeben werden.
invalidValue (400) ownChannelInChannels Du kannst deinen eigenen Kanal nicht in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Eine oder mehrere der angegebenen Playlists sind privat und können daher nicht in den Kanalabschnitt 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 wurde ein Wert für die Property contentDetails.playlists[] angegeben, aber für diesen Typ von Kanalabschnitt sind keine Playlists vorgesehen.
invalidValue (400) snippetNeeded Sie müssen ein snippet angeben, um den Kanalabschnitt 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 Channels wurde nicht gefunden.
notFound (404) playlistNotFound Mindestens eine der angegebenen Playlists konnte nicht gefunden werden.

channelSections.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) channelSectionForbidden Der Anfragesteller ist nicht berechtigt, auf die angeforderten Channelabschnitte zuzugreifen.
invalidValue (400) idInvalid In der Anfrage wird eine ungültige ID für einen Kanalabschnitt 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 festgelegt sein, damit das Objekt localizations für diese Ressource eingefügt oder aktualisiert werden kann.
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 sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) notEditable Dieser Kanalabschnitt 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. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) targetInvalidLanguage Einer der Werte in der Liste targeting.languages konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource zu aktualisieren.
badRequest (400) targetInvalidRegion Einer der Werte in der Liste targeting.regions konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und sie gemäß den Richtlinien in der Dokumentation zur a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressource 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 Channels ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, weil sie doppelte Channels enthält.
invalidValue (400) channelsNeeded Wenn das Attribut snippet.type den Wert multipleChannels hat, muss das Attribut contentDetails.channels[] angegeben werden und mindestens einen Channel enthalten.
invalidValue (400) channelsNotExpected In der mit der Anfrage bereitgestellten Ressource wurde ein Wert für die Property contentDetails.channels[] angegeben, aber für diesen Typ von Channelabschnitt sind keine Channels vorgesehen.
invalidValue (400) contentDetailsNeeded Die Ressource, die Sie aktualisieren, muss ein contentDetails-Objekt für diesen Typ von Kanalabschnitt enthalten.
invalidValue (400) idInvalid Die Property id gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) idRequired Mit der Property id muss ein Wert angegeben werden, der den zu aktualisierenden Kanalabschnitt identifiziert.
invalidValue (400) inValidPosition Die Property snippet.position enthält einen ungültigen Wert.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalbereich aufzunehmen.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalbereich aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn das Attribut snippet.type den Wert singlePlaylist hat, muss für das Attribut contentDetails.playlists[] genau eine Playlist angegeben werden.
invalidValue (400) ownChannelInChannels Du kannst deinen eigenen Kanal nicht in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Eine oder mehrere der angegebenen Playlists sind privat und können daher nicht in den Kanalabschnitt 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 wurde ein Wert für die Property contentDetails.playlists[] angegeben, aber für diesen Typ von Kanalabschnitt sind keine Playlists vorgesehen.
invalidValue (400) snippetNeeded Sie müssen eine snippet angeben, um den Kanalabschnitt 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 Channels wurde nicht gefunden.
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 von der API als Reaktion auf Aufrufe im Zusammenhang mit channels-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

channels.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidCriteria Es darf maximal einer der folgenden Filter angegeben werden:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Bei der Authentifizierung des Rechteinhabers mit dem Parameter onBehalfOfContentOwner darf nur id oder managedByMe angegeben werden.
forbidden (403) channelForbidden Der durch den Parameter id angegebene Channel unterstützt die Anfrage nicht oder die Anfrage ist nicht richtig autorisiert.
notFound (404) categoryNotFound Die durch den Parameter categoryId angegebene Kategorie wurde nicht gefunden.
notFound (404) channelNotFound Der im Parameter id angegebene Channel wurde nicht gefunden.

channels.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) brandingValidationError Einer der Werte im brandingSettings-Objekt konnte nicht validiert werden. Verwenden Sie die Methode channels.list, um die vorhandenen Einstellungen für den Kanal abzurufen, und aktualisieren Sie die Attributwerte gemäß den Richtlinien in der Dokumentation zur Ressource channels.
badRequest (400) channelTitleUpdateForbidden Wenn Sie das brandingSettings part eines Channels aktualisieren, müssen Sie den Wert der Property brandingSettings.channel.title auf den aktuellen Titel des Channels 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 eingestellt sein, 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 aktualisieren Sie sie gemäß den Richtlinien in der Dokumentation zur channels-Ressource.
badRequest (400) invalidCustomMessage Die Metadaten der Anfrage enthalten eine ungültige benutzerdefinierte Nachricht. Prüfen Sie den Wert des Attributs invideoPromotion.items[].customMessage in der Ressource, die mit der Anfrage gesendet wurde.
badRequest (400) invalidDuration Die Metadaten der Anfrage geben im Teil „invideoPromotion“ eine ungültige Dauer an.
badRequest (400) invalidDuration In den Metadaten der Anfrage ist ein ungültiger Positionstyp angegeben, der bestimmt, wie das beworbene Element im Videoplayer positioniert wird. Prüfen Sie den Wert des Attributs invideoPromotion.position.type in der Ressource, die mit der Anfrage gesendet wurde.
badRequest (400) invalidRecentlyUploadedBy In den Metadaten der Anfrage ist eine ungültige Channel-ID angegeben. Prüfen Sie den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, die mit der Anfrage gesendet wurde.
badRequest (400) invalidTimingOffset Die Metadaten der Anfrage enthalten einen ungültigen Timing-Offset im Teil „invideoPromotion“.
badRequest (400) invalidTimingOffset In den Metadaten der Anfrage wird ein ungültiger Timing-Offset angegeben, um festzulegen, wann der beworbene Artikel im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, die mit der Anfrage gesendet wurde.
badRequest (400) invalidTimingType In den Metadaten der Anfrage wird eine ungültige Timing-Methode angegeben, um zu bestimmen, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource, die mit der Anfrage gesendet wurde.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Verwenden Sie die Methode channels.list, um gültige Werte abzurufen, und aktualisieren Sie sie gemäß den Richtlinien in der Dokumentation zur Channels-Ressource.
badRequest (400) tooManyPromotedItems Die zulässige Anzahl beworbener Artikel im Teil „invideoPromotion“ wurde überschritten.
forbidden (403) channelForbidden Der im Parameter id angegebene Channel unterstützt die Anfrage nicht oder die Anfrage ist nicht richtig autorisiert.
forbidden (403) promotedVideoNotAllowed Der Kanal, der mit der API-Anfrage aktualisiert werden soll, wurde nicht gefunden. Prüfen Sie den Wert der Eigenschaft id in der Ressource channel, an die die 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 wurde nicht gefunden oder hat keine Branding-Optionen.
notFound (404) channelNotFound Der im Parameter id angegebene Channel wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Channel-ID wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Kanal-ID für „recentlyUploadedBy“ wurde nicht gefunden.
notFound (404) unknownVideoId Die als beworbenes Element angegebene Video-ID wurde nicht gefunden.
required (400) requiredItemIdType In den Anfragemetadaten muss im Teil „invideoPromotion“ ein Elementtyp angegeben werden.
required (400) requiredItemId In den Anfragemetadaten muss ein Element im Teil „invideoPromotion“ angegeben werden.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein standardmäßiger Timing-Offset angegeben werden, damit YouTube feststellen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.offsetMs in der Ressource fest, die mit der Anfrage gesendet wird.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein Zeitversatz angegeben werden, damit YouTube feststellen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die mit der Anfrage gesendet wird.
required (400) requiredTimingType In den Anfragemetadaten muss eine Timing-Methode angegeben werden, damit YouTube feststellen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die mit der Anfrage gesendet wird.
required (400) requiredTimingType In den Anfragemetadaten muss eine Timing-Methode angegeben werden, damit YouTube feststellen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die mit der Anfrage gesendet wird.
required (400) requiredTiming In den Anfragemetadaten muss für jedes Element im invideoPromotion-Teil ein Timing angegeben werden.
required (400) requiredVideoId In den Anfragemetadaten muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren.
required (400) requiredWebsiteUrl In den Metadaten der Anfrage muss im Teil „invideoPromotion“ eine Website-URL angegeben werden. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die mit der Anfrage gesendet wird.

commentThreads

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit commentThreads-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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 erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet 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 Bei dem Video, das durch den Parameter videoId angegeben wird, sind Kommentare deaktiviert.
forbidden (403) forbidden Mindestens einer der angeforderten Kommentar-Threads kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht richtig autorisiert.
notFound (404) channelNotFound Der mit dem Parameter allThreadsRelatedToChannelId angegebene Channel konnte nicht gefunden werden.
notFound (404) commentThreadNotFound Mindestens einer der angegebenen Kommentar-Threads konnte nicht gefunden werden. Prüfen Sie die Werte des Parameters id der Anfrage, um sicherzustellen, dass sie korrekt sind.
notFound (404) videoNotFound Das Video, das durch den Parameter videoId angegeben wird, konnte nicht gefunden werden.

commentThreads.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelOrVideoIdMissing Jeder Kommentarbereich 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 Videowiedergabeseite angezeigt.
badRequest (400) commentTextRequired Für die comment-Ressource, die eingefügt wird, muss ein Wert für das Attribut snippet.topLevelComment.snippet.textOriginal angegeben werden. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die comment-Ressource, die eingefügt wird, enthält zu viele Zeichen in der Property snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet 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 richtig autorisiert.
forbidden (403) ineligibleAccount Das YouTube-Konto, das zum Autorisieren der API-Anfrage verwendet wird, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentar-Thread einzufügen.
notFound (404) channelNotFound Der angegebene Channel wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.channelId korrekt ist.
notFound (404) videoNotFound Das angegebene Video wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.videoId korrekt ist.

Kommentare

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit comments-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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 richtig autorisiert.
notFound (404) commentNotFound Mindestens einer der angegebenen Kommentare wurde nicht gefunden. Prüfen Sie die Werte der Parameter id und parentId der Anfrage, um sicherzustellen, dass sie 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 erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist.
forbidden (403) forbidden Der Moderationsstatus von mindestens einem Kommentar kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht richtig autorisiert.
notFound (404) commentNotFound Einer oder mehrere der Kommentare, die mit der Anfrage aktualisiert werden sollen, wurden nicht gefunden. Prüfen Sie die Werte des Parameters id der Anfrage, um sicherzustellen, dass sie korrekt sind.

comments.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Für die comment-Ressource, die eingefügt wird, muss ein Wert für das Attribut snippet.textOriginal angegeben werden. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die comment-Ressource, die eingefügt wird, enthält zu viele Zeichen in der Property snippet.textOriginal.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Der API-Nutzer kann keinen Kommentar als Antwort auf den Kommentar der obersten Ebene einfügen, der durch das Attribut snippet.parentId identifiziert 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. In der comment-Ressource im Text der API-Anfrage wurde jedoch kein Wert für die snippet.parentId-Eigenschaft angegeben.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet 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 richtig autorisiert.
forbidden (403) ineligibleAccount Das YouTube-Konto, das zum Autorisieren der API-Anfrage verwendet wird, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentar-Thread einzufügen.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfen Sie den Wert der Eigenschaft snippet.parentId im Anfragetext, um sicherzustellen, dass er korrekt ist.

comments.delete

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet 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 richtig autorisiert.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfen Sie den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

comments.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextTooLong Die comment-Ressource, die aktualisiert wird, enthält zu viele Zeichen in der Property snippet.textOriginal.
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 erfolgreich verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, deutet 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 richtig autorisiert.
forbidden (403) ineligibleAccount Das YouTube-Konto, das zum Autorisieren der API-Anfrage verwendet wird, muss mit dem Google-Konto des Nutzers verknüpft sein, um einen Kommentar oder Kommentarbereich zu aktualisieren.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfen Sie den Wert der Eigenschaft id im Anfragetext, um sicherzustellen, dass er korrekt ist.

Mitglieder

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit members-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

members.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Auf dem Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert.
badRequest (400) invalidMode Der Wert des Parameters „mode“ ist ungültig. Dieser Fehler kann auftreten, wenn mit dem Parameter pageToken ein Token angegeben wird, das mit einem anderen Modus als dem angegebenen abgerufen wurde.
badRequest (400) invalidPageToken Der Wert des Parameters pageToken ist ungültig. Dieser Fehler tritt auf, wenn das im Antrag 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 der Parameterwert filterByMemberChannelId mehr als 100 Channels angibt.

membershipsLevels

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit members-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

membershipsLevels.list

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

playlistItems

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit playlistItems-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

playlistItems.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht ordnungsgemäß autorisiert, um das angegebene Playlist-Element zu löschen.
notFound (404) playlistItemNotFound Das mit dem id-Parameter der Anfrage identifizierte Playlist-Element 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 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 an Elementen.
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht ordnungsgemäß autorisiert, um das angegebene Playlist-Element einzufügen.
invalidValue (400) invalidContentDetails Die Property contentDetails in der Anfrage ist ungültig. Ein möglicher Grund ist, dass das Feld contentDetails.note länger als 280 Zeichen ist.
invalidValue (400) invalidPlaylistItemPosition In 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 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 Playlisteneintrags festzulegen, aber für die Playlist wird keine manuelle Sortierung verwendet. (Playlist-Elemente können z. B. nach Datum oder Beliebtheit sortiert werden.) Sie können den Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die mit der Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, müssen Sie zuerst die Option Sortierung der Playlist in den Einstellungen der Playlist auf Manuell aktualisieren. 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. So kannst du zum Beispiel kein Video in die Playlist „Hochgeladene Videos“ einfügen.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, konnte nicht gefunden werden.
notFound (404) videoNotFound Das Video, das du der Playlist hinzufügen möchtest, wurde nicht gefunden. Prüfen Sie den Wert des Attributs videoId, um sicherzustellen, dass er 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 ordnungsgemäß autorisiert, um die angegebene Playlist abzurufen.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, konnte nicht gefunden werden.
notFound (404) videoNotFound Das Video, das mit dem Parameter videoId der Anfrage identifiziert wurde, konnte nicht gefunden werden.
required (400) playlistIdRequired In der Aboanfrage ist kein Wert für die erforderliche Property playlistId angegeben.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Möglichkeit, Videos in der angegebenen Playlist aufzulisten. Du kannst beispielsweise kein Video in deiner Playlist „Später ansehen“ auflisten.

playlistItems.update

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht ordnungsgemäß autorisiert, um das angegebene Playlist-Element zu aktualisieren.
invalidValue (400) invalidPlaylistItemPosition In 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 gibt das Element an, das der Playlist hinzugefügt wird, z. B. youtube#video.
invalidValue (400) invalidSnippet In der Anfrage wird keine gültige snippet-Property angegeben.
invalidValue (400) manualSortRequired In der Anfrage wird versucht, die Position des Playlisteneintrags festzulegen, aber für die Playlist wird keine manuelle Sortierung verwendet. (Playlist-Elemente können z. B. nach Datum oder Beliebtheit sortiert werden.) Sie können den Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die mit der Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, müssen Sie zuerst die Option Sortierung der Playlist in den Einstellungen der Playlist auf Manuell aktualisieren. Diese Einstellungen können im YouTube-Video-Manager angepasst werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Aktualisieren von Videos in der angegebenen Playlist nicht. Du kannst beispielsweise kein Video in der Playlist „Hochgeladene Videos“ aktualisieren.
notFound (404) playlistItemNotFound Das mit der id-Eigenschaft der Anfrage identifizierte Playlist-Element wurde nicht gefunden.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, konnte 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 In der im Antrag angegebenen Playlist-Item-Ressource muss das id-Attribut verwendet werden, um das zu aktualisierende Playlist-Item zu identifizieren.

Playlists

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit playlists-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

playlists.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistForbidden Dieser Vorgang ist verboten oder die Anfrage ist nicht richtig autorisiert.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, konnte 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 richtig autorisiert.
notFound (404) channelNotFound Der im Parameter channelId angegebene Channel wurde nicht gefunden.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, konnte nicht gefunden werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Möglichkeit, die angegebene Playlist aufzulisten. Du kannst beispielsweise nicht deine Playlist „Später ansehen“ aufrufen.

playlists.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so eingestellt sein, dass localizations aktualisiert wird.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Verwende die Methode playlists.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Dokumentation zur Playlists-Ressource.
badRequest (400) maxPlaylistExceeded Die Playlist kann nicht erstellt werden, da der Kanal bereits die maximal zulässige Anzahl an Playlists enthält.
forbidden (403) playlistForbidden Dieser Vorgang ist verboten oder die Anfrage ist nicht richtig autorisiert.
invalidValue (400) invalidPlaylistSnippet Die Anfrage enthält einen ungültigen Playlist-Snippet.
required (400) playlistTitleRequired In der Anfrage muss ein Playlist-Titel angegeben werden.

playlists.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so eingestellt sein, dass localizations aktualisiert wird.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Verwende die Methode playlists.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Dokumentation zur Playlists-Ressource.
forbidden (403) playlistForbidden Dieser Vorgang ist verboten oder die Anfrage ist nicht richtig autorisiert.
invalidValue (400) invalidPlaylistSnippet Die Anfrage enthält einen ungültigen Playlist-Snippet.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Aktualisieren der angegebenen Playlist nicht. So können Sie beispielsweise die Eigenschaften der Playlist mit Ihren hochgeladenen Videos nicht aktualisieren.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, konnte 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 von der API als Reaktion auf Aufrufe im Zusammenhang mit subscriptions-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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üfen Sie 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 an Abos erreicht.
badRequest (400) subscriptionForbidden Vorläufiges Abolimit erreicht. Versuche es bitte in ein paar Stunden erneut.
badRequest (400) subscriptionForbidden Das Abonnieren des 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 Ressource, die durch die snippet.resourceId-Eigenschaft der Anfrage angegeben wird, wurde nicht gefunden.
notFound (404) subscriberNotFound Der mit der Anfrage identifizierte Abonnent wurde nicht gefunden.
required (400) publisherRequired In der im Antrag angegebenen Abo-Ressource muss das Attribut snippet.resourceId verwendet werden, um den Kanal zu identifizieren, der abonniert wird.

subscriptions.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) accountClosed Abos konnten nicht abgerufen werden, da das Konto des Abonnenten geschlossen wurde.
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 identifizierte Abonnent wurde nicht gefunden.

Miniaturansichten

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit thumbnails-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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 Die Miniaturansicht kann für das angegebene Video nicht festgelegt werden. Die Anfrage ist möglicherweise nicht richtig autorisiert.
forbidden (403) forbidden Der authentifizierte Nutzer hat keine Berechtigung zum Hochladen und Festlegen benutzerdefinierter Videominiaturen.
notFound (404) videoNotFound Das Video, für das Sie ein Thumbnail-Bild einfügen möchten, wurde nicht gefunden. Prüfen Sie 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. Wiederholen Sie die Anfrage später.

videoAbuseReportReasons

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit videoAbuseReportReasons-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

videoAbuseReportReasons.list

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

videoCategories

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit videoCategories-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

videoCategories.list

Fehlertyp Fehlerdetails Beschreibung
notFound (404) videoCategoryNotFound Die mit dem Parameter id angegebene Videokategorie wurde nicht gefunden. Mit der Methode videoCategories.list können Sie eine Liste der gültigen Werte abrufen.

Videos

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit videos-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler aufgeführt sind.

videos.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Mit der Anfrage wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Für die Property snippet.categoryId wurde eine ungültige Kategorie-ID angegeben. 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 Videodateiname ist ungültig.
badRequest (400) invalidPublishAt In den Metadaten der Anfrage ist eine ungültige geplante Veröffentlichungszeit angegeben.
badRequest (400) invalidRecordingDetails Das recordingDetails-Objekt in den Metadaten der Anfrage enthält ungültige Aufnahmedetails.
badRequest (400) invalidTags Die Metadaten der Anfrage enthalten ungültige Videokeywords.
badRequest (400) invalidTitle In den Metadaten der Anfrage ist ein ungültiger oder leerer Videotitel angegeben.
badRequest (400) invalidVideoGameRating Die Metadaten der Anfrage enthalten eine ungültige Altersfreigabe für Videospiele.
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 kein Wert für die Eigenschaften snippet.title und snippet.categoryId festgelegt wird.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Videoinhalte.
badRequest (400) uploadLimitExceeded Der Nutzer hat die maximale Anzahl an Videos überschritten, die er hochladen darf.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting In der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting In 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 Die Anfrage ist nicht ordnungsgemäß autorisiert, um auf die Videodatei oder Verarbeitungsinformationen zuzugreifen. Die Abschnitte fileDetails, processingDetails und suggestions sind nur für den Eigentümer des Videos verfügbar.
forbidden (403) forbidden Mit der Anfrage kann nicht auf Informationen zu Nutzerbewertungen zugegriffen werden. Dieser Fehler kann auftreten, weil die Anfrage nicht ordnungsgemäß autorisiert ist, den Parameter myRating zu verwenden.
notFound (404) videoNotFound Das Video, das Sie abrufen möchten, wurde nicht gefunden. Prüfen Sie 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 richtig autorisiert.
notFound (404) videoNotFound Das Video, das Sie löschen möchten, wurde nicht gefunden. Prüfen Sie den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

videos.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Mit der API-Anfrage wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Für die Property snippet.categoryId wurde eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDefaultBroadcastPrivacySetting Mit 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 In den Metadaten der Anfrage ist eine ungültige geplante Veröffentlichungszeit angegeben.
badRequest (400) invalidRecordingDetails Das recordingDetails-Objekt in den Metadaten der Anfrage enthält ungültige Aufnahmedetails.
badRequest (400) invalidTags Die Metadaten der Anfrage enthalten ungültige Videokeywords.
badRequest (400) invalidTitle In den Metadaten der Anfrage 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 kein Wert für die Eigenschaften snippet.title und snippet.categoryId festgelegt wird.
forbidden (403) forbidden Zugriff unzulässig: Die Anfrage ist möglicherweise nicht richtig autorisiert.
forbidden (403) forbiddenEmbedSetting In 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 In der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting In der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen.
notFound (404) videoNotFound Das Video, das Sie aktualisieren möchten, 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 seine E‑Mail-Adresse bestätigen, bevor er eine Rezension schreiben kann.
badRequest (400) invalidRating Die Anfrage enthielt 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 richtig 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 Sie bewerten möchten, wurde nicht gefunden. Prüfen Sie 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 der Felder 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 Sie Missbrauch melden möchten, wurde nicht gefunden.

Wasserzeichen

In den folgenden Tabellen sind die Fehlermeldungen aufgeführt, die von der API als Reaktion auf Aufrufe im Zusammenhang mit watermarks-Ressourcen zurückgegeben werden. Diese Methoden können auch Fehler zurückgeben, die im Abschnitt Häufige Anforderungsfehler 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 nicht den Bildinhalt.
forbidden (403) forbidden Das Wasserzeichen kann für den angegebenen Kanal nicht festgelegt werden. Die Anfrage ist möglicherweise nicht richtig 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 entfernt werden. Die Anfrage ist möglicherweise nicht richtig autorisiert oder der Parameter channelId ist auf einen ungültigen Wert festgelegt.