YouTube API-FehlerreferenzVollständiger Leitfaden zur Fehlerbehebung mit Lösungen

Umfassende Referenz für YouTube API-Fehler. Finden Sie Lösungen und beheben Sie häufige Integrationsprobleme.

11 Fehlercodes
•
5 Kategorien
•
Data API v3
← Zurück zur Integration YouTube View API Documentation

Fehlerkategorien

Authentifizierung

2 errors

Upload

4 errors

Account

1 error

Kontingent

2 errors

Inhalt

2 errors

Alle Fehlercodes

#Authentifizierung

invalid_grantrefresh-token

YouTube-Zugriffstoken ist abgelaufen. Bitte verbinden Sie Ihr YouTube-Konto erneut.

Lösung:

Ihr YouTube/Google-Zugriffstoken ist abgelaufen oder wurde widerrufen. Gehen Sie zu Ihren Kontoeinstellungen und verbinden Sie Ihr YouTube-Konto erneut, um ein neues Zugriffstoken zu erhalten.

token has been expired or revokedrefresh-token

YouTube-Zugriffstoken ist abgelaufen. Bitte verbinden Sie Ihr YouTube-Konto erneut.

Lösung:

Ihr Token ist nicht mehr gültig. Dies kann nach einer Passwortänderung oder Sicherheitsüberprüfung geschehen. Verbinden Sie Ihr YouTube-Konto erneut, um eine neue Sitzung zu erstellen.

#Upload

invalidTitleuser-error

Videotitel ist zu lang. YouTube-Titel müssen 100 Zeichen oder weniger sein.

Lösung:

Kürzen Sie Ihren Videotitel auf 100 Zeichen oder weniger. YouTube setzt dieses Limit strikt für alle Video-Uploads durch.

failedPreconditionuser-error

Thumbnail-Größe ist zu groß. Bitte verwenden Sie ein kleineres Bild (max. 2 MB).

Lösung:

Ihr benutzerdefiniertes Thumbnail überschreitet YouTubes 2-MB-Limit. Komprimieren Sie Ihr Thumbnail-Bild auf unter 2 MB. Empfohlene Größe ist 1280x720 Pixel.

youtube.thumbnailuser-error

Ihr YouTube-Konto ist nicht verifiziert. Wir haben Ihr Video hochgeladen, konnten aber das Thumbnail nicht setzen. Bitte verifizieren Sie Ihr Konto und versuchen Sie es erneut.

Lösung:

Nicht verifizierte YouTube-Konten können keine benutzerdefinierten Thumbnails setzen. Verifizieren Sie Ihr Konto unter youtube.com/verify mit einer Telefonnummer. Das Video wurde erfolgreich hochgeladen.

uploadLimitExceededuser-error

Sie haben Ihr tägliches YouTube-Upload-Limit erreicht. Bitte versuchen Sie es morgen erneut.

Lösung:

YouTube begrenzt Uploads basierend auf Ihrem Kontostatus. Neue Konten können auf 10 Uploads pro Tag begrenzt sein. Warten Sie 24 Stunden oder verifizieren Sie Ihr Konto unter youtube.com/verify.

#Account

youtubeSignupRequireduser-error

YouTube-Kanal-Setup ist nicht abgeschlossen. Bitte erstellen Sie einen YouTube-Kanal, bevor Sie Videos hochladen.

Lösung:

Sie müssen zuerst einen YouTube-Kanal erstellen. Gehen Sie zu youtube.com und klicken Sie auf 'Kanal erstellen'. Folgen Sie dem Setup-Assistenten, um die Kanalerstellung abzuschließen.

#Kontingent

quotaExceededretry

YouTube-API-Kontingent überschritten. Bitte versuchen Sie es später erneut.

Lösung:

Sie haben YouTubes API-Kontingentgrenzen überschritten. Standard-Kontingent ist 10.000 Einheiten pro Tag. Warten Sie, bis Ihr Kontingent zurückgesetzt wird (Mitternacht pazifische Zeit) oder fordern Sie eine Kontingenterhöhung bei Google an.

quotaretry

YouTube-API-Kontingent überschritten. Bitte versuchen Sie es später erneut.

Lösung:

YouTube Data API hat Nutzungskontingente. Jede Operation kostet Kontingenteinheiten. Warten Sie auf Kontingentrücksetzung oder optimieren Sie Ihre API-Nutzung, um Kontingentverbrauch zu reduzieren.

#Inhalt

copyrightuser-error

Video kann urheberrechtlich geschützten Inhalt enthalten. Bitte überprüfen Sie YouTubes Urheberrechtsrichtlinien.

Lösung:

YouTube hat potenzielle Urheberrechtsprobleme erkannt. Stellen Sie sicher, dass Sie Rechte an allen Inhalten in Ihrem Video haben. Überprüfen Sie YouTubes Urheberrechtsrichtlinien und verwenden Sie lizenzfreie Musik/Aufnahmen.

content iduser-error

Video kann urheberrechtlich geschützten Inhalt enthalten. Bitte überprüfen Sie YouTubes Urheberrechtsrichtlinien.

Lösung:

Content ID hat Ihr Video mit urheberrechtlich geschütztem Material abgeglichen. Wenn Sie die Erlaubnis haben, können Sie den Anspruch anfechten. Andernfalls entfernen Sie den urheberrechtlich geschützten Inhalt und laden Sie erneut hoch.

Beste Praktiken

Fehlerbehandlung

  • →Überwachen Sie tägliche Quote-Nutzung
  • →Implementieren Sie OAuth-Token-Aktualisierung
  • →Validieren Sie Video-Spezifikationen vor dem Upload
  • →Behandeln Sie Upload-Wiederholungen ordnungsgemäß

Präventions-Tipps

  • →Bleiben Sie innerhalb des täglichen Quote-Limits
  • →Verwenden Sie fortsetzbaren Upload für große Videos
  • →Validieren Sie Videoformat und Codec
  • →Halten Sie Tokens aktualisiert

Benötigen Sie Hilfe bei der YouTube Integration?

Unsere API behandelt Fehlerszenarien automatisch mit intelligenter Wiederholungslogik und detaillierter Protokollierung.

LoslegenDokumentation anzeigen