API Reference

Mit der YouTube Data API kannst du Funktionen, die normalerweise auf der YouTube-Website ausgeführt werden, in deine eigene Website oder Anwendung integrieren. In den folgenden Listen sind die verschiedenen Ressourcentypen aufgeführt, die Sie mithilfe der API abrufen können. Die API unterstützt auch Methoden zum Einfügen, Aktualisieren oder Löschen vieler dieser Ressourcen.

In diesem Referenzleitfaden wird erläutert, wie Sie diese Vorgänge mithilfe der API ausführen. Die Anleitung ist nach Ressourcentyp sortiert. Eine Ressource stellt einen Elementtyp dar, der Teil der YouTube-Umgebung ist, wie z. B. ein Video, eine Playlist oder ein Abo. Für jeden Ressourcentyp werden eine oder mehrere Datendarstellungen aufgeführt und Ressourcen werden als JSON-Objekte dargestellt. Außerdem werden eine oder mehrere unterstützte Methoden (LIST, POST, DELETE usw.) für jeden Ressourcentyp aufgeführt und ihre Verwendung in Ihrer Anwendung erläutert.

API aufrufen

Für Anfragen an die YouTube Data API gelten die folgenden Anforderungen:

  1. Für jede Anfrage muss entweder ein API-Schlüssel (mit dem Parameter key) oder ein OAuth 2.0-Token angegeben werden. Sie finden den API-Schlüssel in der Developer Console im Bereich API-Zugriff für Ihr Projekt.

  2. Für jede Anforderung zum Einfügen, Aktualisieren und Löschen muss ein Autorisierungstoken gesendet werden. Außerdem müssen Sie ein Autorisierungstoken für jede Anfrage senden, mit der die privaten Daten des authentifizierten Nutzers abgerufen werden.

    Darüber hinaus unterstützen einige API-Methoden zum Abrufen von Ressourcen möglicherweise Parameter, die eine Autorisierung erfordern oder zusätzliche Metadaten enthalten können, wenn Anfragen autorisiert sind. Beispielsweise kann eine Anfrage zum Abrufen der hochgeladenen Videos eines Nutzers auch private Videos enthalten, wenn die Anfrage von diesem bestimmten Nutzer autorisiert wurde.

  3. Die API unterstützt das OAuth 2.0-Authentifizierungsprotokoll. Sie haben folgende Möglichkeiten, ein OAuth 2.0-Token bereitzustellen:

    • Verwenden Sie den Abfrageparameter access_token so: ?access_token=oauth2-token
    • Verwenden Sie den HTTP-Header Authorization so: Authorization: Bearer oauth2-token

    Eine vollständige Anleitung zur Implementierung der OAuth 2.0-Authentifizierung in Ihrer Anwendung finden Sie im Authentifizierungsleitfaden.

Ressourcentypen

Aktivitäten

Eine activity-Ressource enthält Informationen zu einer Aktion, die ein bestimmter Kanal oder Nutzer auf YouTube ausgeführt hat. Zu den in Aktivitätsfeeds gemeldeten Aktionen gehören unter anderem das Bewerten eines Videos, das Teilen eines Videos, das Markieren eines Videos als Favorit und das Hochladen eines Videos. Jede activity-Ressource gibt den Aktionstyp, den mit der Aktion verknüpften Kanal und die mit der Aktion verknüpfte(n) Ressource(n) an, z. B. das Video, das bewertet oder hochgeladen wurde.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /activities Gibt eine Liste mit Channel-Aktivitätsereignissen zurück, die den Anfragekriterien entsprechen. Sie können beispielsweise Ereignisse abrufen, die mit einem bestimmten Kanal oder mit dem eigenen Kanal des Nutzers verknüpft sind.
insert POST /activities Hinweis: Diese Methode wurde eingestellt und wird nicht mehr unterstützt.

Untertitel

Eine caption-Ressource steht für einen YouTube-Untertiteltrack. Ein Untertiteltrack ist mit genau einem YouTube-Video verknüpft.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /captions Löscht den angegebenen Untertiteltrack
download GET /captions/id Lädt einen Untertitel-Track herunter. Der Untertiteltrack wird in seinem ursprünglichen Format zurückgegeben, es sei denn, in der Anfrage wird ein Wert für den Parameter tfmt und in seiner Originalsprache angegeben, es sei denn, in der Anfrage wird ein Wert für den Parameter tlang angegeben.
insert POST /captions Lädt einen Untertitel-Track hoch.
list GET /captions Gibt eine Liste von Untertitel-Tracks zurück, die mit einem bestimmten Video verknüpft sind. Beachte, dass die API-Antwort nicht die tatsächlichen Untertitel enthält und dass die Methode captions.download die Möglichkeit bietet, einen Untertiteltrack abzurufen.
update PUT /captions Aktualisiert einen Untertiteltrack Beim Aktualisieren eines Untertiteltracks kannst du den Entwurfsstatus des Tracks ändern, eine neue Untertiteldatei für den Track hochladen oder beides.

Kanalbanner

Eine channelBanner-Ressource enthält die URL, mit der du ein neu hochgeladenes Bild als Bannerbild für einen Kanal festlegen würdest.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
insert POST /channelBanners/insert Lädt ein Kanalbanner auf YouTube hoch Diese Methode stellt die ersten beiden Schritte eines aus drei Schritten bestehenden Prozesses dar, um das Bannerbild für einen Kanal zu aktualisieren:

  1. Rufen Sie die Methode channelBanners.insert auf, um die Binärbilddaten auf YouTube hochzuladen. Das Bild muss ein Seitenverhältnis von 16:9 und mindestens 2.048 × 1.152 Pixel haben. Wir empfehlen, ein Bild mit 2.560 x 1.440 Pixeln hochzuladen.
  2. Extrahieren Sie den Wert des Attributs url aus der Antwort, die die API für Schritt 1 zurückgibt.
  3. Rufe die Methode channels.update auf, um die Branding-Einstellungen des Kanals zu aktualisieren. Legen Sie den Wert des Attributs brandingSettings.image.bannerExternalUrl auf die URL fest, die Sie in Schritt 2 erhalten haben.

Kanalabschnitte

Eine channelSection-Ressource enthält Informationen zu einer Reihe von Videos, die auf einem Kanal vorgestellt werden. Ein Abschnitt kann beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten.

Die Abschnitte eines Kanals sind nur sichtbar, wenn die Inhalte des Kanals in einer Übersicht und nicht in einer Feedansicht angezeigt werden. Damit auf einem Kanal Inhalte in einer Übersicht angezeigt werden können, musst du die Eigenschaft brandingSettings.channel.showBrowseView für den angegebenen Kanal auf true setzen.

Für einen Kanal können maximal zehn Bereiche erstellt werden.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /channelSections Löscht einen Kanalabschnitt
insert POST /channelSections Fügt dem Kanal des authentifizierten Nutzers einen Kanalabschnitt hinzu. Auf einem Kanal können maximal zehn Bereiche erstellt werden.
list GET /channelSections Gibt eine Liste von channelSection-Ressourcen zurück, die den API-Anfragekriterien entsprechen.
update PUT /channelSections Aktualisiert einen Kanalabschnitt

Kanäle

Eine channel-Ressource enthält Informationen zu einem YouTube-Kanal.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /channels Gibt eine Sammlung mit null oder mehr channel-Ressourcen zurück, die den Anfragekriterien entsprechen.
update PUT /channels Aktualisiert die Metadaten eines Kanals Beachten Sie, dass diese Methode derzeit nur Aktualisierungen der brandingSettings- und invideoPromotion-Objekte der Ressource channel und ihrer untergeordneten Attribute unterstützt.

Kommentar-Threads

Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der sich aus einem Kommentar auf oberster Ebene sowie ggf. Antworten auf diesen Kommentar zusammensetzt. Eine commentThread-Ressource kann Kommentare zu einem Video oder einem Kanal darstellen.

Sowohl der Kommentar auf oberster Ebene als auch die Antworten sind in Wirklichkeit comment Ressourcen, die in der commentThread-Ressource verschachtelt sind. Die Ressource commentThread enthält nicht unbedingt alle Antworten auf einen Kommentar. Sie müssen die Methode comments.list verwenden, wenn Sie alle Antworten für einen bestimmten Kommentar abrufen möchten. Beachte außerdem, dass auf einige Kommentare keine Antworten möglich sind.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /commentThreads Gibt eine Liste von Kommentarthreads zurück, die den API-Anfrageparametern entsprechen.
insert POST /commentThreads Erstellt einen neuen Kommentar auf oberster Ebene. Wenn Sie einem vorhandenen Kommentar eine Antwort hinzufügen möchten, verwenden Sie stattdessen die Methode comments.insert.

Kommentare

Eine comment-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment-Ressource kann einen Kommentar zu einem Video oder einem Kanal darstellen. Außerdem kann es sich bei dem Kommentar um einen Top-Level-Kommentar oder um eine Antwort auf einen Top-Level-Kommentar handeln.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /comments Gibt eine Liste von Kommentaren zurück, die den API-Anfrageparametern entsprechen.
setModerationStatus POST /comments/setModerationStatus Legt den Moderationsstatus für einen oder mehrere Kommentare fest. Die API-Anfrage muss vom Inhaber des mit den Kommentaren verknüpften Kanals oder Videos autorisiert werden.
insert POST /comments Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis: Verwenden Sie zum Erstellen eines Kommentars auf oberster Ebene die Methode commentThreads.insert.
markAsSpam POST /comments/markAsSpam Hinweis: Diese Methode wurde eingestellt und wird nicht mehr unterstützt.
delete DELETE /comments Löscht einen Kommentar.
update PUT /comments Ändert einen Kommentar

Anleitungskategorien

Eine guideCategory-Ressource gibt eine Kategorie an, die YouTube anhand der Inhalte eines Kanals oder anderer Indikatoren wie der Beliebtheit des Kanals algorithmisch zuweist. Die Liste ähnelt Videokategorien, mit dem Unterschied, dass der Uploader eines Videos eine Videokategorie zuweisen kann, aber nur YouTube kann eine Kanalkategorie zuweisen.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /guideCategories Gibt eine Liste der Kategorien zurück, die YouTube-Kanälen zugeordnet werden können.

I18nSprachen

Eine i18nLanguage-Ressource gibt eine Anwendungssprache an, die von der YouTube-Website unterstützt wird. Die Anwendungssprache kann auch als UI-Sprache bezeichnet werden. Für die YouTube-Website könnte basierend auf den Google-Kontoeinstellungen, der Browsersprache oder dem IP-Standort automatisch eine Anwendungssprache ausgewählt werden. Nutzer können die gewünschte UI-Sprache auch manuell in der Fußzeile der YouTube-Website auswählen.

Jede i18nLanguage-Ressource identifiziert einen Sprachcode und einen Namen. Der Sprachcode kann als Wert des hl-Parameters verwendet werden, wenn API-Methoden wie videoCategories.list und guideCategories.list aufgerufen werden.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /i18nLanguages Gibt eine Liste von Anwendungssprachen zurück, die von der YouTube-Website unterstützt werden.

I18n-Regionen

Eine i18nRegion-Ressource gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugte Region für Inhalte auswählen kann. Der Inhaltsbereich kann auch als Inhaltsgebietsschema bezeichnet werden. Für die YouTube-Website könnte anhand von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch eine Inhaltsregion ausgewählt werden. Nutzer können den gewünschten Inhaltsbereich auch manuell in der Fußzeile der YouTube-Website auswählen.

Jede i18nRegion-Ressource identifiziert einen Regionscode und einen Namen. Der Regionscode kann als Wert des Parameters regionCode verwendet werden, wenn API-Methoden wie search.list, videos.list, activities.list und videoCategories.list aufgerufen werden.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /i18nRegions Gibt eine Liste der Content-Regionen zurück, die von der YouTube-Website unterstützt werden.

Mitglieder

Eine member-Ressource steht für ein Mitglied eines YouTube-Kanals. Mitglieder unterstützen einen Creator regelmäßig in finanzieller Hinsicht und erhalten besondere Vorteile. Mitglieder können beispielsweise chatten, wenn der Creator den Modus „Nur für Mitglieder“ für einen Chat aktiviert.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /members Hier werden Kanalmitglieder (früher „Unterstützer“) aufgeführt. Die API-Anfrage muss vom Kanalinhaber autorisiert werden.

Mitgliedschaftsstufen

Eine membershipsLevel-Ressource gibt eine Preisstufe für den Ersteller an, der die API-Anfrage autorisiert hat.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /membershipsLevels Gibt eine Sammlung mit null oder mehr membershipsLevel-Ressourcen zurück, die dem Kanal gehören, der die API-Anfrage autorisiert hat. Ebenen werden in impliziter Anzeigereihenfolge zurückgegeben.

Playlist-Artikel

Eine playlistItem-Ressource bezeichnet eine andere Ressource, z. B. ein Video, das in einer Playlist enthalten ist. Darüber hinaus enthält die Ressource playlistItem Details zur enthaltenen Ressource, die sich speziell darauf beziehen, wie diese Ressource in dieser Playlist verwendet wird.

YouTube verwendet auch eine Playlist, um die Liste der hochgeladenen Videos eines Kanals zu identifizieren, wobei jede playlistItem in dieser Liste für ein hochgeladenes Video steht. Die Playlist-ID für diese Liste kannst du aus dem channel resource eines bestimmten Kanals abrufen. Sie können dann die Methode playlistItems.list für die Liste verwenden.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /playlistItems Löscht ein Playlist-Element.
insert POST /playlistItems Fügt einer Playlist eine Ressource hinzu.
list GET /playlistItems Gibt eine Sammlung von Playlist-Elementen zurück, die den API-Anfrageparametern entsprechen. Du kannst alle Playlist-Elemente in einer bestimmten Playlist oder ein oder mehrere Playlist-Elemente anhand ihrer eindeutigen IDs abrufen.
update PUT /playlistItems Ändert ein Playlist-Element. Du kannst beispielsweise die Position des Elements in der Playlist aktualisieren.

Playlists

Eine playlist-Ressource steht für eine YouTube-Playlist. Eine Playlist ist eine Sammlung von Videos, die nacheinander angesehen und mit anderen Nutzern geteilt werden können. Eine Playlist kann bis zu 200 Videos enthalten. Die Anzahl der von Nutzern erstellten Playlists ist auf YouTube nicht begrenzt. Playlists sind standardmäßig für andere Nutzer sichtbar. Playlists können jedoch öffentlich oder privat sein.

YouTube verwendet Playlists auch dazu, spezielle Videosammlungen für einen Kanal zu identifizieren, z. B.:

  • Hochgeladene Videos
  • positiv bewertete Videos mit „Mag ich“-Bewertungen
  • Wiedergabeverlauf
  • später ansehen
Genauer gesagt sind diese Listen mit einem Kanal verknüpft. Dabei handelt es sich um eine Sammlung der Videos, Playlists und sonstigen YouTube-Informationen einer Person, Gruppe oder eines Unternehmens. Du kannst die Playlist-IDs für jede dieser Listen aus dem channel resource eines bestimmten Kanals abrufen.

Anschließend können Sie mit der Methode playlistItems.list beliebige dieser Listen abrufen. Du kannst auch Elemente zu diesen Listen hinzufügen oder daraus entfernen, indem du die Methoden playlistItems.insert und playlistItems.delete aufrufst.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /playlists Löscht eine Playlist.
list GET /playlists Gibt eine Sammlung von Playlists zurück, die den API-Anfrageparametern entsprechen. Du kannst beispielsweise alle Playlists abrufen, die dem authentifizierten Nutzer gehören, oder eine oder mehrere Playlists anhand ihrer eindeutigen IDs abrufen.
insert POST /playlists Erstellt eine Playlist.
update PUT /playlists Ändert eine Playlist. Du kannst beispielsweise den Titel, die Beschreibung oder den Datenschutzstatus einer Playlist ändern.

Ein Suchergebnis enthält Informationen zu einem YouTube-Video, einem YouTube-Kanal oder einer YouTube-Playlist, die mit den in einer API-Anfrage angegebenen Suchparametern übereinstimmen. Ein Suchergebnis verweist zwar auf eine eindeutig identifizierbare Ressource wie ein Video, verfügt aber nicht über eigene persistente Daten.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /search Gibt eine Sammlung von Suchergebnissen zurück, die den in der API-Anfrage angegebenen Suchparametern entsprechen. Standardmäßig werden in den Suchergebnissen übereinstimmende video-, channel- und playlist-Ressourcen ermittelt. Sie können aber auch Abfragen so konfigurieren, dass nur ein bestimmter Ressourcentyp abgerufen wird.

Abos

Eine subscription-Ressource enthält Informationen zu einem YouTube-Nutzerabo. Mit einem Abo werden Nutzer benachrichtigt, wenn einem Kanal neue Videos hinzugefügt werden oder wenn ein anderer Nutzer eine von mehreren Aktionen auf YouTube ausführt, z. B. ein Video hochlädt, ein Video bewertet oder ein Video kommentiert.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /subscriptions Löscht ein Abo.
insert POST /subscriptions Fügt ein Abo für den Kanal des authentifizierten Nutzers hinzu.
list GET /subscriptions Gibt Aboressourcen zurück, die den API-Anfragekriterien entsprechen.

Thumbnails

Eine thumbnail-Ressource identifiziert verschiedene Größen von Miniaturansichten, die mit einer Ressource verknüpft sind. Beachten Sie die folgenden Merkmale von Thumbnail-Bildern:

  • Das Attribut snippet.thumbnails einer Ressource ist ein Objekt, das die für diese Ressource verfügbaren Miniaturansichten angibt.
  • Eine thumbnail-Ressource enthält eine Reihe von Objekten. Der Name der einzelnen Objekte (default, medium, high usw.) bezieht sich auf die Größe des Thumbnail-Bilds.
  • Unterschiedliche Ressourcentypen können unterschiedliche Größen von Miniaturansichten unterstützen.
  • Unterschiedliche Ressourcentypen definieren möglicherweise unterschiedliche Größen für Miniaturansichten mit demselben Namen. Das Thumbnail-Bild default für eine video-Ressource ist beispielsweise in der Regel 120 x 90 Pixel und das default-Thumbnail-Bild für eine channel-Ressource normalerweise 88 x 88 Pixel.
  • Ressourcen desselben Typs können für bestimmte Bilder immer noch unterschiedliche Thumbnail-Größen haben. Dies hängt von der Auflösung des Originalbilds oder des auf YouTube hochgeladenen Contents ab. So können beispielsweise bei einem HD-Video Miniaturansichten mit höherer Auflösung als bei Nicht-HD-Videos unterstützt werden.
  • Jedes Objekt, das Informationen zur Größe der Miniaturansicht enthält, hat eine width-Eigenschaft und eine height-Eigenschaft. Die Eigenschaften für Breite und Höhe werden jedoch möglicherweise nicht für dieses Bild zurückgegeben.
  • Wenn ein hochgeladenes Thumbnail-Bild nicht die erforderliche Größe hat, wird die Größe des Bildes auf die richtige Größe angepasst, ohne das Seitenverhältnis zu ändern. Das Bild ist nicht zugeschnitten, enthält aber möglicherweise schwarze Balken, sodass die Größe korrekt ist.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
set POST /thumbnails/set Lädt ein benutzerdefiniertes Video-Thumbnail auf YouTube hoch und legt es für ein Video fest.

Gründe für Video-Missbrauch

Eine videoAbuseReportReason-Ressource enthält Informationen zu einem Grund, warum ein Video wegen missbräuchlicher Inhalte gemeldet wird. Wenn Ihre Anwendung die Methode videos.reportAbuse aufruft, um ein missbräuchliches Video zu melden, verwendet die Anfrage die Informationen aus einer videoAbuseReportReason-Ressource, um den Grund für die Meldung des Videos zu ermitteln.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /videoAbuseReportReasons Rufe eine Liste mit Gründen ab, die zum Melden missbräuchlicher Videos verwendet werden können.

Videokategorien

Eine videoCategory-Ressource gibt eine Kategorie an, die mit hochgeladenen Videos verknüpft wurde oder sein könnte.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /videoCategories Gibt eine Liste von Kategorien zurück, die YouTube-Videos zugeordnet werden können.

Videos

Eine video-Ressource steht für ein YouTube-Video.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
insert POST /videos Lädt ein Video auf YouTube hoch und legt optional die Metadaten des Videos fest.
list GET /videos Gibt eine Liste von Videos zurück, die den API-Anfrageparametern entsprechen.
delete DELETE /videos Löscht ein YouTube-Video
update PUT /videos Aktualisiert die Metadaten eines Videos
rate POST /videos/rate Du kannst einem Video eine „Mag ich“- oder „Mag ich nicht“-Bewertung hinzufügen oder eine Bewertung für ein Video entfernen.
getRating GET /videos/getRating Ruft die Bewertungen ab, die der autorisierte Nutzer für eine Liste bestimmter Videos abgegeben hat
reportAbuse POST /videos/reportAbuse Ein Video mit missbräuchlichen Inhalten melden

Wasserzeichen

Eine watermark-Ressource gibt ein Bild an, das bei der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Zeitangaben, die bestimmen, wann das Wasserzeichen während der Videowiedergabe erscheint und wie lange es sichtbar ist.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
set POST /watermarks/set Lädt ein Wasserzeichen auf YouTube hoch und legt es für einen Kanal fest.
unset POST /watermarks/unset Löscht das Wasserzeichenbild eines Kanals.