thumbNail posten, kann das Video zwar erfolgreich veröffentlicht werden, das Thumbnail wird jedoch nicht übernommen. In diesem Fall bleibt der Top-Level-status des Beitrags "success" (das Video ist live), das YouTube-Ergebnis enthält jedoch ein warnings-Array, das den Thumbnail-Fehler beschreibt:
Symptom
Ihr YouTube-Video erscheint im Kanal, das von Ihnen angegebene benutzerdefinierte Thumbnail fehlt jedoch – YouTube verwendet stattdessen ein automatisch generiertes Bild. Die API-Antwort liefertstatus: "success" mit einem Thumbnail-warnings-Eintrag (feature: "thumbnail", code: 307).
Häufigste Ursache: Nicht verifizierter Kanal
Die häufigste Ursache für einen403-Thumbnail-Fehler auf YouTube ist ein nicht verifizierter YouTube-Kanal. YouTube verlangt eine Kanal-(Telefon-)Verifizierung, bevor ein Upload eines benutzerdefinierten Thumbnails akzeptiert wird.
Lösung: Kanal verifizieren
- Rufen Sie https://www.youtube.com/verify auf und schließen Sie die Telefonverifizierung für den Kanal ab.
- Alternativ gehen Sie in YouTube Studio zu Einstellungen → Kanal, wählen Sie Feature-Berechtigung und aktivieren Sie Funktionen, die eine Telefonverifizierung erfordern.
- Es kann bis zu 24 Stunden dauern, bis YouTube nach der Verifizierung benutzerdefinierte Thumbnails aktiviert. Eine „aktivierte” Telefonverifizierung garantiert nicht, dass YouTube Thumbnail-Uploads zulässt – YouTube entscheidet letztlich über die Berechtigung.
- Bestätigen Sie, dass Sie in YouTube Studio manuell ein Thumbnail hochladen können. Wenn das manuell nicht möglich ist, kann es die API auch nicht.
Sekundäre Ursache: OAuth-Berechtigungen
Wenn Ihr Kanal bereits verifiziert ist und Thumbnails weiterhin mit einem403 fehlschlagen, fehlen dem verknüpften YouTube-Konto möglicherweise die erforderlichen Berechtigungen. Versuchen Sie, Ihr YouTube-Konto in Social Accounts zu entkoppeln und erneut zu verknüpfen und erteilen Sie beim erneuten Verknüpfen alle angeforderten Berechtigungen.
Stellen Sie bei Brand-/Content-Owner-Konten (häufig für Business- oder Organisations-Kanäle verwendet) sicher, dass das verknüpfte Konto die erforderlichen Berechtigungen besitzt – wir empfehlen „Owner”-Rechte.
Anforderungen an Thumbnails vor der Veröffentlichung
Ayrshare validiert dasthumbNail, wo möglich, vor der Veröffentlichung. Um einen 307-Thumbnail-Fehler zu vermeiden, stellen Sie sicher, dass das Thumbnail folgende Anforderungen erfüllt:
- Format: PNG oder JPG/JPEG. Die Dateiendung muss auf
png,jpgoderjpegenden. - Größe: 2 MB oder weniger.
- Erreichbare URL: Die
thumbNail-URL muss öffentlich erreichbar sein, damit Ayrshare sie abrufen kann.
warnings. Wenn der Fehler erst nach dem Video-Upload festgestellt werden kann, bleibt das Video live und der Fehler wird über dasselbe oben beschriebene warnings-Array gemeldet. In beiden Fällen wird das Video veröffentlicht und status bleibt "success".
