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 finden Sie API-Fehlermeldungen, die sich nicht auf eine bestimmte API-Methode beziehen.
Core API errors
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
quotaExceeded (403) |
quotaExceeded |
Die Anfrage kann nicht abgeschlossen werden, da Sie Ihr Kontingent überschritten haben. |
Common request errors
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
incompatibleParameters |
In der Anfrage sind zwei oder mehr Parameter angegeben, die nicht in derselben Anfrage verwendet werden können. |
badRequest (400) |
invalidFilters |
In der Anfrage ist ein ungültiger Filterparameter angegeben. |
badRequest (400) |
invalidPageToken |
In der Anfrage ist ein ungültiges Seitentoken angegeben. |
badRequest (400) |
missingRequiredParameter |
In der Anfrage fehlt ein erforderlicher Parameter. |
badRequest (400) |
unexpectedParameter |
In der Anfrage wird ein unerwarteter Parameter angegeben. |
forbidden (403) |
accountDelegationForbidden |
Der authentifizierte Nutzer kann nicht im Namen des angegebenen Google-Kontos handeln. |
forbidden (403) |
authenticatedUserAccountClosed |
Das YouTube-Konto des authentifizierten Nutzers ist geschlossen. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Konto. |
forbidden (403) |
authenticatedUserAccountSuspended |
Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Falls der authentifizierte Nutzer im Namen eines anderen Google-Kontos handelt, bezieht sich dieser Fehler auf das zweite Konto. |
forbidden (403) |
authenticatedUserNotChannel |
Bei dieser Anfrage muss der authentifizierte Nutzer einem Channel zugeordnet werden, tut dies aber 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 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 verfügt nicht über die erforderlichen Berechtigungen. |
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 |
Der Parameter 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 Partnerkanäle agieren, indem du den onBehalfOfContentOwnerChannel -Parameter angibst, sofern für die aufgerufene Methode verfügbar. |
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 ordnungsgemäß 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 können auf viele Funktionen zugreifen, die von der Nutzerautorisierung abhängig sind. Beispielsweise können sie Videos bewerten oder einer watch_later -Playlist hinzufügen. Der Nutzer benötigt jedoch beispielsweise einen YouTube-Kanal, um ein Video hochladen zu können. Ein Nutzer mit einem Gmail-Konto oder einem Android-Gerät hat zwar ein Google-Konto, aber möglicherweise 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 diese Fehlermeldung angezeigt. Im YouTube API-Blogpost, in dem der Google-Kontosupport vorgestellt wird, wird auch der Fehler youtubeSignupRequired ausführlicher behandelt. Obwohl in diesem Blogpost der Fehler für API-Version 2.1 erläutert wird, ist die Bedeutung des Fehlers weiterhin zutreffend. |
Aktivitäten
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 Fehler aufgeführt sind.
activities.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
Die Aktivitätsdaten auf 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 gesetzt haben. |
forbidden (403) |
forbidden |
Die Anfrage ist nicht korrekt 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 ordnungsgemäß 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 Fehler 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 korrekt autorisiert. |
notFound (404) |
captionNotFound |
Der Untertiteltrack wurde nicht gefunden. Prüfe, 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 Untertitel-Track herunterzuladen. Möglicherweise wurde die Anfrage nicht ordnungsgemäß autorisiert oder in der Videobestellung sind keine Drittanbieterbeiträge 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 snippet.status des angeforderten Untertitel-Tracks nicht failed ist. |
notFound (404) |
captionNotFound |
Der Untertiteltrack wurde nicht gefunden. Prüfe, 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önnen den vorhandenen Titel 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 korrekt 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. Dies ist aber nicht erforderlich. |
notFound (404) |
videoNotFound |
Das durch den Parameter videoId identifizierte Video wurde nicht gefunden. |
captions.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Mindestens ein Untertiteltrack konnte nicht abgerufen werden, da die mit der Anfrage verknüpften Berechtigungen zum Abrufen der angeforderten Ressourcen nicht ausreichen. Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
notFound (404) |
captionNotFound |
Mindestens einer der angegebenen Untertitel-Tracks wurde nicht gefunden. Dieser Fehler tritt auf, wenn der videoId -Parameter ein tatsächliches Video identifiziert, der id -Parameter 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 identifizierte Video wurde nicht gefunden. |
captions.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
contentRequired |
Bei der Anfrage wurde keine aktualisierte Untertiteldatei hochgeladen. Die eigentlichen Titelinhalte sind 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 korrekt autorisiert. |
notFound (404) |
captionNotFound |
Der angegebene Untertiteltrack wurde nicht gefunden. Prüfe, ob der Wert des id -Parameters der Anfrage korrekt ist. |
Kanalbanner
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 Fehler 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, 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 Fehler aufgeführt sind.
channelSections.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
notEditable |
Dieser Kanalabschnitt kann nicht gelöscht werden. |
forbidden (403) |
channelSectionForbidden |
Die Anfrage ist für diesen Kanal nicht ordnungsgemäß authentifiziert oder wird 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 erfolgreich 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 die Eigenschaft contentDetails.channels[] angegeben werden und es muss mindestens ein Channel 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 ein contentDetails -Objekt für diese Art von Kanalabschnitt enthalten. |
invalidValue (400) |
inValidPosition |
Das Attribut 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 von Kanalabschnitten hat. |
invalidValue (400) |
maxChannelsExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
maxPlaylistExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
onePlaylistNeeded |
Wenn das Attribut snippet.type den Wert singlePlaylist hat, muss das Attribut contentDetails.playlists[] genau eine Playlist angeben. |
invalidValue (400) |
ownChannelInChannels |
Du kannst deinen eigenen Kanal nicht 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, da 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 das Attribut 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 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, musst du den Titel des Abschnitts festlegen, indem du einen Wert für die Eigenschaft snippet.title angibst. |
notFound (404) |
channelNotFound |
Mindestens einer der angegebenen Channels wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Mindestens eine der angegebenen Playlists wurde nicht gefunden. |
channelSections.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
channelSectionForbidden |
Der Antragsteller hat keinen Zugriff auf die angeforderten Kanalabschnitte. |
invalidValue (400) |
idInvalid |
In der Anfrage ist eine ungültige Kanalabschnitts-ID angegeben. |
invalidValue (400) |
invalidCriteria |
Die Anfrage konnte nicht abgeschlossen werden, da die Filterkriterien ungültig sind. |
notFound (404) |
channelNotFound |
Der mit der Anfrage verknüpfte Kanal wurde nicht gefunden. |
notFound (404) |
channelSectionNotFound |
Der mit der Anfrage verknüpfte Kanalabschnitt wurde nicht gefunden. |
channelSections.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
Das Attribut snippet.defaultLanguage der Ressource channelSection muss festgelegt sein, damit das Objekt localizations für diese Ressource erfolgreich 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 die Eigenschaft contentDetails.channels[] angegeben werden und es muss mindestens ein Channel 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 du aktualisierst, 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 in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
maxPlaylistExceeded |
Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalabschnitt aufzunehmen. |
invalidValue (400) |
onePlaylistNeeded |
Wenn das Attribut snippet.type den Wert singlePlaylist hat, muss das Attribut contentDetails.playlists[] genau eine Playlist angeben. |
invalidValue (400) |
ownChannelInChannels |
Du kannst deinen eigenen Kanal nicht 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, da 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 das Attribut 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, musst du den Titel des Abschnitts festlegen, indem du einen Wert für die Eigenschaft snippet.title angibst. |
notFound (404) |
channelNotFound |
Mindestens einer der angegebenen Channels 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 Fehler aufgeführt sind.
channels.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidCriteria |
Es kann maximal einer der folgenden Filter angegeben werden:id , mySubscribers , categoryId , mine , managedByMe , forUsername . Bei einer Rechteinhaber-Authentifizierung über den 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 kann nicht gefunden werden. Verwenden Sie die Methode guideCategories.list, um eine Liste gültiger Werte abzurufen. |
notFound (404) |
channelNotFound |
Der im Parameter id 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 zu channels -Ressourcen. |
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 des Attributs ä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 entsprechend den Richtlinien in der Dokumentation zu channels -Ressourcen. |
badRequest (400) |
invalidCustomMessage |
Die Metadaten der Anfrage geben eine ungültige benutzerdefinierte Nachricht an. Prüfen Sie den Wert des Attributs invideoPromotion.items[].customMessage in der Ressource, die von der Anfrage gesendet wurde. |
badRequest (400) |
invalidDuration |
Die Metadaten der Anfrage geben eine ungültige Dauer im invideoPromotion-Teil an. |
badRequest (400) |
invalidDuration |
In den Metadaten der Anfrage ist ein ungültiger Positionstyp angegeben, mit dem bestimmt werden kann, wie das beworbene Element im Videoplayer positioniert wird. Prüfen Sie den Wert des Attributs invideoPromotion.position.type in der Ressource, die von der Anfrage gesendet wurde. |
badRequest (400) |
invalidRecentlyUploadedBy |
In den Metadaten der Anfrage ist eine ungültige Kanal-ID angegeben. Prüfen Sie den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, die von der Anfrage gesendet wurde. |
badRequest (400) |
invalidTimingOffset |
Die Anforderungsmetadaten geben im invideoPromotion-Teil einen ungültigen Zeit-Offset an. |
badRequest (400) |
invalidTimingOffset |
Die Metadaten der Anfrage geben einen ungültigen Zeitversatz an, mit dem bestimmt wird, wann das beworbene Element im Videoplayer erscheinen soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, die von der Anfrage gesendet wurde. |
badRequest (400) |
invalidTimingType |
Die Metadaten der Anfrage geben eine ungültige Zeitmethode zum Festlegen, wann das beworbene Element im Videoplayer angezeigt wird, an. Prüfen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource, die von 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 entsprechend 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 Parameter id angegebene Kanal unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
forbidden (403) |
promotedVideoNotAllowed |
Der Kanal, den die API-Anfrage zu aktualisieren versucht, kann nicht gefunden werden. Prüfe den Wert des Attributs 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 Parameter id angegebene Kanal wurde nicht gefunden. |
notFound (404) |
unknownChannelId |
Die angegebene Kanal-ID wurde nicht gefunden. |
notFound (404) |
unknownChannelId |
Die angegebene Kanal-ID für kürzlichUploadedBy wurde nicht gefunden. |
notFound (404) |
unknownVideoId |
Die Video-ID, die als beworbenes Element angegeben wurde, kann nicht gefunden werden. |
required (400) |
requiredItemIdType |
In den Metadaten der Anfrage muss im invideoPromotion-Teil ein Elementtyp angegeben werden. |
required (400) |
requiredItemId |
Die Metadaten der Anfrage müssen eine Element-ID 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 von der Anfrage gesendet wird. |
required (400) |
requiredTimingOffset |
In den Metadaten der Anfrage muss ein zeitlicher Versatz angegeben werden, damit YouTube feststellen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTimingType |
In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube feststellen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTimingType |
In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube feststellen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die von der Anfrage gesendet wird. |
required (400) |
requiredTiming |
In den Anfragemetadaten muss für jedes Element im invideoPromotion -Teil eine Zeitangabe angegeben werden. |
required (400) |
requiredVideoId |
Die Metadaten der Anfrage müssen eine Video-ID zur Identifizierung des beworbenen Artikels enthalten. |
required (400) |
requiredWebsiteUrl |
Die Metadaten der Anfrage müssen im invideoPromotion-Teil eine Website-URL angeben. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die von der Anfrage gesendet wird. |
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 Fehler aufgeführt sind.
commentThreads.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
operationNotSupported |
Der ID-Filter ist nur mit Kommentaren auf Google+ kompatibel. |
badRequest (400) |
processingFailure |
Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der Ressource commentThread im Anfragetext, um sicherzustellen, dass sie gültig ist. |
forbidden (403) |
commentsDisabled |
Für das Video, das durch den Parameter videoId identifiziert wird, wurden Kommentare deaktiviert. |
forbidden (403) |
forbidden |
Mindestens einer der angeforderten Kommentarthreads kann aufgrund unzureichender Berechtigungen nicht abgerufen werden. Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
notFound (404) |
channelNotFound |
Der vom Parameter channelId oder allThreadsRelatedToChannelId angegebene Kanal wurde nicht gefunden. |
notFound (404) |
commentThreadNotFound |
Mindestens einer der angegebenen Kommentarthreads wurde nicht gefunden. Prüfe, ob die Werte des id -Parameters der Anfrage korrekt sind. |
notFound (404) |
videoNotFound |
Das durch den Parameter videoId identifizierte Video wurde nicht gefunden. |
commentThreads.insert
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Jeder Kommentarthread muss mit einem Kanal oder Video verknüpft sein.
|
badRequest (400) |
commentTextRequired |
Die eingefügte Ressource comment muss einen Wert für das Attribut snippet.topLevelComment.snippet.textOriginal enthalten. 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 |
Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der Ressource commentThread im Anfragetext, um sicherzustellen, dass sie gültig ist. |
forbidden (403) |
forbidden |
Der Kommentarthread konnte aufgrund unzureichender Berechtigungen nicht erstellt werden. Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
forbidden (403) |
ineligibleAccount |
Das zur Autorisierung der API-Anfrage verwendete YouTube-Konto muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einzufügen. |
notFound (404) |
channelNotFound |
Der angegebene Channel wurde nicht gefunden. Prüfe, ob der Wert des Attributs snippet.channelId korrekt ist. |
notFound (404) |
videoNotFound |
Das angegebene Video wurde nicht gefunden. Prüfe, ob der Wert des Attributs snippet.videoId 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 Fehler aufgeführt sind.
members.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert. |
badRequest (400) |
invalidMode |
Der Wert des Parameters mode ist ungültig.
Dieser Fehler kann auftreten, wenn der Parameter pageToken ein Token angibt, das mit einem anderen als dem angegebenen Modus abgerufen wurde. |
badRequest (400) |
invalidPageToken |
Der Parameterwert pageToken ist ungültig. Dieser Fehler tritt auf, wenn das in der Anfrage verwendete Seitentoken abgelaufen ist. |
badRequest (400) |
invalidHasAccessToLevel |
Der Parameterwert hasAccessToLevel ist ungültig. Es gibt keine Ebene mit dem angegebenen id . |
badRequest (400) |
invalidFilterByMemberChannelId |
Der Parameterwert filterByMemberChannelId ist ungültig. Dieser Fehler tritt auf, wenn der Parameterwert filterByMemberChannelId mehr als 100 Kanäle angibt. |
Mitgliedschaftsstufen
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 Fehler aufgeführt sind.
membershipsLevels.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanalmitgliedschaft nicht aktiviert. |
Playlist-Elemente
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 Fehler aufgeführt sind.
playlistItems.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen. |
notFound (404) |
playlistItemNotFound |
Das Playlist-Element, das mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt nicht das Löschen von Videos aus der angegebenen Playlist. 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 ist, dass das Feld contentDetails.note mehr als 280 Zeichen enthält. |
invalidValue (400) |
invalidPlaylistItemPosition |
Bei der Anfrage wird versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position im snippet der Ressource. |
invalidValue (400) |
invalidResourceType |
Der 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. Playlists 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 können im Video-Manager von YouTube angepasst werden. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
Das Video, das du der Playlist hinzufügen möchtest, ist bereits in einer anderen Serien-Playlist enthalten. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt nicht das Einfügen von Videos in die angegebene Playlist. Du kannst beispielsweise kein Video in deine Playlist mit hochgeladenen Videos einfügen. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
notFound (404) |
videoNotFound |
Das Video, das du der Playlist hinzufügen möchtest, kann nicht gefunden werden. Prüfe, ob der Wert des Attributs videoId korrekt ist. |
required (400) |
channelIdRequired |
In der Anfrage ist kein Wert für das erforderliche channelId -Attribut angegeben. |
required (400) |
playlistIdRequired |
In der Anfrage ist kein Wert für das erforderliche playlistId -Attribut angegeben. |
required (400) |
resourceIdRequired |
Die Anfrage muss eine Ressource enthalten, in der das snippet -Objekt einen resourceId angibt. |
playlistItems.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht ordnungsgemäß autorisiert, die angegebene Playlist abzurufen. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
notFound (404) |
videoNotFound |
Das mit dem Parameter videoId der Anfrage identifizierte Video wurde nicht gefunden. |
required (400) |
playlistIdRequired |
Die Abonnieren-Anfrage enthält keinen Wert für das erforderliche playlistId -Attribut. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt nicht die Möglichkeit, Videos in der angegebenen Playlist aufzulisten. So kannst du beispielsweise ein Video nicht in die Playlist „Später ansehen“ aufnehmen. |
playlistItems.update
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu aktualisieren. |
invalidValue (400) |
invalidPlaylistItemPosition |
Bei der Anfrage wird versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position im snippet der Ressource. |
invalidValue (400) |
invalidResourceType |
Der 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. Playlists 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 können im Video-Manager von YouTube angepasst werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt die Aktualisierung von Videos in der angegebenen Playlist nicht. Du kannst beispielsweise kein Video in deiner Playlist „Hochgeladene Videos“ aktualisieren. |
notFound (404) |
playlistItemNotFound |
Das Playlist-Element, das mit dem Attribut id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden. |
required (400) |
channelIdRequired |
In der Anfrage ist kein Wert für das erforderliche channelId -Attribut angegeben. |
required (400) |
playlistIdRequired |
In der Anfrage ist kein Wert für das erforderliche playlistId -Attribut angegeben. |
required (400) |
playlistItemIdRequired |
Die in der Anfrage angegebene Playlist-Elementressource muss das Attribut id verwenden, um das zu aktualisierende Playlistelement 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 Fehler 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 Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Löschen der angegebenen Playlist nicht. Du kannst beispielsweise nicht die Playlist mit deinen hochgeladenen Videos 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 durch den Parameter id der Anfrage identifizierte Playlist unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
channelNotFound |
Der im Parameter channelId angegebene Kanal wurde nicht gefunden. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
invalidValue (400) |
playlistOperationUnsupported |
Die API unterstützt das Auflisten der angegebenen Playlist nicht. Du kannst beispielsweise nicht die Playlist „Später ansehen“ hinzufügen. |
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 entsprechend den Richtlinien in der Dokumentation zu Ressourcen für Playlists. |
badRequest (400) |
maxPlaylistExceeded |
Die Playlist kann nicht erstellt werden, weil der Kanal bereits die maximal zulässige Anzahl von Playlists enthält. |
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 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 entsprechend den Richtlinien in der Dokumentation zu Ressourcen für Playlists. |
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 die Aktualisierung der angegebenen Playlist nicht. Beispielsweise kannst du die Eigenschaften deiner Playlist mit hochgeladenen Videos nicht aktualisieren. |
notFound (404) |
playlistNotFound |
Die Playlist, die mit dem Parameter id der Anfrage identifiziert wurde, kann nicht gefunden werden. |
required (400) |
playlistTitleRequired |
In der Anfrage muss ein Playlist-Titel angegeben werden. |
search
In den folgenden Tabellen sind Fehlermeldungen aufgeführt, die die API als Antwort auf Aufrufe von search
-Ressourcen zurückgibt. Bei diesen Methoden können auch Fehler zurückgegeben werden, die im Abschnitt Häufige Fehler aufgeführt sind.
search.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidChannelId |
Der Parameter channelId hat eine ungültige Kanal-ID angegeben. |
badRequest (400) |
invalidLocation |
Der Parameterwert location und/oder locationRadius war falsch formatiert. |
badRequest (400) |
invalidRelevanceLanguage |
Der Parameterwert relevanceLanguage war falsch formatiert. |
badRequest (400) |
invalidSearchFilter |
Die Anfrage enthält eine ungültige Kombination von Suchfiltern und/oder Einschränkungen. Beachten Sie, dass Sie den type -Parameter auf video setzen müssen, wenn Sie einen Wert für die Parameter eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated oder videoType festlegen. |
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 Fehler aufgeführt sind.
subscriptions.delete
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
subscriptionForbidden |
Die Anfrage ist für diesen Kanal nicht ordnungsgemäß authentifiziert oder wird nicht unterstützt. |
notFound (404) |
subscriptionNotFound |
Das Abo, das Sie löschen möchten, wurde nicht gefunden. Prüfe, 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 |
Du kannst deinen eigenen Kanal nicht abonnieren. |
forbidden (403) |
subscriptionForbidden |
Die Anfrage ist für diesen Kanal nicht ordnungsgemäß authentifiziert oder wird nicht unterstützt. |
notFound (404) |
publisherNotFound |
Die im Attribut snippet.resourceId der Anfrage angegebene Ressource wurde nicht gefunden. |
notFound (404) |
subscriberNotFound |
Der in der Anfrage angegebene Abonnent kann nicht gefunden werden. |
required (400) |
publisherRequired |
Die in der Anfrage angegebene Aboressource muss das Attribut snippet.resourceId verwenden, um den abonnierten Kanal zu identifizieren. |
subscriptions.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
accountClosed |
Abos konnten nicht abgerufen werden, da das Konto des Abonnenten geschlossen ist. |
forbidden (403) |
accountSuspended |
Abos konnten nicht abgerufen werden, da das Konto des Abonnenten gesperrt ist. |
forbidden (403) |
subscriptionForbidden |
Der Sender hat keinen Zugriff auf die angeforderten Abos. |
notFound (404) |
subscriberNotFound |
Der in der Anfrage angegebene Abonnent kann nicht gefunden werden. |
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 Fehler 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 korrekt autorisiert. |
forbidden (403) |
forbidden |
Der authentifizierte Nutzer ist nicht berechtigt, benutzerdefinierte Video-Thumbnails hochzuladen und festzulegen. |
notFound (404) |
videoNotFound |
Das Video, für das du eine Miniaturansicht einfügen möchtest, wurde nicht gefunden. Prüfe, 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 Fehler aufgeführt sind.
videoAbuseReportReasons.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
Videokategorien
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 Fehler aufgeführt sind.
videoCategories.list
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Die durch den Parameter id angegebene Videokategorie kann nicht gefunden werden. 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 Fehler 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 |
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 Name der Videodatei ist ungültig. |
badRequest (400) |
invalidPublishAt |
In den Metadaten der Anfrage ist eine ungültige geplante Veröffentlichungszeit angegeben. |
badRequest (400) |
invalidRecordingDetails |
Das Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufnahmedetails an. |
badRequest (400) |
invalidTags |
In den Metadaten der Anfrage sind ungültige Video-Keywords angegeben. |
badRequest (400) |
invalidTitle |
Die Metadaten der Anfrage geben einen ungültigen oder leeren Videotitel an. |
badRequest (400) |
invalidVideoGameRating |
Die Metadaten der Anfrage geben eine ungültige 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 Videoinhalt ist in der Anfrage nicht enthalten. |
badRequest (400) |
uploadLimitExceeded |
Der Nutzer hat die maximale Anzahl von Videos überschritten, die er hochladen kann. |
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 berechtigt, auf die Videodatei oder Verarbeitungsinformationen zuzugreifen. 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üfe, 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 korrekt autorisiert. |
notFound (404) |
videoNotFound |
Das Video, das du löschen möchtest, kann nicht gefunden werden. Prüfe, 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 Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufnahmedetails an. |
badRequest (400) |
invalidTags |
In den Metadaten der Anfrage sind ungültige Video-Keywords angegeben. |
badRequest (400) |
invalidTitle |
Die Metadaten der Anfrage geben einen ungültigen oder leeren Videotitel an. |
badRequest (400) |
invalidVideoMetadata |
Die Metadaten der Anfrage sind ungültig. Dieser Fehler tritt auf, wenn die Anfrage den snippet -Teil einer video -Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt. |
forbidden (403) |
forbidden |
Zugriff unzulässig: Die Anfrage ist möglicherweise nicht korrekt autorisiert. |
forbidden (403) |
forbiddenEmbedSetting |
In der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Hinweis: 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 Feldes 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 korrekt 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üfe, 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. |
Wasserzeichen
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 Fehler aufgeführt sind.
watermarks.set
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
Das Format des Bilds wird nicht unterstützt. |
badRequest (400) |
imageTooTall |
Das von Ihnen bereitgestellte 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. Möglicherweise ist die Anfrage nicht ordnungsgemäß autorisiert oder der Parameter channelId ist auf einen ungültigen Wert gesetzt. |
watermarks.unset
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Das Wasserzeichen kann für den angegebenen Kanal nicht deaktiviert werden. Möglicherweise ist die Anfrage nicht ordnungsgemäß autorisiert oder der Parameter channelId ist auf einen ungültigen Wert gesetzt. |
comments
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 Fehler aufgeführt sind.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
undparentId
der Anfrage korrekt sind.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
kann nur verwendet werden, wenn der Wert des ParametersmoderationStatus
rejected
ist.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
-Parameters der Anfrage korrekt sind.comments.insert
badRequest (400)
commentTextRequired
comment
muss einen Wert für das Attributsnippet.textOriginal
enthalten. Kommentare dürfen nicht leer sein.badRequest (400)
commentTextTooLong
comment
enthält zu viele Zeichen im Attributsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
identifizierten Kommentar der obersten Ebene einfügen. Bei einercommentThread
-Ressource gibt das Attributsnippet.canReply
an, ob der aktuelle Betrachter auf den Thread antworten kann.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
im Text der API-Anfrage enthielt jedoch keinen Wert für das Attributsnippet.parentId
.badRequest (400)
processingFailure
comment
im Anfragetext, um sicherzustellen, dass sie gültig ist.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
im Anfragetext korrekt ist.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
-Parameters der Anfrage korrekt ist.comments.update
badRequest (400)
commentTextTooLong
comment
, die aktualisiert wird, enthält zu viele Zeichen im Attributsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
im Anfragetext, um sicherzustellen, dass sie gültig ist.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
im Anfragetext korrekt ist.