Was ist die YouTube API?

Die YouTube API ist eine Familie von Schnittstellen, die Google für Entwickler veröffentlicht: die Data API zum Lesen von Video-, Kanal- und Playlist-Informationen, und die IFrame Player API zur Steuerung eines eingebetteten Players mit JavaScript (Abspielen, Pausieren, Springen und Abhören von Ereignissen).

Brauchst du sie für ein einfaches Embed?

Nein. Ein einfaches Embed, wie es der Embed-Code-Generator dieser Seite erzeugt, benötigt nichts weiter als ein Standard-<iframe> und erfordert weder einen API-Schlüssel noch ein Google-Cloud-Projekt noch JavaScript.

Wann sie nützlich wird

Die IFrame Player API lohnt sich, sobald du individuelles Verhalten brauchst, etwa eine per JavaScript gesteuerte Play-Taste, das Nachverfolgen des Ansehfortschritts in der Analyse oder das Synchronisieren mehrerer eingebetteter Player.

Die zwei APIs, aus denen “die YouTube API” besteht

Was man üblicherweise mit “der YouTube API” meint, sind eigentlich zwei verwandte, aber getrennte Dinge. Mit der YouTube Data API kann eine Entwicklerin programmatisch Informationen über Videos, Kanäle, Playlists und Kommentare lesen (und mit den richtigen Berechtigungen schreiben), nützlich etwa für ein eigenes Videosuchwerkzeug oder ein Kanal-Dashboard. Die YouTube IFrame Player API ist anders: Sie erlaubt einer Entwicklerin, einen bereits eingebetteten Player mit JavaScript zu steuern, abzuspielen, zu pausieren, zu spulen, die Lautstärke anzupassen und auf Ereignisse wie “Video beendet” zu hören, ohne das Authentifizierungs- oder Kontingentsystem der Data API zu benötigen.

Ein praktisches Beispiel, wann welche API gebraucht wird

Eine Seite, die einfach ein festes Video anzeigt, braucht keine der beiden APIs; ein Standard-Embed-Code, wie ihn unser Embed-Code-Generator erzeugt, reicht dafür bereits aus. Eine Seite, die eine individuelle “Alle abspielen”-Schaltfläche braucht, die mehrere eingebettete Player gemeinsam steuert, oder die Analyse-Ereignisse protokollieren möchte, wenn ein Besucher ein Video tatsächlich zu Ende ansieht, würde gezielt auf die IFrame Player API zurückgreifen. Eine Seite, die eine durchsuchbare Videobibliothek mit Metadaten aus vielen Kanälen aufbaut, würde stattdessen oder zusätzlich die Data API nutzen.

YouTube API versus ein einfaches Embed

Der praktische Unterschied ist Kontrolle gegenüber Einfachheit. Ein einfaches Embed, ohne API, ist ein einzelner HTML-Codeschnipsel ohne JavaScript-Abhängigkeit, ohne API-Schlüssel und ohne zu verwaltendes Nutzungskontingent, weshalb es für die überwältigende Mehrheit der Websites, die einfach nur ein Video zeigen wollen, die richtige Wahl bleibt. Zu einer der beiden YouTube APIs zu greifen, ergibt erst dann Sinn, wenn die Anforderungen eines Projekts wirklich über das hinausgehen, was Query-String-Parameter an einer Standard-Embed-URL leisten können, etwa individuelle, codegesteuerte Wiedergabesteuerung oder das massenhafte Abrufen von Metadaten.

Bist du dir unsicher, in welche Kategorie dein Projekt fällt, ist ein einfaches Embed der sicherste Ausgangspunkt; API-gesteuerte Kontrolle lässt sich später jederzeit ergänzen, sobald ein konkreter Bedarf dafür entsteht.

Häufig gestellte Fragen