Wat is de YouTube API?

De YouTube API is een familie van interfaces die Google publiceert voor ontwikkelaars: de Data API om video-, kanaal- en afspeellijstinformatie te lezen, en de IFrame Player API om een ingesloten speler te besturen met JavaScript (afspelen, pauzeren, spoelen en luisteren naar events).

Heb je dit nodig voor een simpele embed?

Nee. Een gewone embed, zoals geproduceerd door de embed-code generator van deze site, heeft niets meer nodig dan een standaard <iframe> en vereist geen API-sleutel, Google Cloud-project of JavaScript.

Wanneer het nuttig wordt

De IFrame Player API is de moeite waard zodra je aangepast gedrag nodig hebt, zoals een op JavaScript gebaseerde playknop, het bijhouden van kijkvoortgang in analytics, of het synchroniseren van meerdere ingesloten spelers.

De twee API’s die “de YouTube API” vormen

Wat mensen meestal bedoelen met “de YouTube API” zijn eigenlijk twee verwante maar aparte dingen. De YouTube Data API laat een ontwikkelaar programmatisch informatie over video’s, kanalen, afspeellijsten en reacties lezen (en, met de juiste rechten, schrijven), handig voor het bouwen van bijvoorbeeld een op maat gemaakte videozoektool of een kanaaldashboard. De YouTube IFrame Player API is anders: hiermee kan een ontwikkelaar een al ingesloten speler besturen met JavaScript, afspelen, pauzeren, spoelen, volume aanpassen, en luisteren naar events zoals “video ended”, zonder het authenticatie- of quotasysteem van de Data API nodig te hebben.

Een praktisch voorbeeld van wanneer elke API nodig is

Een site die simpelweg een vaste video op een pagina toont, heeft geen van beide API’s nodig; een standaard embed-code, zoals geproduceerd door onze embed-code generator, is op zichzelf voldoende. Een site die een aangepaste “speel alles af”-knop nodig heeft die meerdere ingesloten spelers samen bestuurt, of die analytics-events wil loggen wanneer een bezoeker een video daadwerkelijk uitkijkt, zou specifiek naar de IFrame Player API grijpen. Een site die een doorzoekbare videobibliotheek bouwt met metadata uit veel kanalen zou juist, of aanvullend, de Data API gebruiken.

YouTube API versus een gewone embed

Het praktische onderscheid is controle versus eenvoud. Een gewone embed, zonder API, is één HTML-fragment zonder JavaScript-afhankelijkheid, geen API-sleutel en geen gebruikslimiet om te beheren, waarom het de juiste keuze blijft voor de overgrote meerderheid van sites die gewoon een video willen tonen. Naar een van beide YouTube API’s grijpen is pas zinvol zodra de eisen van een project echt verder gaan dan wat query-string-parameters op een standaard embed-URL kunnen bereiken, zoals aangepaste, code-gestuurde afspeelbediening of het in bulk ophalen van metadata.

Weet je niet zeker in welke categorie jouw project valt, dan is een gewone embed het veiligste startpunt; je kunt later altijd API-gestuurde bediening toevoegen als daar een specifieke behoefte aan ontstaat.

Veelgestelde vragen