YouTube Data API - Errors

In diesem Dokument werden die verschiedenen Fehlertypen beschrieben, die YouTube Data API-Vorgänge zurückgeben können. Außerdem finden Sie in der Referenzdokumentation für die jeweilige Methode eine Liste der Fehler für jede einzelne Methode.

Allgemeine Fehler

In den folgenden Tabellen sind API-Fehlermeldungen aufgeführt, die nicht spezifisch für eine bestimmte API-Methode 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 mindestens zwei Parameter angegeben, die nicht in derselben Anfrage verwendet werden können.
badRequest (400) invalidFilters Die Anfrage enthält einen ungültigen Filterparameter.
badRequest (400) invalidPageToken In der Anfrage ist ein ungültiges Seitentoken angegeben.
badRequest (400) missingRequiredParameter In der Anfrage fehlt ein erforderlicher Parameter.
badRequest (400) unexpectedParameter In der Anfrage ist ein unerwarteter Parameter angegeben.
forbidden (403) accountDelegationForbidden Der authentifizierte Nutzer kann nicht im Namen des angegebenen Google-Kontos handeln.
forbidden (403) authenticatedUserAccountClosed Das YouTube-Konto des authentifizierten Nutzers wurde geschlossen. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Google-Konto.
forbidden (403) authenticatedUserAccountSuspended Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Google-Konto.
forbidden (403) authenticatedUserNotChannel Bei dieser Anfrage muss der authentifizierte Nutzer einem Kanal zugeordnet werden. Dies tut dies jedoch nicht. Wenn Ihre Anfrage authentifiziert ist und den Delegationsparameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen.
forbidden (403) channelClosed Der in der Anfrage angegebene Kanal wurde geschlossen.
forbidden (403) channelNotFound Der in der Anfrage angegebene Kanal wurde nicht gefunden.
forbidden (403) channelSuspended Der im Antrag angegebene Kanal wurde gesperrt.
forbidden (403) cmsUserAccountNotFound Der CMS-Nutzer ist nicht berechtigt, im Namen des angegebenen Rechteinhabers zu handeln.
forbidden (403) insufficientCapabilities Die Berechtigungen des CMS-Nutzers reichen nicht aus.
forbidden (403) insufficientPermissions Das für die Anfrage bereitgestellte OAuth 2.0-Token gibt die Bereiche an, die nicht ausreichen, um auf die angeforderten Daten zuzugreifen.
notFound (404) contentOwnerAccountNotFound Das angegebene Rechteinhaber-Konto 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. Du solltest entweder den mine-Parameter entfernen, dich durch Entfernen des onBehalfOfContentOwner-Parameters als YouTube-Nutzer authentifizieren oder als einer der Kanäle des Partners agieren, indem du den Parameter onBehalfOfContentOwnerChannel bereitstellst, sofern dieser 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 gibt einen unerwarteten Wert an.
badRequest (400) unknownPart Der Parameter part der Anfrage gibt einen unbekannten Wert an.
badRequest (400) unsupportedLanguageCode Der Parameterwert hl gibt keinen unterstützten Sprachcode an.
badRequest (400) unsupportedRegionCode Der Parameter regionCode gibt einen nicht unterstützten Regionscode an.
unauthorized (401) authorizationRequired Die Anfrage verwendet den Parameter mine, ist aber nicht korrekt autorisiert.
unauthorized (401) youtubeSignupRequired Dieser Fehler weist darauf hin, dass der Nutzer ein nicht verknüpftes Google-Konto hat, also ein Google-Konto, aber keinen YouTube-Kanal hat. Diese Nutzer haben Zugriff auf viele Funktionen, die von der Nutzerautorisierung abhängen, wie etwa das Bewerten von Videos oder das Hinzufügen von Videos zu einer watch_later-Playlist. Zum Beispiel benötigt der Nutzer jedoch einen YouTube-Kanal, um ein Video hochladen zu können. Ein Nutzer mit einem Gmail-Konto oder einem Android-Gerät hat mit Sicherheit ein Google-Konto, hat dieses Konto aber noch nicht mit einem YouTube-Kanal verknüpft.

Dieser Fehler tritt häufig auf, wenn du versuchst, den OAuth 2.0-Dienstkonto-Vorgang zu verwenden. YouTube unterstützt keine Dienstkonten. Wenn du versuchst, dich mit einem Dienstkonto zu authentifizieren, wird dir diese Fehlermeldung angezeigt.

Im YouTube API-Blogpost, in dem der Support für Google-Konten eingeführt wird, wird auch der Fehler youtubeSignupRequired ausführlicher behandelt. Im Blogbeitrag wird zwar der Fehler für die API-Version 2.1 erläutert, die Bedeutung des Fehlers ist aber dennoch anwendbar.

Aktivitäten

YouTube hat die Funktion für Kanalbulletins eingestellt. Die Methode activities.insert wird nicht mehr unterstützt.

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von activities-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

activities.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) homeParameterDeprecated Die Aktivitätsdaten des Nutzers auf der Startseite sind über diese API nicht verfügbar. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true gesetzt haben.
forbidden (403) forbidden Die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) channelNotFound Die durch den Parameter channelId der Anfrage identifizierte Kanal-ID wurde nicht gefunden.
notFound (404) homeChannelNotFound Für den derzeit authentifizierten Nutzer wurde kein Feed auf der YouTube-Startseite gefunden.
unauthorized (401) authorizationRequired Die Anfrage verwendet den Parameter home, ist aber nicht korrekt autorisiert.

captions

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von captions-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler 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 Untertitel-Track wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage korrekt ist.

captions.download

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack herunterzuladen. Möglicherweise wurde die Anfrage nicht ordnungsgemäß autorisiert oder in der Videobestellung wurden keine Beiträge Dritter für diese Untertitel aktiviert.
invalidValue (400) couldNotConvert Die Daten des Untertiteltracks konnten nicht in die angeforderte Sprache und/oder das angeforderte Format konvertiert werden. Prüfe, ob die angeforderten tfmt- und tlang-Werte gültig sind und dass die snippet.status des angeforderten Untertitel-Tracks nicht failed ist.
notFound (404) captionNotFound Der Untertitel-Track wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage korrekt ist.

captions.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Die Anfrage enthält nicht den Inhalt des Untertiteltracks.
conflict (409) captionExists Das angegebene Video hat 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önnten den vorhandenen Track löschen und dann einen neuen einfügen oder den Namen des neuen Tracks vor dem Einfügen ändern.
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 Tracks verhindern. Prüfen Sie, ob in der Anfrage gültige Werte für die Attribute snippet.language, snippet.name und snippet.videoId angegeben sind. Das Attribut snippet.isDraft kann ebenfalls angegeben werden, ist aber nicht erforderlich.
notFound (404) videoNotFound Das durch den Parameter videoId angegebene Video wurde nicht gefunden.
invalidValue (400) nameTooLong Der in der Anfrage angegebene snippet.name ist zu lang. Es sind maximal 150 Zeichen zulässig.

captions.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Mindestens ein Untertiteltrack konnte nicht abgerufen werden, da die mit der Anfrage verknüpften Berechtigungen nicht zum Abrufen der angeforderten Ressourcen ausreichen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) captionNotFound Mindestens einer der angegebenen Untertitel-Tracks wurde nicht gefunden. Dieser Fehler tritt auf, wenn der Parameter videoId ein echtes Video identifiziert, der Parameter id aber entweder nicht vorhandene Untertitel-Track-IDs oder Track-IDs, die mit anderen Videos verknüpft sind. Prüfen Sie, ob die Werte der Parameter id und videoId der Anfrage korrekt sind.
notFound (404) videoNotFound Das durch den Parameter videoId angegebene Video wurde nicht gefunden.

captions.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Bei der Anfrage wurde keine aktualisierte Untertiteldatei hochgeladen. Der tatsächliche Titelinhalt ist erforderlich, wenn der Parameter sync auf true gesetzt 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 wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage korrekt ist.

channelBanners

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von channelBanners-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

channelBanners.insert

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

channelSections

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von channelSections-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler 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 ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) idInvalid Die Eigenschaft id gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) idRequired Das Attribut id muss einen Wert angeben, der den zu löschenden Kanalabschnitt identifiziert.
notFound (404) channelNotFound Der Kanal wurde nicht gefunden.
notFound (404) channelSectionNotFound Der Kanalabschnitt, den du aktualisieren möchtest, kann nicht gefunden werden.

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 gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) notEditable Dieser Kanalabschnitt kann nicht erstellt werden.
badRequest (400) styleRequired Die Ressource channelSection muss einen Wert für das Feld snippet.style angeben.
badRequest (400) targetInvalidCountry Einer der Werte in der targeting.countries-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) targetInvalidLanguage Einer der Werte in der targeting.languages-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) targetInvalidRegion Einer der Werte in der targeting.regions-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) typeRequired Die Ressource channelSection muss einen Wert für das Feld snippet.type angeben.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) channelNotActive Mindestens einer der angegebenen Channels ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Kanäle angegeben wurden.
invalidValue (400) channelsNeeded Wenn das Attribut snippet.type den Wert multipleChannels hat, muss das Attribut contentDetails.channels[] angegeben und mindestens einen Kanal angegeben werden.
invalidValue (400) channelsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für das Attribut contentDetails.channels[] angegeben. Für diese Art von Kanalabschnitt werden jedoch keine Kanäle erwartet.
invalidValue (400) contentDetailsNeeded Die eingefügte Ressource muss für diese Art von Kanalabschnitt ein contentDetails-Objekt enthalten.
invalidValue (400) inValidPosition Das Attribut snippet.position enthält einen ungültigen Wert.
invalidValue (400) maxChannelSectionExceeded Die Anfrage kann nicht bearbeitet werden, da der Kanal bereits die maximal zulässige Anzahl von Kanalabschnitten hat.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle im Kanalabschnitt aufzunehmen.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists im Kanalabschnitt aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn die Eigenschaft snippet.type den Wert singlePlaylist hat, muss die Eigenschaft contentDetails.playlists[] genau eine Playlist angeben.
invalidValue (400) ownChannelInChannels Du kannst nicht deinen eigenen Kanal in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Mindestens eine der angegebenen Playlists ist privat und kann daher nicht in den Kanalabschnitt aufgenommen werden.
invalidValue (400) playlistsDuplicated Die Anfrage ist fehlgeschlagen, weil darin doppelte Playlists angegeben wurden.
invalidValue (400) playlistsNeeded Wenn das Attribut snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss das Attribut contentDetails.playlists[] angegeben werden.
invalidValue (400) playlistsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für die Eigenschaft contentDetails.playlists[] angegeben. Für diese Art von Kanalabschnitt werden jedoch keine Playlists erwartet.
invalidValue (400) snippetNeeded Sie müssen eine snippet angeben, um den Kanalabschnitt zu erstellen.
invalidValue (400) titleLengthExceeded Der Wert des Attributs snippet.title ist zu lang.
invalidValue (400) titleRequired Wenn das Attribut snippet.type den Wert multiplePlaylists oder multipleChannels hat, müssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert für das Attribut snippet.title angeben.
notFound (404) channelNotFound Mindestens einer der angegebenen Kanäle wurde nicht gefunden.
notFound (404) playlistNotFound Mindestens eine der angegebenen Playlists wurde nicht gefunden.

channelSections.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) channelSectionForbidden Der Antragsteller ist nicht berechtigt, auf die angeforderten Kanalabschnitte zuzugreifen.
invalidValue (400) idInvalid Die Anfrage gibt eine ungültige Kanalabschnitts-ID an.
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 gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) notEditable Dieser Kanalabschnitt kann nicht bearbeitet werden.
badRequest (400) styleRequired Die Ressource channelSection muss einen Wert für das Feld snippet.style angeben.
badRequest (400) targetInvalidCountry Einer der Werte in der targeting.countries-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) targetInvalidLanguage Einer der Werte in der targeting.languages-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) targetInvalidRegion Einer der Werte in der targeting.regions-Liste konnte nicht validiert werden. Verwenden Sie die Methode channelSections.list, um gültige Werte abzurufen und gemäß den Richtlinien in der a href="/youtube/v3/docs/channelSections#resource">channelSections-Ressourcendokumentation zu aktualisieren.
badRequest (400) typeRequired Die Ressource channelSection muss einen Wert für das Feld snippet.type angeben.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) channelNotActive Mindestens einer der angegebenen Channels ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Kanäle angegeben wurden.
invalidValue (400) channelsNeeded Wenn das Attribut snippet.type den Wert multipleChannels hat, muss das Attribut contentDetails.channels[] angegeben und mindestens einen Kanal angegeben werden.
invalidValue (400) channelsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für das Attribut contentDetails.channels[] angegeben. Für diese Art von Kanalabschnitt werden jedoch keine Kanäle erwartet.
invalidValue (400) contentDetailsNeeded Die Ressource, die Sie aktualisieren, muss für diese Art von Kanalabschnitt ein contentDetails-Objekt enthalten.
invalidValue (400) idInvalid Die Eigenschaft id gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) idRequired Das Attribut id muss einen Wert angeben, der den zu aktualisierenden Kanalabschnitt identifiziert.
invalidValue (400) inValidPosition Das Attribut snippet.position enthält einen ungültigen Wert.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle im Kanalabschnitt aufzunehmen.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists im Kanalabschnitt aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn die Eigenschaft snippet.type den Wert singlePlaylist hat, muss die Eigenschaft contentDetails.playlists[] genau eine Playlist angeben.
invalidValue (400) ownChannelInChannels Du kannst nicht deinen eigenen Kanal in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Mindestens eine der angegebenen Playlists ist privat und kann daher nicht in den Kanalabschnitt aufgenommen werden.
invalidValue (400) playlistsDuplicated Die Anfrage ist fehlgeschlagen, weil darin doppelte Playlists angegeben wurden.
invalidValue (400) playlistsNeeded Wenn das Attribut snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss das Attribut contentDetails.playlists[] angegeben werden.
invalidValue (400) playlistsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für die Eigenschaft contentDetails.playlists[] angegeben. Für diese Art von Kanalabschnitt werden jedoch keine Playlists erwartet.
invalidValue (400) snippetNeeded Du musst eine snippet angeben, um den Kanalabschnitt zu aktualisieren.
invalidValue (400) titleLengthExceeded Der Wert des Attributs snippet.title ist zu lang.
invalidValue (400) titleRequired Wenn das Attribut snippet.type den Wert multiplePlaylists oder multipleChannels hat, müssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert für das Attribut snippet.title angeben.
notFound (404) channelNotFound Mindestens einer der angegebenen Kanäle wurde nicht gefunden.
notFound (404) channelSectionNotFound Der Kanalabschnitt, den du aktualisieren möchtest, kann nicht gefunden werden.
notFound (404) playlistNotFound Mindestens eine der angegebenen Playlists wurde nicht gefunden.

Kanäle

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von channels-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

channels.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidCriteria Es kann maximal einer der folgenden Filter angegeben werden:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Bei der Authentifizierung des Rechteinhabers mit dem Parameter onBehalfOfContentOwner darf nur id oder managedByMe angegeben werden.
forbidden (403) channelForbidden Der durch den Parameter id angegebene Kanal unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) categoryNotFound Die durch den Parameter categoryId angegebene Kategorie wurde nicht gefunden. Verwenden Sie die Methode guideCategories.list, um eine Liste gültiger Werte abzurufen.
notFound (404) channelNotFound Der im id-Parameter angegebene Kanal wurde nicht gefunden.

channels.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) brandingValidationError Einer der Werte im Objekt brandingSettings 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 du den brandingSettings part eines Kanals aktualisierst, musst du den Wert der brandingSettings.channel.title-Eigenschaft auf den aktuellen Titel des Kanals festlegen oder die Eigenschaft weglassen. Die API gibt einen Fehler zurück, wenn Sie den Wert der Eigenschaft ändern.
badRequest (400) defaultLanguageNotSetError defaultLanguage muss zum Aktualisieren von localizations festgelegt werden.
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 zu channels-Ressourcen.
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 die Anfrage gesendet hat.
badRequest (400) invalidDuration Die Metadaten der Anfrage geben im invideoPromotion-Teil eine ungültige Dauer an.
badRequest (400) invalidDuration Die Metadaten der Anfrage enthalten einen ungültigen Positionstyp, mit dem bestimmt wird, wie das beworbene Element im Videoplayer positioniert wird. Prüfen Sie den Wert des Attributs invideoPromotion.position.type in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidRecentlyUploadedBy Die Metadaten der Anfrage enthalten eine ungültige Kanal-ID. Prüfen Sie den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidTimingOffset Die Metadaten der Anfrage geben im invideoPromotion-Teil einen ungültigen Zeitversatz an.
badRequest (400) invalidTimingOffset Die Metadaten der Anfrage geben einen ungültigen Zeitversatz an, anhand dessen festgelegt wird, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidTimingType Die Metadaten der Anfrage enthalten eine ungültige Zeitmethode zur Bestimmung, wann das beworbene Element im Videoplayer angezeigt wird. Prüfen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource, die die Anfrage gesendet hat.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Verwenden Sie die Methode channels.list, um gültige Werte abzurufen, und aktualisieren Sie sie unbedingt gemäß den Richtlinien in der Dokumentation zu Channels-Ressourcen.
badRequest (400) tooManyPromotedItems Die Anzahl der zulässigen beworbenen Artikel wurde im Abschnitt „invideoPromotion“ überschritten.
forbidden (403) channelForbidden Der im id-Parameter angegebene Kanal unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
forbidden (403) promotedVideoNotAllowed Der Kanal, den die API-Anfrage zu aktualisieren versucht, kann nicht gefunden werden. Prüfe den Wert der Eigenschaft id in der Ressource channel, die in der Anfrage gesendet wurde, um sicherzustellen, dass die Kanal-ID korrekt ist.
forbidden (403) websiteLinkNotAllowed Die angegebene Website-URL ist nicht zulässig.
notFound (404) channelNotFound Der durch den Parameter id angegebene Kanal wurde nicht gefunden oder verfügt nicht über Brandingoptionen.
notFound (404) channelNotFound Der im id-Parameter angegebene Kanal wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Kanal-ID wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Kanal-ID "latestUploadedBy" wurde nicht gefunden.
notFound (404) unknownVideoId Die Video-ID, die als beworbener Artikel angegeben wurde, wurde nicht gefunden.
required (400) requiredItemIdType In den Metadaten der Anfrage muss ein Elementtyp im invideoPromotion-Teil angegeben werden.
required (400) requiredItemId Die Metadaten der Anfrage müssen ein Element im invideoPromotion-Teil angeben.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein standardmäßiger Zeitversatz angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein Zeitversatz angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element erscheint. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element erscheint. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTiming In den Metadaten der Anfrage muss für jedes Element im invideoPromotion-Teil eine Zeitangabe angegeben sein.
required (400) requiredVideoId In den Metadaten der Anfrage muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren.
required (400) requiredWebsiteUrl Die Metadaten der Anfrage müssen eine Website-URL im invideoPromotion-Teil angeben. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die die Anfrage sendet.

commentThreads

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von commentThreads-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

commentThreads.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher konnte der API-Server die Anfrage nicht verstehen.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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 durch den Parameter videoId angegebene Video wurden Kommentare deaktiviert.
forbidden (403) forbidden Mindestens einer der angeforderten Kommentarthreads kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) channelNotFound Der durch den Parameter allThreadsRelatedToChannelId angegebene Kanal wurde nicht gefunden.
notFound (404) commentThreadNotFound Mindestens einer der angegebenen Kommentarthreads wurde nicht gefunden. Prüfen Sie, ob die Werte des id-Parameters der Anfrage korrekt sind.
notFound (404) videoNotFound Das durch den Parameter videoId angegebene Video wurde nicht gefunden.

commentThreads.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelOrVideoIdMissing Jeder Kommentarthread muss mit einem Kanal oder Video verknüpft sein. Die Ressource muss Werte für die Attribute snippet.channelId und snippet.videoId angeben. Auf der Wiedergabeseite eines Videos wird ein Kommentar zu einem Video angezeigt.
badRequest (400) commentTextRequired Die eingefügte Ressource comment muss einen Wert für das Attribut snippet.topLevelComment.snippet.textOriginal angeben. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte Ressource comment enthält zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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 Kommentarthread konnte aufgrund unzureichender Berechtigungen erstellt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403) ineligibleAccount Das zum Autorisieren der API-Anfrage verwendete YouTube-Konto muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einfügen zu können.
notFound (404) channelNotFound Der angegebene Kanal 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.

comments

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

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von comments-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

comments.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher konnte der API-Server die Anfrage nicht verstehen.
forbidden (403) forbidden Mindestens einer der angeforderten Kommentare kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens einer der angegebenen Kommentare wurde nicht gefunden. Prüfen Sie, ob die Werte der Parameter id und parentId der Anfrage korrekt sind.

comments.setModerationStatus

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) banWithoutReject Der Parameter banAuthor kann nur verwendet werden, wenn der Wert des Parameters moderationStatus rejected ist.
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher konnte der API-Server die Anfrage nicht verstehen.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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 für einen oder mehrere Kommentare kann aufgrund unzureichender Berechtigungen nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) commentNotFound Mindestens einer der Kommentare, die in der Anfrage aktualisiert werden sollen, wurde nicht gefunden. Prüfen Sie, ob die Werte des id-Parameters der Anfrage korrekt sind.

comments.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Die eingefügte Ressource comment muss einen Wert für das Attribut snippet.textOriginal angeben. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte Ressource comment enthält zu viele Zeichen im Attribut 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 angegeben wird. 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. Antworten auf private Kommentare werden von der API nicht unterstützt.
badRequest (400) parentIdMissing Der eingefügte Kommentar muss mit einem übergeordneten Kommentar verknüpft sein. Die Ressource comment im Text der API-Anfrage enthielt jedoch keinen Wert für das Attribut snippet.parentId.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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 zum Autorisieren der API-Anfrage verwendete YouTube-Konto muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einfügen zu können.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.parentId im Anfragetext korrekt ist.

comments.delete

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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üfen Sie, ob der Wert des id-Parameters der Anfrage korrekt ist.

comments.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextTooLong Die Ressource comment, die aktualisiert wird, enthält zu viele Zeichen im Attribut snippet.textOriginal.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Die API-Anfrage ist ungültig oder hat nicht das richtige Format. Daher konnte der API-Server die Anfrage nicht verstehen.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar 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 zum Autorisieren der API-Anfrage verwendete YouTube-Konto muss mit dem Google-Konto des Nutzers zusammengeführt werden, damit ein Kommentar oder Kommentarthread aktualisiert werden kann.
notFound (404) commentNotFound Der angegebene Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs id im Anfragetext korrekt ist.

Mitglieder

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von members-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

members.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert.
badRequest (400) invalidMode Der Parameterwert mode ist ungültig. Dieser Fehler kann auftreten, wenn der Parameter pageToken ein Token angibt, das mit einem anderen Modus als dem angegebenen abgerufen wurde.
badRequest (400) invalidPageToken Der Parameterwert pageToken ist ungültig. Dieser Fehler tritt auf, wenn das in der Anfrage verwendete Seitentoken abgelaufen ist.
badRequest (400) invalidHasAccessToLevel Der Parameterwert hasAccessToLevel ist ungültig. Es gibt keine Ebene mit dem angegebenen id.
badRequest (400) invalidFilterByMemberChannelId Der Parameterwert filterByMemberChannelId ist ungültig. Dieser Fehler tritt auf, wenn der Parameterwert filterByMemberChannelId mehr als 100 Kanäle angibt.

membershipsLevels

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von members-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

membershipsLevels.list

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert.

playlistItems

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von playlistItems-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler 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 identifiziert wurde, wurde nicht gefunden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Löschen von Videos aus der angegebenen Playlist nicht. So kannst du 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 berechtigt, das angegebene Playlist-Element einzufügen.
invalidValue (400) invalidContentDetails Das Attribut contentDetails in der Anfrage ist ungültig. Ein möglicher Grund dafür ist, dass das Feld contentDetails.note mehr als 280 Zeichen enthält.
invalidValue (400) invalidPlaylistItemPosition Die Anfrage versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position in der snippet der Ressource.
invalidValue (400) invalidResourceType Die für die Ressourcen-ID angegebene type wird für diesen Vorgang nicht unterstützt. Die Ressourcen-ID kennzeichnet das Element, das der Playlist hinzugefügt wird, z. B. youtube#video.
invalidValue (400) manualSortRequired Die Anfrage versucht, die Position des Playlist-Elements festzulegen, aber die Playlist verwendet keine manuelle Sortierung. 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 durch die Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Option Reihenfolge der Playlist in den Einstellungen der Playlist zu Manuell ändern. Diese Einstellungen kannst du im Video-Manager von YouTube anpassen.
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. Es ist beispielsweise nicht möglich, ein Video in die Playlist „Hochgeladene Videos“ einzufügen.
notFound (404) playlistNotFound Die mit dem Parameter playlistId der Anfrage identifizierte Playlist wurde nicht gefunden.
notFound (404) videoNotFound Das Video, das du der Playlist hinzufügen möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert der Eigenschaft videoId korrekt ist.
required (400) channelIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut playlistId angegeben.
required (400) resourceIdRequired Die Anfrage muss eine Ressource enthalten, in der das snippet-Objekt eine resourceId angibt.

playlistItems.list

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht berechtigt, die angegebene Playlist abzurufen.
notFound (404) playlistNotFound Die mit dem Parameter playlistId der Anfrage identifizierte Playlist wurde nicht gefunden.
notFound (404) videoNotFound Das Video, das mit dem Parameter videoId der Anfrage identifiziert wurde, wurde nicht gefunden.
required (400) playlistIdRequired Die Abonnieren-Anfrage enthält keinen Wert für das erforderliche Attribut playlistId.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Möglichkeit, Videos in der angegebenen Playlist aufzulisten. So ist es beispielsweise nicht möglich, ein Video der Playlist „Später ansehen“ hinzuzufügen.

playlistItems.update

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht autorisiert, das angegebene Playlist-Element zu aktualisieren.
invalidValue (400) invalidPlaylistItemPosition Die Anfrage versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position in der snippet der Ressource.
invalidValue (400) invalidResourceType Die für die Ressourcen-ID angegebene type wird für diesen Vorgang nicht unterstützt. Die Ressourcen-ID kennzeichnet das Element, das der Playlist hinzugefügt wird, z. B. youtube#video.
invalidValue (400) invalidSnippet In der Anfrage ist kein gültiges snippet-Attribut angegeben.
invalidValue (400) manualSortRequired Die Anfrage versucht, die Position des Playlist-Elements festzulegen, aber die Playlist verwendet keine manuelle Sortierung. 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 durch die Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Option Reihenfolge der Playlist in den Einstellungen der Playlist zu Manuell ändern. Diese Einstellungen kannst du im Video-Manager von YouTube anpassen.
invalidValue (400) playlistOperationUnsupported Die API unterstützt die Aktualisierung von Videos in der angegebenen Playlist nicht. So kannst du beispielsweise kein Video in der Playlist „Hochgeladene Videos“ aktualisieren.
notFound (404) playlistItemNotFound Das mit der Eigenschaft id der Anfrage angegebene Playlist-Element konnte nicht gefunden werden.
notFound (404) playlistNotFound Die mit dem Parameter playlistId der Anfrage identifizierte Playlist wurde nicht gefunden.
required (400) channelIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut playlistId angegeben.
required (400) playlistItemIdRequired Die in der Anfrage angegebene Ressource des Playlist-Elements muss das Attribut id verwenden, um das zu aktualisierende Playlist-Element zu identifizieren.

Playlists

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von playlists-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

playlists.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistForbidden Dieser Vorgang ist unzulässig oder die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) playlistNotFound Die mit dem Parameter id der Anfrage identifizierte Playlist wurde nicht gefunden.
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 Playlist, die durch den Parameter id der Anfrage identifiziert wird, unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
notFound (404) channelNotFound Der im channelId-Parameter angegebene Kanal wurde nicht gefunden.
notFound (404) playlistNotFound Die mit dem Parameter id der Anfrage identifizierte Playlist wurde nicht gefunden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt die Möglichkeit zum Auflisten der angegebenen Playlist nicht. Du kannst beispielsweise nicht die Playlist „Später ansehen“ hinzufügen.

playlists.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss zum Aktualisieren von localizations festgelegt werden.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Rufe mit der Methode playlists.list gültige Werte ab und aktualisiere sie gemäß den Richtlinien in der Dokumentation zu Playlists-Ressourcen.
badRequest (400) maxPlaylistExceeded Die Playlist kann nicht erstellt werden, da der Kanal bereits die maximal zulässige Anzahl von Playlists hat.
forbidden (403) playlistForbidden Dieser Vorgang ist unzulässig oder die Anfrage ist nicht ordnungsgemäß autorisiert.
invalidValue (400) invalidPlaylistSnippet Die Anfrage enthält ein ungültiges Playlist-Snippet.
required (400) playlistTitleRequired In der Anfrage muss ein Playlist-Titel angegeben werden.

playlists.update

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss zum Aktualisieren von localizations festgelegt werden.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Rufe mit der Methode playlists.list gültige Werte ab und aktualisiere sie gemäß den Richtlinien in der Dokumentation zu Playlists-Ressourcen.
forbidden (403) playlistForbidden Dieser Vorgang ist unzulässig 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 das Aktualisieren der angegebenen Playlist nicht. Du kannst beispielsweise die Eigenschaften deiner Playlist mit hochgeladenen Videos nicht aktualisieren.
notFound (404) playlistNotFound Die mit dem Parameter id der Anfrage identifizierte Playlist wurde nicht gefunden.
required (400) playlistTitleRequired In der Anfrage muss ein Playlist-Titel angegeben werden.

Abos

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von subscriptions-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

subscriptions.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) subscriptionForbidden Die Anfrage ist nicht ordnungsgemäß 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, ob der Wert des id-Parameters der Anfrage korrekt ist.

subscriptions.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) subscriptionDuplicate Das Abo, das Sie erstellen möchten, ist bereits vorhanden.
badRequest (400) subscriptionForbidden Du hast die maximale Anzahl an Abos erreicht.
badRequest (400) subscriptionForbidden Zu viele aktuelle Abos. Bitte versuchen Sie es in ein paar Stunden noch einmal.
badRequest (400) subscriptionForbidden Dein eigener Kanal kann nicht abonniert werden.
forbidden (403) subscriptionForbidden Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
notFound (404) publisherNotFound Die durch das Attribut snippet.resourceId der Anfrage angegebene Ressource wurde nicht gefunden.
notFound (404) subscriberNotFound Der mit der Anfrage angegebene Abonnent wurde nicht gefunden.
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 Anforderer ist nicht berechtigt, auf die angeforderten Abos zuzugreifen.
notFound (404) subscriberNotFound Der mit der Anfrage angegebene Abonnent wurde nicht gefunden.

Miniaturansichten

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von thumbnails-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

thumbnails.set

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) invalidImage Der bereitgestellte Bildinhalt ist ungültig.
badRequest (400) mediaBodyRequired Die Anfrage enthält nicht den Bildinhalt.
forbidden (403) forbidden Das Thumbnail kann für das angegebene Video nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403) forbidden Der authentifizierte Nutzer ist nicht berechtigt, benutzerdefinierte Video-Thumbnails hochzuladen und festzulegen.
notFound (404) videoNotFound Das Video, für das Sie eine Miniaturansicht einfügen möchten, wurde nicht gefunden. Prüfen Sie, ob der Wert des videoId-Parameters der Anfrage korrekt ist.
tooManyRequests (429) uploadRateLimitExceeded Der Kanal hat in letzter Zeit zu viele Thumbnails hochgeladen. Bitte versuchen Sie es später noch einmal.

videoAbuseReportReasons

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von videoAbuseReportReasons-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler 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 Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von videoCategories-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

videoCategories.list

Fehlertyp Fehlerdetails Beschreibung
notFound (404) videoCategoryNotFound Die durch den Parameter id angegebene Videokategorie wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.

Videos

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von videos-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

videos.insert

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Es wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Die Eigenschaft snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDescription Die Metadaten der Anfrage enthalten eine ungültige Videobeschreibung.
badRequest (400) invalidFilename Der im Slug-Header angegebene 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 Anfragemetadaten gibt ungültige Aufnahmedetails an.
badRequest (400) invalidTags Die Metadaten der Anfrage enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle Die Metadaten der Anfrage enthalten einen ungültigen oder leeren Videotitel.
badRequest (400) invalidVideoGameRating Die Metadaten der Anfrage geben eine ungültige Altersfreigabe für das Videospiel an.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn die Anfrage den snippet-Teil einer video-Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt.
badRequest (400) mediaBodyRequired Der Videocontent ist nicht im Antrag enthalten.
badRequest (400) uploadLimitExceeded Der Nutzer hat die maximale Anzahl von 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 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 Die Anfrage ist nicht korrekt für den Zugriff auf die Videodatei oder die Verarbeitungsinformationen autorisiert. Die Teile „fileDetails“, „processingDetails“ und „suggestions“ sind nur für den Rechteinhaber dieses Videos verfügbar.
forbidden (403) forbidden Mit der Anfrage kann nicht auf Nutzerbewertungsinformationen zugegriffen werden. Dieser Fehler kann auftreten, wenn die Anfrage nicht ordnungsgemäß für die Verwendung des myRating-Parameters autorisiert ist.
notFound (404) videoNotFound Das Video, das du abrufen möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage korrekt ist.

videos.delete

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Das Video, das du löschen möchtest, kann nicht gelöscht werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404) videoNotFound Das Video, das du löschen möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage 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 Die Eigenschaft snippet.categoryId gibt eine ungültige Kategorie-ID an. 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 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 Anfragemetadaten gibt ungültige Aufnahmedetails an.
badRequest (400) invalidTags Die Metadaten der Anfrage enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle Die Metadaten der Anfrage enthalten einen ungültigen oder leeren Videotitel.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn die Anfrage den snippet-Teil einer video-Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt.
forbidden (403) forbidden Zugriff unzulässig: Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403) forbiddenEmbedSetting In der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Einige Kanäle sind möglicherweise nicht berechtigt, 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 Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen.
notFound (404) videoNotFound Das Video, das du aktualisieren möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert des Felds id im Anfragetext korrekt ist.

videos.rate

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) emailNotVerified Der Nutzer muss vor der Bewertung seine E-Mail-Adresse bestätigen.
badRequest (400) invalidRating Die Anfrage 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 ordnungsgemäß autorisiert.
forbidden (403) videoRatingDisabled Der Inhaber des Videos, das du bewerten möchtest, hat die Altersfreigabe für dieses Video deaktiviert.
notFound (404) videoNotFound Das Video, das du bewerten möchtest, wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters der Anfrage 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 zu viele Anfragen in einem bestimmten Zeitraum gesendet.
forbidden (403) forbidden
notFound (404) videoNotFound Das Video, für das du Missbrauch melden möchtest, wurde nicht gefunden.

watermarks

In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von watermarks-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Anfragefehler aufgeführt sind.

watermarks.set

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) imageFormatUnsupported Das Format des Bilds wird nicht unterstützt.
badRequest (400) imageTooTall Das Bild ist zu hoch.
badRequest (400) imageTooWide Das 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 korrekt autorisiert oder der Parameter channelId ist auf einen ungültigen Wert gesetzt.

watermarks.unset

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die Festlegung des Wasserzeichens kann für den angegebenen Kanal nicht aufgehoben werden. Die Anfrage ist möglicherweise nicht korrekt autorisiert oder der Parameter channelId ist auf einen ungültigen Wert gesetzt.