Überarbeitungsverlauf

Auf dieser Seite werden Änderungen an der YouTube Data API (v3) und Aktualisierungen der Dokumentation aufgeführt. Dieses Änderungsprotokoll abonnieren Abonnieren

12. September 2023

Hinweis: Diese Mitteilung wird verworfen.

Die Methode comments.markAsSpam wurde bereits seit mehreren Jahren eingestellt. Diese Methode wird auf YouTube bereits nicht unterstützt und von der API nicht mehr unterstützt.

Alle Dokumente, in denen auf die Methode comments.markAsSpam verwiesen wird, erhalten einen Hinweis zur Einstellung von Produkten und Diensten.

22. August 2023

Die Methode search.list unterstützt jetzt den Parameter videoPaidProductPlacement. Mit diesem Parameter kannst du Suchergebnisse so filtern, dass nur Videos angezeigt werden, die der Creator als bezahlte Werbung angegeben hat.

18. August 2023

Die Definition der liveStreamingDetails.concurrentViewers der Ressource video wurde aktualisiert. Die Anzahl gleichzeitiger Zuschauer, die die YouTube Data API zurückgibt, kann sich von der Anzahl der verarbeiteten, bereinigten und gleichzeitigen Zuschauer in YouTube Analytics unterscheiden. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.

7. August 2023

Wie am 12. Juni 2023 angekündigt, wurde der Parameter relatedToVideoId der Methode search.list eingestellt. Dieser Parameter wird nicht mehr unterstützt und Verweise auf den Parameter wurden aus der API-Dokumentation entfernt.

28. Juni 2023

Die Methode thumbnails.set unterstützt jetzt den Fehler uploadRateLimitExceeded. Dieser weist darauf hin, dass der Kanal in den letzten 24 Stunden zu viele Thumbnails hochgeladen hat und es später noch einmal versuchen sollte.

12. Juni 2023

Hinweis: Diese Mitteilung wird verworfen.

Der Parameter relatedToVideoId der Methode search.list wurde verworfen. Ab dem 7. August 2023 wird der Parameter von YouTube nicht mehr unterstützt.

Zu diesem Zeitpunkt wurde der Dokumentation der Methode search.list ein Hinweis zur Einstellung von Produkten und Diensten hinzugefügt. Dieser Parameter wird am oder nach dem 7. August 2023 vollständig aus der search.list-Dokumentation entfernt.

Außerdem wurde ein Beispiel zum Abrufen ähnlicher Videos aus dem API-Implementierungsleitfaden entfernt.

22. August 2022

Typ-Annotationen für video.statistics-Felder wurden von einem nicht signierten Long-String zu einem String korrigiert.

5. August 2022

YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Zuge dieser Änderung weist YouTube allen Untertitel-Tracks neue Untertitel-IDs zu. Diese Änderung kann eine nicht abwärtskompatible Änderung für Anwendungen sein, die caption_id-Werte speichern. Sie wirkt sich jedoch nicht auf Anwendungen aus, die keine caption_id-Werte speichern.

Von jetzt bis zum 1. Dezember 2022 werden die Methoden captions.list, captions.update, captions.download und captions.delete sowohl die alten als auch die neuen Untertiteltrack-IDs unterstützen. Die alten Untertitel-Track-IDs werden von YouTube jedoch ab dem 1. Dezember 2022 nicht mehr unterstützt. Wenn dann eine dieser API-Methoden mit einer alten Untertitel-Track-ID aufgerufen wird, wird der Fehler captionNotFound ausgelöst.

Zur Vorbereitung auf diese Änderung solltest du bis zum 1. Dezember 2022 alle gespeicherten Untertiteltrack-Daten vollständig ersetzen. Das bedeutet, dass du für jedes Video, für das du Untertiteltrack-Daten speicherst, die aktuell gespeicherten Daten löschen und dann die Methode captions.list aufrufen solltest, um den aktuellen Satz von Untertiteltracks für das Video abzurufen und die Daten wie gewohnt in der API-Antwort zu speichern.

12. Juli 2022

Die Nutzungsbedingungen der YouTube API-Dienste wurden aktualisiert. Weitere Informationen findest du in den Nutzungsbedingungen für die YouTube API-Dienste – Überarbeitungsverlauf.

27. April 2022

Die Beschreibung der Methode videos.insert wurde aktualisiert. Die maximale Dateigröße für hochgeladene Videos wurde von 128 GB auf 256 GB erhöht.

8. April 2022

Die Parameterdefinitionen myRecentSubscribers und mySubscribers der Methode subscriptions.list wurden aktualisiert, um zu berücksichtigen, dass die maximale Anzahl der von der API zurückgegebenen Abonnenten möglicherweise begrenzt ist. Diese Änderung stellt eine Korrektur der Dokumentation dar, keine Änderung des API-Verhaltens.

15. Dezember 2021

Wie am 18. November 2021 angekündigt, ist die statistics.dislikeCount-Property der video-Ressource neben den Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform privat machen, jetzt privat.

Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.

18. November 2021

Neben den Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen von Videos auf der gesamten YouTube-Plattform privat machen, wird die Property statistics.dislikeCount der Ressource video ab dem 13. Dezember 2021 auf „Privat“ gesetzt. Das bedeutet, dass die Property nur dann in eine API-Antwort vom Endpunkt videos.list aufgenommen wird, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde.

Der Endpunkt videos.rate ist von dieser Änderung nicht betroffen.

Entwickler, die die Anzahl der „Mag ich nicht“-Bewertungen nicht öffentlich anzeigen, aber trotzdem die Anzahl der „Mag ich nicht“-Bewertungen für ihren API-Client benötigen, können beantragen, dass sie auf eine Zulassungsliste für eine Ausnahme gesetzt werden. Wenn Sie eine Ausnahme beantragen möchten, müssen Sie dieses Antragsformular ausfüllen.

Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.

2. Juli 2021

Hinweis: Diese Mitteilung wird verworfen.

Der Endpunkt commentThreads.update wurde verworfen und wird nicht mehr unterstützt. Dieser Endpunkt hat Funktionen dupliziert, die über andere API-Endpunkte verfügbar sind. Stattdessen können Sie die Funktion comments.update aufrufen.

Wenn Ihr Code eine commentThreads-Ressource erfordert, führen Sie einen sekundären Aufruf an die commentThreads.list-Methode aus.

1. Juli 2021

Alle Entwickler, die die API-Dienste von YouTube nutzen, müssen ein API-Compliance-Audit durchlaufen, um mehr als das Standardkontingent von 10.000 Einheiten zu erhalten. Bisher haben Entwickler sowohl den Compliance-Prüfprozess als auch Anfragen für die Zuweisung zusätzlicher Quoteneinheiten das Formular zur Prüfung und Kontingentverlängerung für YouTube API-Dienste ausgefüllt und eingereicht.

Um diese Prozesse zu verdeutlichen und die Anforderungen von Entwicklern, die unsere API-Dienste verwenden, besser zu erfüllen, fügen wir drei neue Formulare und eine Anleitung zum Ausfüllen dieser Formulare hinzu:

  • Geprüfte Entwickleranfragen: Entwickler, die bereits ein API-Compliance-Audit bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Verlängerung des zugewiesenen Kontingents zu beantragen.
  • Einspruchsformular: Entwickler, deren API-Projekte eine Compliance-Prüfung nicht bestanden haben oder die eine Erhöhung der Kontingenteinheit abgelehnt haben, können dieses Formular ausfüllen und einreichen.
  • Formular für Kontrollwechsel (Change of Control): Entwickler oder jede Partei, die einen API-Client im Namen eines Entwicklers betreibt, bei denen ein Kontrollwechsel (z. B. durch einen Aktienkauf oder -verkauf, eine Fusion oder eine andere Unternehmenstransaktion) im Zusammenhang mit einem API-Projekt stattgefunden hat, müssen dieses Formular ausfüllen und einreichen. So kann das API-Team von YouTube unsere Unterlagen aktualisieren, die Einhaltung der Anwendungsfälle des neuen API-Projekts prüfen und die aktuelle Kontingentzuweisung des Entwicklers überprüfen.

Mit jedem neuen Formular werden wir darüber informiert, wie du die API von YouTube verwendest, damit wir dir besser helfen können.

Weitere Informationen finden Sie in unserem neuen Leitfaden zu API Compliance Audits.

12. Mai 2021

Hinweis: Diese Mitteilung wird verworfen.

Dieses Update umfasst die folgenden API-Änderungen:

  • Das Attribut contentDetails.relatedPlaylists.favorites der Ressource channel wurde eingestellt. Die Funktion für Lieblingsvideos wurde bereits seit einigen Jahren eingestellt, wie im Überarbeitungsverlaufseintrag vom 28. April 2016 erwähnt.

    Vor diesem Update hat die API immer noch eine neue Playlist erstellt, wenn ein API-Client versucht hat, ein Video einer nicht vorhandenen Favoriten-Playlist hinzuzufügen. In diesem Fall wird die Playlist dann nicht mehr erstellt und die API gibt einen Fehler zurück. Auch Versuche, Favoriten-Playlists durch Hinzufügen, Ändern oder Löschen von Elementen zu ändern, werden nach vorherigen Ankündigungen eingestellt und können jederzeit zu Fehlermeldungen führen.

  • Die folgenden channel-Ressourcenattribute wurden verworfen. Diese Eigenschaften werden auf der YouTube Studio-Benutzeroberfläche und auf YouTube bereits nicht unterstützt. Daher werden sie auch nicht mehr über die API unterstützt.

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    Alle Properties wurden aus der Ressourcendarstellung channel entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden mit diesen Attributen verbundene Fehler aus der methodenspezifischen Dokumentation entfernt.

  • Die folgenden channelSection-Ressourcenattribute wurden verworfen. Diese Eigenschaften werden auf der YouTube Studio-Benutzeroberfläche und auf YouTube bereits nicht unterstützt. Daher werden sie auch nicht mehr über die API unterstützt.

    • snippet.style
    • snippet.defaultLanguage
    • snippet.localized.title
    • localizations
    • localizations.(key)
    • localizations.(key).title
    • targeting
    • targeting.languages[]
    • targeting.regions[]
    • targeting.countries[]

    Im Zuge dieser Änderung wurde auch der Parameter hl der Methode channelSection.list eingestellt, da die unterstützten Funktionen nicht mehr unterstützt werden.

    Alle Properties wurden aus der Ressourcendarstellung channelSection entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden mit diesen Attributen verbundene Fehler aus der methodenspezifischen Dokumentation entfernt.

  • Für das Attribut snippet.type der Ressource channelSection wurden die folgenden Werte verworfen. Diese Werte werden auf YouTube-Kanalseiten bereits nicht unterstützt und daher werden sie auch nicht mehr über die API unterstützt.

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts
  • Das Attribut snippet.tags[] der Ressource playlist wurde eingestellt. Diese Property wird auf YouTube bereits nicht mehr unterstützt und wird daher nicht mehr über die API unterstützt.

9. Februar 2021

Die Ressource playlistItem unterstützt zwei neue Attribute:

28. Januar 2021

Dieses Update enthält die folgenden Änderungen:

  • Die Methoden playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list und playlists.update unterstützen alle einen neuen playlistOperationUnsupported-Fehler. Der Fehler tritt auf, wenn eine Anfrage versucht, einen Vorgang auszuführen, der für eine bestimmte Playlist nicht zulässig ist. Ein Nutzer kann beispielsweise kein Video aus seiner Playlist mit hochgeladenen Videos oder die Playlist selbst löschen.

    In allen Fällen wird durch diesen Fehler der HTTP-Antwortcode 400 (ungültige Anfrage) zurückgegeben.

  • Die Fehler watchHistoryNotAccessible und watchLaterNotAccessible der Methode playlistItems.list wurden aus der Dokumentation entfernt. Auf den Wiedergabeverlauf und die „Später ansehen“-Listen von Nutzern kann zwar nicht über die API zugegriffen werden, diese Fehler werden jedoch nicht von der API zurückgegeben.

15. Oktober 2020

Die Richtlinien für Entwickler wurden um zwei neue Abschnitte ergänzt:

  • Der neue Abschnitt III.E.4.i enthält zusätzliche Informationen zu den Daten, die über den eingebetteten YouTube-Player erhoben und gesendet werden. Du bist für alle Nutzerdaten verantwortlich, die du uns über einen eingebetteten YouTube-Player sendest, bevor der Nutzer mit dem Player interagiert hat, um eine Wiedergabeabsicht anzugeben. Du kannst einschränken, welche Daten mit YouTube geteilt werden, bevor ein Nutzer mit dem Player interagiert, indem du Autoplay auf „false“ setzt.
  • Im neuen Abschnitt III.E.4.j geht es darum, den Status „Speziell für Kinder“ von Inhalten zu prüfen, bevor du sie auf deinen Websites und in deinen Apps einbettest. Du bist dafür verantwortlich, zu wissen, ob Videos, die du in deinem API-Client einbettest, speziell für Kinder sind, und die vom eingebetteten Player erhobenen Daten entsprechend zu behandeln. Daher musst du den Status der Inhalte mithilfe des YouTube Data API-Dienstes prüfen, bevor du sie über einen eingebetteten YouTube-Player in deinen API-Client einbettest.

Im neuen Leitfaden Den MadeForKids-Status eines Videos ermitteln wird erläutert, wie du den Status eines Videos als „speziell für Kinder“ mithilfe des YouTube Data API-Dienstes nachschlagen kannst.

Im Zusammenhang mit diesen Änderungen wurde der Dokumentation zu Parametern für den eingebetteten Player ein Hinweis hinzugefügt, dass die Wiedergabe bei Aktivierung von Autoplay ohne Nutzerinteraktion mit dem Player erfolgt. Die Erfassung und Weitergabe von Wiedergabedaten erfolgt daher beim Seitenaufbau.

8. Oktober 2020

Dieses Update umfasst drei kleine Änderungen in Bezug auf die Ressource channel:

  • Das Objekt snippet.thumbnails, das die Thumbnail-Bilder eines Kanals identifiziert, ist bei neu erstellten Kanälen möglicherweise leer und es kann bis zu einem Tag dauern, bis es angezeigt wird.
  • Die Property statistics.videoCount gibt nur die Anzahl der öffentlichen Videos des Kanals an, selbst für die Inhaber. Dieses Verhalten entspricht der Anzahl, die auf der YouTube-Website angezeigt wird.
  • Channel-Keywords, die in der Eigenschaft brandingSettings.channel.keywords angegeben sind, werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder Anführungszeichen ohne Escapezeichen enthalten ("). Die Begrenzung auf 500 Zeichen ist nicht pro Keyword, sondern auf die Gesamtlänge aller Keywords begrenzt. Dieses Verhalten entspricht dem auf der YouTube-Website.

9. September 2020

Hinweis: Diese Mitteilung wird verworfen.

Dieses Update umfasst die folgenden API-Änderungen. Alle Änderungen treten am oder nach dem 9. September 2020, dem Datum dieser Mitteilung, in Kraft. Daher sollten sich Entwickler nicht mehr auf die unten aufgeführten API-Funktionen verlassen.

  • Die folgenden API-Ressourcen, Methoden, Parameter und Ressourcenattribute werden sofort eingestellt und funktionieren ab dem Datum dieser Ankündigung nicht mehr:
    • Die folgenden channel-Ressourcenattribute:
      • Das Attribut statistics.commentCount
      • Das Objekt brandingSettings.image und alle seine untergeordneten Attribute
      • Die Liste brandingSettings.hints und alle ihre untergeordneten Properties
    • Der Filterparameter categoryId der Methode channels.list
    • Die Ressource guideCategories und die Methode guideCategories.list
  • API-Antworten für die Methode channels.list enthalten nicht mehr das Attribut prevPageToken, wenn die API-Anfrage den Parameter managedByMe auf true setzt. Diese Änderung wirkt sich weder auf das Attribut prevPageToken für andere channels.list-Anfragen noch auf das Attribut nextPageToken bei anderen Anfragen aus.
  • Die Attribute contentDetails.relatedPlaylists.watchLater und contentDetails.relatedPlaylists.watchHistory der Ressource channel wurden am 11. August 2016 als verworfen angekündigt. Auch die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurde vollständig eingestellt. Die beiden Properties wurden aus der Dokumentation entfernt.
  • Der Parameter mySubscribers der Methode channels.list, der am 30. Juli 2013 als veraltet angekündigt wurde, wurde aus der Dokumentation entfernt. Verwenden Sie die Methode subscriptions.list und den zugehörigen Parameter mySubscribers, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen.
  • Das invideoPromotion-Objekt der Ressource channel und alle untergeordneten Attribute, die am 27. November 2017 als veraltet angekündigt wurden, wurden aus der Dokumentation entfernt.

29. Juli 2020

Wir haben unser Verfahren zur Berechnung von Kontingenten für API-Anfragen vereinfacht, indem wir die zusätzlichen Kosten im Zusammenhang mit dem Parameter part entfallen. Ab sofort werden nur noch die Grundkosten für die aufgerufene Methode berechnet. Weitere Informationen zum vereinfachten Kontingent finden Sie hier.

Diese Änderung hat zur Folge, dass die Kontingentkosten für die meisten API-Aufrufe geringfügig niedriger sind, während für einige API-Aufrufe weiterhin die gleichen Kosten anfallen. Durch diese Änderung erhöhen sich nicht die Kosten für API-Aufrufe. Die wahrscheinliche Auswirkung ist insgesamt, dass Sie mit Ihrem zugewiesenen Kontingent, das Sie in der Google Cloud Console sehen können, noch mehr gehen wird.

Wir empfehlen allen Entwicklern dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, um weiterhin den Zugriff auf die YouTube API-Dienste zu ermöglichen.

Dieser Überarbeitungsverlauf wurde ursprünglich am 20. Juli 2020 veröffentlicht.

28. Juli 2020

Alle Videos, die über den Endpunkt videos.insert aus nicht verifizierten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Modus beschränkt. Damit diese Einschränkung aufgehoben werden kann, muss jedes Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu verifizieren.

Creator, die Videos über einen nicht verifizierten API-Client hochladen, erhalten eine E-Mail, in der erklärt wird, dass ihr Video als privat gesperrt ist und sie die Einschränkung durch die Verwendung eines offiziellen oder geprüften Clients vermeiden können.

API-Projekte, die vor dem 28. Juli 2020 erstellt wurden, sind derzeit nicht von dieser Änderung betroffen. Wir empfehlen allen Entwicklern jedoch dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, um weiterhin den Zugriff auf die YouTube API-Dienste sicherzustellen.

21. Juli 2020

[Aktualisiert am 28. Juli 2020.] Die Aktualisierung der Dokumentation, auf die in diesem Überarbeitungsverlaufseintrag verwiesen wird, wurde am 28. Juli 2020 neu veröffentlicht.

Gestern haben wir eine aktualisierte Dokumentation zu unserem Prozess zur Berechnung von Kontingenten veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Kontingentänderung jedoch noch nicht wirksam. Aus diesem Grund wurde die Dokumentation im Interesse der Richtigkeit zurückgesetzt. Der Überarbeitungsverlauf, in dem die Änderung erläutert wird, wurde entfernt und in naher Zukunft wieder veröffentlicht, um Verwechslungen zu vermeiden.

7. Juli 2020

Hinweis: Diese Mitteilung wird verworfen.

Die Parameter autoLevels und stabilize der Methode videos.insert wurden verworfen und beide Parameter wurden aus der Dokumentation entfernt. Ihre Werte werden ignoriert und haben keinen Einfluss auf die Verarbeitung neu hochgeladener Videos.

15. Juni 2020

Der neue Leitfaden Einhaltung der YouTube-Richtlinien für Entwickler enthält Anleitungen und Beispiele, mit denen du dafür sorgen kannst, dass deine API-Clients bestimmte Teile der Nutzungsbedingungen und Richtlinien (API-Nutzungsbedingungen) der YouTube API-Dienste einhalten.

In diesem Leitfaden erfährst du, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt. Es werden jedoch keine vorhandenen Dokumente ersetzt. In diesem Leitfaden finden Sie Antworten auf einige der häufigsten Fragen, die Entwickler bei API-Compliance-Audits stellen. Wir hoffen, dass dies die Entwicklung von Features für Sie vereinfacht, denn sie soll Ihnen helfen zu verstehen, wie wir unsere Richtlinien interpretieren und durchsetzen.

4. Juni 2020

Hinweis:Dies ist ein Update zu einer früheren Einstellungsankündigung.

Die Funktion für Kanalbulletins wurde vollständig eingestellt. Diese Änderung wurde ursprünglich am 17. April 2020 angekündigt und ist jetzt in Kraft getreten. Daher wird die Methode activities.insert nicht mehr unterstützt und die Methode activities.list gibt keine Kanalbulletins mehr zurück. Weitere Informationen finden Sie in der YouTube-Hilfe.

17. April 2020

Hinweis: Diese Mitteilung wird verworfen.

YouTube stellt die Funktion für Kanalbulletins ein. Daher wird die Methode activities.insert eingestellt und die Methode activities.list gibt keine Kanalbulletins mehr zurück. Diese Änderungen treten am oder nach dem 18. Mai 2020 in der API in Kraft. Weitere Informationen finden Sie in der YouTube-Hilfe.

31. März 2020

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die neue member-Ressource stellt ein Kanalmitglied für einen YouTube-Kanal dar. 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.

      Diese Ressource ersetzt die Ressource sponsor, die als Teil der YouTube Live Streaming API dokumentiert ist. Die Ressource sponsor wurde verworfen. API-Clients sollten Aufrufe an die Methode sponsors.list aktualisieren, um stattdessen die Methode members.list zu verwenden.

    • Die neue membershipsLevel-Ressource gibt eine Preisstufe an, die von dem Ersteller verwaltet wird, der die API-Anfrage autorisiert hat. Mit der Methode membershipsLevels.list wird eine Liste aller Mitgliedschaftsstufen des Erstellers abgerufen.

10. Januar 2020

Die API unterstützt jetzt die Identifizierung von Inhalten, die auf Kinder ausgerichtet sind. Dies wird von YouTube als „speziell für Kinder“ bezeichnet. Weitere Informationen zu Inhalten speziell für Kinder findest du in der YouTube-Hilfe.

Die Ressourcen channel und video unterstützen zwei neue Properties, mit denen Creator und Zuschauer Inhalte erkennen können, die speziell für Kinder erstellt wurden:

  • Mit der Property selfDeclaredMadeForKids können Creator angeben, ob ein Kanal oder Video speziell für Kinder erstellt wurde.

    Bei Channels kann dieses Attribut festgelegt werden, wenn die Methode channels.update aufgerufen wird. Bei Videos kann dieses Attribut festgelegt werden, wenn die Methode videos.insert oder videos.update aufgerufen wird.

    Dieses Attribut ist nur dann in API-Antworten enthalten, die channel- oder video-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
  • Mit der Property madeForKids kann jeder Nutzer den Status „speziell für Kinder“ eines Kanals oder Videos abrufen. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.

Außerdem haben wir die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen findest du in den Nutzungsbedingungen für die YouTube API-Dienste – Überarbeitungsverlauf. Die Änderungen an den Nutzungsbedingungen und Richtlinien für Entwickler der YouTube API-Dienste treten am 10. Januar 2020 (UTC -8) in Kraft.

10. September 2019

Die API-Referenzdokumentation wurde aktualisiert, um eine Änderung an der Art und Weise zu berücksichtigen, wie Abonnentenzahlen auf YouTube und folglich auch in API-Antworten gemeldet werden. Infolge dieser Änderung werden die vom YouTube Data API-Dienst zurückgegebenen Abonnentenzahlen auf drei signifikante Stellen abgerundet, wenn die Abonnentenzahlen größer als 1.000 Abonnenten sind. Diese Änderung wirkt sich auf das Attribut statistics.subscriberCount der Ressource channel aus.

Hinweis:Diese Änderung wirkt sich auch dann auf diesen Attributwert aus, wenn ein Nutzer eine autorisierte Anfrage für Daten zu seinem eigenen Kanal sendet. Kanalinhaber können die exakten Abonnentenzahlen weiterhin in YouTube Studio sehen.

Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, enthält die Property statistics.subscriberCount den Wert 123000. Die folgende Tabelle zeigt Beispiele dafür, wie Abonnentenzahlen in API-Antworten gerundet und in anderen öffentlich sichtbaren YouTube-Benutzeroberflächen abgekürzt werden:

Abonnentenzahl YouTube Data API Öffentlich sichtbare YouTube-Benutzeroberflächen
1.234 1230 1230
12.345 12300 12.300
123.456 123000 123.000
1.234.567 1230000 1,23 Mio.
12.345.678 12300000 12,3 Mio.
123,456,789 123000000 123 Mio.

4. April 2019

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um häufige Anwendungsfälle für jede Methode besser zu erläutern und dynamische, hochwertige Codebeispiele über das APIs Explorer-Widget bereitzustellen. Ein Beispiel finden Sie in der Dokumentation zur Methode channels.list. Es gibt jetzt zwei neue Elemente auf Seiten, die API-Methoden beschreiben:

    • Mit dem APIs Explorer-Widget können Sie Autorisierungsbereiche auswählen, Beispielparameter und Eigenschaftswerte eingeben, dann tatsächliche API-Anfragen senden und die tatsächlichen API-Antworten ansehen. Das Widget bietet auch eine Vollbildansicht mit vollständigen Codebeispielen, die dynamisch aktualisiert werden, um die von Ihnen eingegebenen Bereiche und Werte zu verwenden.

    • Im Abschnitt Häufige Anwendungsfälle werden ein oder mehrere gängige Anwendungsfälle für die auf der Seite erläuterte Methode beschrieben. Sie können beispielsweise die Methode channels.list aufrufen, um Daten über einen bestimmten Kanal oder Daten über den Kanal des aktuellen Nutzers abzurufen.

      Über die Links in diesem Abschnitt können Sie den APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder den Vollbild APIs Explorer mit diesen Werten öffnen. Diese Änderungen sollen es Ihnen erleichtern, Codebeispiele zu sehen, die direkt auf den Anwendungsfall anwendbar sind, den Sie in Ihrer eigenen Anwendung implementieren möchten.

    Codebeispiele werden derzeit für Java, JavaScript, PHP, Python und curl unterstützt.

  • Das Tool Codebeispiele wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python abzurufen.

    Im Zusammenhang mit dieser Änderung wurden die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, JavaScript, PHP und Python aufgeführt waren.

  • Die Kurzanleitungen für Java, JavaScript, PHP und Python wurden aktualisiert. In den überarbeiteten Anleitungen wird anhand von Codebeispielen aus dem APIs Explorer erläutert, wie Sie ein Beispiel mit einem API-Schlüssel und ein weiteres Beispiel mit einer OAuth 2.0-Client-ID ausführen.

Die oben beschriebenen Änderungen ersetzen ein interaktives Tool, das 2017 der API-Dokumentation hinzugefügt wurde.

9. Juli 2018

Dieses Update enthält die folgenden Änderungen:

  • Die Definition der snippet.thumbnails-Eigenschaft der channel-Ressource wurde aktualisiert. Wenn nun Miniaturansichten in Ihrer Anwendung angezeigt werden, sollten die Bild-URLs in Ihrem Code genau so verwendet werden, wie sie in API-Antworten zurückgegeben werden. Ihre Anwendung sollte in einer URL, die in einer API-Antwort zurückgegeben wird, beispielsweise nicht die Domain http anstelle der Domain https verwenden.

    Ab Juli 2018 sind URLs von Kanal-Thumbnails nur noch in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. Danach werden in deiner Anwendung möglicherweise fehlerhafte Bilder angezeigt, wenn sie versucht, YouTube-Bilder aus der Domain http zu laden.

  • Hinweis: Diese Mitteilung wird verworfen.

    Das Attribut recordingDetails.location.altitude der Ressource video wurde eingestellt. Es gibt keine Garantie, dass Videos Werte für diese Eigenschaft zurückgeben. Auch wenn API-Anfragen versuchen, einen Wert für dieses Attribut festzulegen, ist es möglich, dass die eingehenden Daten nicht gespeichert werden.

22. Juni 2018

Der Implementierungsleitfaden (ehemals Implementierungs- und Migrationsleitfaden) wurde aktualisiert und enthält nun keine Anleitungen für die Migration von der API V2 zur API 3. Außerdem wurden Anleitungen für Funktionen entfernt, die in der v3 API eingestellt wurden, z. B. Lieblingsvideos.

27. November 2017

Dieses Update enthält die folgenden Änderungen:

  • Hinweis: Diese Mitteilung wird verworfen.

    YouTube entfernt den Support für die Funktionen Angesagtes Video und Empfohlene Website, die in der API über das invideoPromotion-Objekt der Ressource channel unterstützt werden. Aus diesem Grund wird dieses Objekt einschließlich aller untergeordneten Eigenschaften eingestellt.

    Sie können noch bis zum 14. Dezember 2017 invideoPromotion-Daten abrufen und festlegen. Nach diesem Datum:

    • Versuche, den invideoPromotion-Teil abzurufen, wenn channels.list aufgerufen wird, geben ein leeres invideoPromotion oder gar keine invideoPromotion-Daten zurück.
    • Wenn versucht wird, invideoPromotion-Daten beim Aufrufen von channels.update zu aktualisieren, wird bis mindestens 27. Mai 2018 eine erfolgreiche Antwort zurückgegeben. Sie werden jedoch als managementfrei behandelt, d. h., sie führen keine Aktualisierung durch.

    Nach dem 27. Mai 2018 kann es vorkommen, dass bei diesen Anfragen Fehlermeldungen angezeigt werden, die beispielsweise darauf hinweisen, dass invalidPromotion ein ungültiger Teil ist.

16. November 2017

Dieses Update enthält die folgenden Änderungen:

  • Das interaktive Code-Snippet-Tool unterstützt jetzt Node.js-Codebeispiele. Die Beispiele sind auch in der Dokumentation für fast alle API-Methoden verfügbar, z. B. für die Methode channels.list.

    Die anpassbaren Beispiele sollen Ihnen einen fallspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktion ähnelt dem Code in der Node.js-Kurzanleitung. Die Beispiele enthalten jedoch einige Dienstprogrammfunktionen, die in der Kurzanleitung nicht enthalten sind:

    • Mit der Funktion removeEmptyParameters wird eine Liste von Schlüssel/Wert-Paaren erstellt, die API-Anfrageparametern entsprechen, und entfernt die Parameter, die keine Werte haben.
    • Die Funktion createResource erstellt eine Liste von Schlüssel/Wert-Paaren, die den Attributen in einer API-Ressource entsprechen. Anschließend werden die Attribute in ein JSON-Objekt konvertiert, das in insert- und update-Vorgängen verwendet werden kann. Das folgende Beispiel zeigt eine Reihe von Attributnamen und -werten sowie das JSON-Objekt, das der Code dafür erstellen würde:
      # Key-value pairs:
      {'id': 'ABC123',
       'snippet.title': 'Resource title',
       'snippet.description': 'Resource description',
       'status.privacyStatus': 'private'}
      
      # JSON object:
      {
       'id': 'ABC123',
       'snippet': {
         'title': 'Resource title',
         'description': 'Resource description',
       },
       'status': {
         'privacyStatus': 'private'
       }
      }

    Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Weitere Informationen zu den Voraussetzungen für die lokale Ausführung vollständiger Codebeispiele finden Sie in der Anleitung zum Code-Snippet-Tool.

25. Oktober 2017

Dieses Update enthält die folgenden Änderungen:

  • Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert, um die Bibliotheken google-auth und google-auth-oauthlib anstelle der mittlerweile eingestellten oauth2client-Bibliothek zu verwenden.

    Zusätzlich zu dieser Änderung stellt das Tool jetzt vollständige Codebeispiele für installierte Python-Anwendungen und Python-Webserveranwendungen bereit, die leicht unterschiedliche Autorisierungsabläufe verwenden. So rufen Sie die vollständigen Beispiele (und diese Änderung) auf:

    1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode auf, z. B. die channels.list-Methode.
    2. Klicken Sie über den Codebeispielen auf den Tab Python.
    3. Klicken Sie auf die Ein-/Aus-Schaltfläche über den Tabs, um von der Anzeige eines Snippets zu einem vollständigen Beispiel zu wechseln.
    4. Auf dem Tab sollte jetzt ein vollständiges Codebeispiel angezeigt werden, in dem der Autorisierungsablauf InstalledAppFlow verwendet wird. Die Beschreibung über dem Beispiel erklärt dies und enthält auch einen Link zu einem Beispiel für eine Webserveranwendung.
    5. Klicken Sie auf den Link, um zum Webserverbeispiel zu wechseln. In diesem Beispiel werden das Flask-Framework für Webanwendungen und ein anderer Autorisierungsablauf verwendet.

    Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Wenn Sie die Beispiele ausführen möchten, lesen Sie die Anleitung zum lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.

29. August 2017

Dieses Update enthält die folgenden Änderungen:

  • Die Definition des Parameters forContentOwner der Methode search.list wurde aktualisiert. Wenn dieser Parameter auf true gesetzt ist, muss der Parameter type auf video festgelegt werden.
  • Die Definition des regionCode-Parameters der Methode search.list wurde aktualisiert, um zu verdeutlichen, dass der Parameter Suchergebnisse auf Videos beschränkt, die in der angegebenen Region angesehen werden können.
  • YouTube hat seine Branding-Logos und -Symbole aktualisiert. Neue Logos von „entwickelt mit YouTube“ können auf der Seite Branding-Richtlinien heruntergeladen werden. Andere neue YouTube-Logos und -Symbole werden ebenfalls auf dieser Seite angezeigt und können von der YouTube-Markenwebsite heruntergeladen werden.

24. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • Eine neue YouTube Data API-Kurzanleitung ist für iOS verfügbar. In diesem Leitfaden wird die Verwendung der YouTube Data API in einer einfachen iOS-Anwendung erläutert, die entweder in Objective-C oder Swift geschrieben wurde.
  • Das interaktive Code-Snippet-Tool für die YouTube Data API enthält jetzt eine Dokumentation zur Erläuterung einiger Funktionen des Tools:
    • API-Anfragen ausführen
    • Zwischen Code-Snippets und vollständigen Codebeispielen wechseln
    • Boilerplate-Funktionen verwenden
    • Vorhandene Ressourcen laden (für Updatemethoden)

    Hinweis:Das Tool ist auch in die API-Referenzdokumentation für API-Methoden eingebettet (Beispiel).

1. Juni 2017

Dieses Update enthält die folgenden Änderungen:

17. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um Code-Snippets umfassender und interaktiver zu gestalten. Seiten, auf denen API-Methoden wie channels.list oder videos.rate erläutert werden, enthalten jetzt ein interaktives Tool, mit dem sich Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen lassen.

    Für jede Methode zeigt das Tool Code-Snippets für einen oder mehrere Anwendungsfälle an. In jedem Anwendungsfall wird eine gängige Methode zum Aufrufen dieser Methode beschrieben. Sie können beispielsweise die Methode channels.list aufrufen, um Daten zu einem bestimmten Kanal oder zum Kanal des aktuellen Nutzers abzurufen.

    Sie können auch mit Codebeispielen interagieren:

    • Wenn Sie Parameter- und Attributwerte ändern, werden die Code-Snippets dynamisch an die von Ihnen angegebenen Werte angepasst.

    • Zwischen Code-Snippets und vollständigen Beispielen wechseln Ein Code-Snippet zeigt den Teil des Codes, mit dem die API-Methode aufgerufen wird. Ein vollständiges Beispiel enthält dieses Snippet sowie Boilerplate-Code zum Autorisieren und Senden von Anfragen. Vollständige Beispiele können über die Befehlszeile oder einen lokalen Webserver kopiert und ausgeführt werden.

    • Anfragen können durch Klicken auf eine Schaltfläche ausgeführt werden. (Zum Ausführen von Anfragen müssen Sie das Tool autorisieren, die API in Ihrem Namen aufzurufen.)

    Beachten Sie, dass dieses Tool den APIs Explorer auf den Seiten, auf denen es verfügbar ist, ersetzt hat. Auf jeder Seite wird ein Link angezeigt, sodass Sie auch die Anfrage, an der Sie arbeiten, im APIs Explorer laden können.

  • Das Tool Data API Code Snippets wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Die wichtigsten neuen Funktionen auf dieser Seite sind:

    • Unterstützung für API-Anfragen, die Daten schreiben.
    • Unterstützung für Java-Beispiele.
    • Flexibler und umfassender Boilerplate-Code für die Autorisierung von Nutzern und die Erstellung von API-Anfragen

27. April 2017

Dieses Update enthält die folgenden Änderungen:

30. März 2017

Dieses Update enthält die folgenden Änderungen:

  • Die neue topicDetails.topicCategories[]-Eigenschaft der channel-Ressource enthält eine Liste von Wikipedia-URLs, die die Inhalte des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die im Attribut topicDetails.topicIds[] der Ressource zurückgegeben werden.
  • Die neue contentDetails.videoPublishedAt-Property der playlistItem-Ressource gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits das Attribut snippet.publishedAt, das den Zeitpunkt angibt, zu dem das Element der Playlist hinzugefügt wurde.
  • Wie die Ressource channel gibt auch die Ressource video jetzt die Eigenschaft topicDetails.topicCategories[] zurück, die eine Liste von Wikipedia-URLs enthält, die den Inhalt des Videos beschreiben. Bei Ressourcen vom Typ video entsprechen die URLs den Themen-IDs, die im Attribut topicDetails.relevantTopicIds[] der Ressource zurückgegeben werden.
  • Das neue Attribut contentDetails.contentRating.mpaatRating der video-Ressource gibt die Bewertung an, die die Motion Picture Association of America für einen Filmtrailer oder eine Filmvorschau vergeben hat.

27. Februar 2017

Wie ursprünglich am 11. August 2016 angekündigt, hat YouTube die unterstützte Liste von Themen-IDs auf eine ausgewählte Liste umgestellt. Die vollständige Liste der unterstützten Themen-IDs finden Sie in den topicDetails-Attributen für die Ressourcen channel und video sowie im Parameter topicId der Methode search.list.

An der ausgewählten Liste gibt es einige Änderungen:

  • Die folgenden Themen wurden als Unterthemen von Society hinzugefügt:
    NameThemen-ID
    Unternehmen/m/09s1f
    Zustand/m/0kt51
    Militär/m/01h6rj
    Politik/m/05qt0
    Religion/m/06bvp
  • Das Thema Animated cartoon, das zuvor Entertainment untergeordnet war, wurde entfernt.
  • Das Thema Children's music, das zuvor Music untergeordnet war, wurde entfernt.

Aufgrund dieser Änderung werden Themen, die sich auf ein Video beziehen, jetzt immer im Attributwert topicDetails.relevantTopicIds[] der video-Ressource zurückgegeben.

29. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Es gibt drei kleine Änderungen an der Liste der Themen-IDs, die ab dem 10. Februar 2017 unterstützt werden:

    • Die Kategorie Professional wrestling, die zuvor der Kategorie Sports untergeordnet war, ist jetzt ein untergeordnetes Element von Entertainment.
    • Die Kategorie TV shows, die Entertainment untergeordnet ist, ist neu.
    • Die Kategorie Health, die bisher Lifestyle untergeordnet war, wurde entfernt.

    Beachte auch, dass es einige übergeordnete Kategorien gibt (Entertainment, Gaming, Lifestyle, Music und Sports). Jedes Video, das einer untergeordneten Kategorie wie Tennis zugeordnet ist, wird auch dieser übergeordneten Kategorie (Sports) zugeordnet.

10. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Wie erst am 11. August 2016 angekündigt, sind aufgrund der Einstellung von Freebase und Freebase API mehrere Änderungen an den Themen-IDs erforderlich. Mit Themen-IDs werden Themen identifiziert, die mit channel- und video-Ressourcen verknüpft sind. Mit dem Suchparameter topicId können Sie auch nach Kanälen oder Videos zu einem bestimmten Thema suchen.

    Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Anzahl von Themen-IDs anstatt der bisher sehr detaillierteren IDs zurück. Beachten Sie außerdem, dass Kanäle und Videos nicht zwangsläufig mit Themen verknüpft werden, was dem aktuellen API-Verhalten entspricht.

    Damit Sie Ihre API-Clients auf diese Änderungen vorbereiten können, wurden die Definitionen der folgenden API-Parameter und -Eigenschaften aktualisiert, um die Themen-IDs aufzulisten, die nach dieser Zeit unterstützt werden. Die Liste der Kategorien ist für alle Unterkünfte gleich.

  • Hinweis: Diese Mitteilung wird verworfen.

    Die folgenden Attribute werden eingestellt:

    • Das Attribut topicDetails.topicIds[] der Ressource channel. Diese Property wird bis zum 10. November 2017 unterstützt.
    • Das Attribut topicDetails.relevantTopicIds[] der Ressource video. Diese Property wird bis zum 10. November 2017 unterstützt.
    • Das Attribut topicDetails.topicIds[] der Ressource video. Nach dem 10. Februar 2017 enthält dieses Attribut keine Werte mehr. Nach diesem Datum werden über den Property-Wert topicDetails.relevantTopicIds[] alle Themen identifiziert, die mit einem Video verknüpft sind.

  • Da Freebase bereits eingestellt wurde, wurde der Leitfaden Searching with Freebase Topics aus der Dokumentation entfernt. Dieser Leitfaden enthält Codebeispiele, die zeigen, wie eine Anwendung mit der Freebase API funktioniert.

    Außerdem wurden mehrere Codebeispiele zu Themen-IDs aus der Dokumentation der Methode search.list entfernt.

2. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Neue Properties und Parameter

    • Die Ressource video enthält mehrere neue Attribute:

      • Die Eigenschaft player.embedHtml enthält ein <iframe>-Tag, mit dem du einen Player einbetten kannst, der das Video abspielt. Die neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des eingebetteten Players an. Diese Attribute werden nur zurückgegeben, wenn in der API-Anfrage ein Wert für mindestens einen der Parameter maxHeight oder maxWidth angegeben ist. Diese beiden neuen Parameter werden weiter unten in diesem Eintrag zum Überarbeitungsverlauf erläutert.

      • Die neue hasCustomThumbnail-Property gibt an, ob der Video-Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar.

      • Im neuen fpbRatingReasons[] sind die Gründe aufgeführt, warum das Video die FPB-Bewertung (Südafrika) erhalten hat.

      • Das neue mcstRating gibt die Altersfreigabe an, die das Video in Vietnam erhalten hat.

    • Die Methode videos.list unterstützt zwei neue Parameter, maxHeight und maxWidth. Beim Abrufen des player-Teils in video-Ressourcen können Sie einen oder beide Parameter verwenden.

      Standardmäßig beträgt die Höhe des <iframe>, der im Attribut player.embedHtml zurückgegeben wird, 360 Pixel. Die Breite wird an das Seitenverhältnis des Videos angepasst. Dadurch wird sichergestellt, dass der eingebettete Player keine schwarzen Balken hat, die das Video umrahmen. Bei einem Video mit einem Seitenverhältnis von 16:9 beträgt die Breite des Players also 640 Pixel.

      Mit den neuen Parametern können Sie festlegen, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwenden soll, die dem Layout Ihrer Anwendung entsprechen. Der API-Server skaliert die Abmessungen des Players entsprechend, um sicherzustellen, dass der eingebettete Player keine schwarzen Balken hat, die das Video umrahmen. Beide Parameter geben die maximalen Abmessungen des eingebetteten Players an. Wenn also beide Parameter angegeben sind, kann eine Dimension trotzdem kleiner sein als der maximal zulässige Wert für diese Dimension.

      Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Wenn der Parameter maxHeight oder maxWidth nicht festgelegt ist, würde das player.embedHtml-Tag also einen Player mit der Größe 640 × 360 enthalten.

      • Wenn der Parameter maxHeight auf 720 und der Parameter maxWidth nicht festgelegt ist, gibt die API einen Player mit der Größe 1280 × 720 zurück.
      • Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight nicht festgelegt ist, gibt die API einen Player mit der Größe 960 × 540 zurück.
      • Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight auf 450 gesetzt ist, gibt die API einen Player mit der Größe 800 × 450 zurück.

      Die oben beschriebenen neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des Players an.

  • Änderungen an vorhandenen Methoden, Attributen und Parametern

    • Die Ressourcenbeschreibung channelSection wurde aktualisiert. Ein Kanal kann maximal 10 Bereiche erstellen, ohne Targeting-Daten festzulegen, und maximal 100 Bereiche mit Targeting-Daten erstellen.

      Außerdem wurde das Attribut targeting der channelSection-Ressource aktualisiert, um zu berücksichtigen, dass Targeting-Optionen nur mit der API festgelegt werden können. Die Ausrichtungsoptionen werden gelöscht, wenn der Kanalabschnitt über die Benutzeroberfläche der YouTube-Website geändert wird.

    • Die Definition der i18nLanguage-Eigenschaft snippet.name der Ressource wurde so korrigiert, dass der Wert den Namen einer Sprache darstellt, so wie er in der Sprache geschrieben ist, die im Parameter hl der Methode i18nLanguage.list angegeben ist.

    • Das Attribut contentDetails.note der Ressource playlistItem wurde aktualisiert. Die maximale Länge des Attributwerts beträgt 280 Zeichen.

    • Die Attribute contentDetails.startAt und contentDetails.endAt der Ressource playlistItem wurden verworfen. Diese Felder werden ignoriert, wenn sie in playlistItems.insert- oder playlistItems.update-Anfragen festgelegt sind.

    • Die Methoden playlistItems.delete und playlistItems.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen außerdem mit einem Token autorisiert werden, das Zugriff auf den Bereich https://www.googleapis.com/auth/youtubepartner bietet.

    • Die Parameter publishedBefore und publishedAfter der Methode search.list wurden aktualisiert, um anzuzeigen, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der Parameter publishedBefore festgelegt ist, gibt die API Ressourcen zurück, die vor oder um zur angegebenen Zeit erstellt wurden.

    • Das Attribut contentDetails.contentRating.grfilmRating der Ressource video unterstützt drei zusätzliche Werte: grfilmK12, grfilmK15 und grfilmK18.

    • Die Beschreibung der Methode videos.insert wurde aktualisiert. Die maximale Dateigröße für hochgeladene Videos wurde von 64 GB auf 128 GB erhöht.

  • Neue und aktualisierte Fehler

    • Die API unterstützt die folgenden neuen Fehler:

      Fehlertyp Fehlerdetails Beschreibung
      forbidden (403) homeParameterDeprecated Die Methode activities.list gibt diesen Fehler zurück, um anzugeben, dass die Aktivitätsdaten für die Startseite des Nutzers nicht über diese API verfügbar sind. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true gesetzt haben.
      invalidValue (400) invalidContentDetails Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das contentDetails-Objekt in der Anfrage ungültig ist. Dieser Fehler tritt möglicherweise auf, weil das Feld contentDetails.note mehr als 280 Zeichen enthält.
      forbidden (403) watchHistoryNotAccessible Die Methode playlistItems.list gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Playlist-Elemente aus dem Wiedergabeverlauf abzurufen. Diese können jedoch nicht mit der API abgerufen werden.
      forbidden (403) watchLaterNotAccessible Die Methode playlistItems.list gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Playlist-Elemente des Typs „Später ansehen“ abzurufen. Diese können jedoch nicht mit der API abgerufen werden.
      badRequest (400) uploadLimitExceeded Die Methode videos.insert gibt diesen Fehler zurück, um anzuzeigen, dass der Kanal die maximale Anzahl von Videos überschritten hat, die hochgeladen werden können.
      forbidden (403) forbiddenEmbedSetting Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass die API-Anfrage versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Hinweis: Einige Kanäle sind möglicherweise nicht berechtigt, eingebettete Player für Livestreams anzubieten. Weitere Informationen findest du in der YouTube-Hilfe.
    • Die Methode playlistItems.insert gibt keinen Fehler mehr zurück, wenn du ein doppeltes Video in eine Playlist einfügst. Dieser Fehler ist zuvor bei einigen Playlists (z. B. Lieblingsvideos) aufgetreten, bei denen Duplikate nicht erlaubt waren, die aber nicht mehr unterstützt werden. Im Allgemeinen sind doppelte Videos in Playlists zulässig.

  • Weitere Neuerungen

    • Der Überarbeitungsverlaufseintrag für den 15. September 2016 wurde aktualisiert, um zu verdeutlichen, dass immer die Werte HL bzw. WL enthalten sind, wenn die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel in einer Antwort enthalten sind. Außerdem werden diese Eigenschaften nur dann einbezogen, wenn ein autorisierter Nutzer Daten über den eigenen Kanal des Nutzers abruft.

15. September 2016

Dieses Update enthält die folgenden Änderungen:

  • Im Rahmen der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 wurden mehrere Änderungen an den Themen-IDs vorgenommen. Unter anderem wurden die unterstützten Themen-IDs ab dem 10. Februar 2017 geändert. Die Liste der unterstützten Themen wird bis zum 10. November 2016 veröffentlicht.

  • Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden im Rahmen der Aktualisierung des Überarbeitungsverlaufs am 11. August 2016 angekündigt:

    • Wenn die Methode activities.list aufgerufen wird und der Parameter home auf true gesetzt ist, enthält die API-Antwort jetzt ähnliche Elemente wie ein abgemeldeter YouTube-Nutzer auf der Startseite.

      Dabei handelt es sich um eine kleine Änderung, die eine bessere Nutzererfahrung bieten soll, als in der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 beschrieben. Die Aktualisierung hatte ergeben, dass bei Anfragen mit dem Parameter home eine leere Liste zurückgegeben wird.

    • Die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel enthalten jetzt die Werte HL bzw. WL für alle Channels.

      Diese Eigenschaften sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal des Nutzers abruft. Die Attribute enthalten immer die Werte HL und WL, auch wenn ein autorisierter Nutzer Daten über den eigenen Kanal abruft. Daher können der Wiedergabeverlauf und die Playlist-IDs für „Später ansehen“ nicht über die API abgerufen werden.

      Außerdem werden bei Anfragen zum Abrufen von Playlist-Details (playlists.list) oder Playlist-Elementen (playlistItems.list) für den Wiedergabeverlauf eines Kanals oder die Playlist „Später ansehen“ jetzt leere Listen zurückgegeben. Dieses Verhalten gilt für die neuen Werte HL und WL sowie für alle IDs des Wiedergabeverlaufs oder der Playlist „Später ansehen“, die möglicherweise bereits in deinem API-Client gespeichert wurden.

  • Das fileDetails.recordingLocation-Objekt der Ressource video und ihre untergeordneten Attribute werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnete fileDetails-Objekt) nur vom Eigentümer eines Videos abgerufen werden.

11. August 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neu veröffentlichten Nutzungsbedingungen der YouTube API-Dienste („Aktualisierte Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

    Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Außerdem werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder dieser ergänzenden Dokumente im Überarbeitungsverlauf erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Überarbeitungsverlauf aufgeführt sind.

  • Die Einstellung von Freebase und Freebase API führt zu mehreren Änderungen in Bezug auf die Themen-IDs. Themen-IDs werden in den folgenden API-Ressourcen und -Methoden verwendet:

    • Der topicDetails-Teil der channel-Ressource identifiziert Themen, die mit dem Kanal verknüpft sind.
    • Der topicDetails-Teil der video-Ressource identifiziert Themen, die mit dem Video verknüpft sind.
    • Mit dem Parameter topicId der Methode search.list können Sie nach Videos oder Kanälen zu einem bestimmten Thema suchen.

    Änderungen an diesen Funktionen:

    • Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Anzahl von Themen-IDs anstelle der detaillierteren IDs zurück. Dabei werden allgemeine Kategorien wie Sport oder Basketball identifiziert, aber beispielsweise keine bestimmten Teams oder Spieler. Wir werden die unterstützten Themen bekannt geben, damit Sie Zeit haben, Ihre Bewerbung auf diese Änderung vorzubereiten.

    • Alle bereits abgerufenen Freebase-Themen-IDs können bis zum 10. Februar 2017 für die Suche nach Inhalten verwendet werden. Danach können Sie jedoch nur noch die kleinere Gruppe von Themen verwenden, die im vorherigen Element angegeben wurden, um Suchergebnisse nach Thema abzurufen.

    • Wenn Sie nach dem 10. Februar 2017 versuchen, mit einer Themen-ID zu suchen, die nicht zu einer der kleineren unterstützten Themen-IDs gehört, gibt die API einen leeren Ergebnissatz zurück.

  • Mehrere API-Felder und -Parameter werden am 12. September 2016 eingestellt:

    • Mit dem Parameter home der Methode activities.list konnte ein autorisierter Nutzer den Aktivitätsfeed abrufen, der für diesen Nutzer auf der YouTube-Startseite angezeigt werden würde. Bei Anfragen, in denen dieser Parameter nach dem 12. September 2016 verwendet wird, wird eine leere Liste zurückgegeben.

    • Die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal des Nutzers abruft. Nach dem 12. September 2016 gibt contentDetails.relatedPlaylists.watchHistory den Wert HL und die Property contentDetails.relatedPlaylists.watchLater für alle Kanäle den Wert WL zurück.

      Bei Anfragen zum Abrufen von Playlist-Details (playlists.list) für den Wiedergabeverlauf eines Kanals oder die Playlist „Später ansehen“ wird nach dem 12. September 2016 eine leere Liste zurückgegeben. Bei Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list) in einer dieser Playlists wird ebenfalls eine leere Liste zurückgegeben. Dies gilt für die neuen Werte HL und WL sowie für alle IDs des Wiedergabeverlaufs oder der Playlist „Später ansehen“, die bereits in deinem API-Client gespeichert wurden.

    • Das fileDetails.recordingLocation-Objekt der Ressource video oder eine ihrer untergeordneten Properties wird nach dem 12. September 2016 nicht mehr zurückgegeben. Diese Daten können nur vom Rechteinhaber eines Videos abgerufen werden, da das übergeordnete fileDetails-Objekt nur von einem Videoinhaber abgerufen werden kann.

13. Juni 2016

Dieses Update enthält die folgenden Änderungen:

  • Das Attribut contentDetails.googlePlusUserId der Ressource channel wurde eingestellt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+ Profil verknüpft war. Nach der Einstellung ist die Property nicht mehr in channel-Ressourcen enthalten.

  • Das Attribut snippet.authorGoogleplusProfileUrl der Ressource comment wurde eingestellt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+ Profil verknüpft war. Nach der Einstellung ist die Property nicht mehr in comment-Ressourcen enthalten.

Da nach der Einstellung keines dieser Attribute zurückgegeben wird, wurden beide aus der entsprechenden Ressourcendokumentation entfernt.

31. Mai 2016

Dieses Update enthält die folgenden Änderungen:

  • Mit dem neuen myRecentSubscribers-Parameter der Methode subscriptions.list wird eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge des Zeitpunkts abgerufen, zu dem der Kanal abonniert wurde.

    Mit dem neuen Parameter können nur die letzten 1.000 Abonnenten des Kanals des authentifizierten Nutzers abgerufen werden. Verwenden Sie den Parameter mySubscribers, um eine vollständige Liste der Abonnenten abzurufen. Dieser Parameter, der keine Abonnenten in einer bestimmten Reihenfolge zurückgibt, begrenzt nicht die Anzahl der abzurufenden Abonnenten.

  • Die Definition der Eigenschaft snippet.thumbnails.(key) wurde für die Ressourcen activity, playlistItem, playlist, Suchergebnis, thumbnail und video aktualisiert. Für einige Videos sind zusätzliche Miniaturansichtsgrößen verfügbar.

    • Das Bild „standard“ ist 640 Pixel breit und 480 Pixel hoch.
    • Das Bild „maxres“ ist 1.280 Pixel breit und 720 Pixel hoch.
  • Die Definition des Parameters part der Methode channelSection.list wurde aktualisiert. Der targeting-Teil kann zu einem Preis von 2 Kontingenteinheiten abgerufen werden.

  • Die Methode videos.list gibt jetzt den Fehler verboten (403) zurück, wenn eine falsch autorisierte Anfrage versucht, die Teile fileDetails, processingDetails oder suggestions einer video-Ressource abzurufen. Diese Teile sind nur für den Rechteinhaber des Videos verfügbar.

17. Mai 2016

Das neue Tool Data API Code Snippets bietet kurze Code-Snippets für häufige Anwendungsfälle der YouTube Data API. Code-Snippets sind derzeit für alle schreibgeschützten API-Methoden in Apps Script, Go, JavaScript, PHP, Python und Ruby verfügbar.

Das Tool zeigt für jede Methode Codebeispiele für einen oder mehrere Anwendungsfälle an. Beispielsweise werden fünf Code-Snippets für die Methode search.list bereitgestellt:

  • Videos nach Keyword auflisten
  • Videos nach Standort auflisten
  • Live-Veranstaltungen auflisten
  • Nach Videos des authentifizierten Nutzers suchen
  • Ähnliche Videos auflisten

Für jeden Anwendungsfall zeigt das Tool die in der API-Anfrage verwendeten Parameter an. Sie können die Parameterwerte ändern. In diesem Fall aktualisiert das Tool die Code-Snippets entsprechend den angegebenen Parameterwerten.

Schließlich zeigt das Tool die API-Antwort auf jede Anfrage an. Wenn Sie die Anfrageparameter geändert haben, basiert die API-Antwort auf den von Ihnen bereitgestellten Parameterwerten. Sie müssen das Tool autorisieren, in Ihrem Namen Anfragen zu senden, damit API-Antworten angezeigt werden.

28. April 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neue contentDetails.projection-Eigenschaft der video-Ressource gibt das Projektionsformat des Videos an. Gültige Attributwerte sind 360 und rectangular.

  • Die Attribute recordingDetails.location und fileDetails.recordingLocation der Ressource video wurden aktualisiert, um den Unterschied zwischen den beiden Attributen zu erläutern:

    • Die recordingDetails.location-Property gibt den Standort an, den der Videoinhaber dem Video zuordnen möchte. Dieser Ort kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern bei öffentlichen Videos angezeigt werden.
    • Der Eigenschaftswert fileDetails.recordingLocation ist unveränderlich und stellt den Speicherort der hochgeladenen Originalvideodatei dar. Der Wert ist nur für den Videoinhaber sichtbar.

  • Die Definition der Eigenschaft channel der Ressource contentDetails.relatedPlaylists.favorites wurde aktualisiert, um zu beachten, dass der Eigenschaftswert möglicherweise eine Playlist-ID enthält, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Lieblingsvideos“ bereits eingestellt wurde. Diese Eigenschaft unterliegt nicht der Richtlinie zur Einstellung der API.

  • Die Definition des Fehlers ineligibleAccount, die von der Methode comments.insert, comments.update, commentThreads.insert oder commentThreads.update zurückgegeben werden kann, wurde aktualisiert, um zu verdeutlichen, dass der Fehler auftritt, wenn das zur Autorisierung der API-Anfrage verwendete YouTube-Konto nicht mit dem Google-Konto des Nutzers zusammengeführt wurde.

20. April 2016

Dieses Update enthält die folgenden Änderungen:

  • Die Definition des part-Parameters der channels.update-Methode wurde aktualisiert, um anzugeben, dass localizations auch ein gültiger Wert für diesen Parameter ist.

  • Der Abschnitt Kontingentnutzung des Startleitfadens wurde aktualisiert und mit der Google Developers Console verknüpft, wo Sie Ihre tatsächliche Kontingent- und Kontingentnutzung einsehen können.

16. März 2016

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Die channelBanner-Ressourcendokumentation wurde aktualisiert. Die empfohlene Größe für das hochgeladene Kanalbannerbild beträgt 2.560 x 1.440 Pixel. Die Mindestgröße (2048 x 1152 Pixel) hat sich nicht geändert.

    • Das neue Attribut snippet.customUrl der Ressource channel gibt die benutzerdefinierte URL an, die mit dem Kanal verknüpft ist. Nicht alle Channels haben benutzerdefinierte URLs. In der YouTube-Hilfe werden die Voraussetzungen für den Erhalt einer benutzerdefinierten URL und das Einrichten der URL erläutert.

    • Das brandingSettings.watch-Objekt der Ressource channel und alle untergeordneten Attribute wurden verworfen.

    • Die API-Antwort auf eine search.list-Anfrage enthält jetzt ein regionCode-Attribut. Die Eigenschaft gibt den Regionscode an, der für die Suchanfrage verwendet wurde. Der Regionscode weist das API an, Suchergebnisse für das angegebene Land zurückzugeben.

      Der Eigenschaftswert ist ein aus zwei Buchstaben bestehender ISO-Ländercode, der die Region identifiziert. Die Methode i18nRegions.list gibt eine Liste der unterstützten Regionen zurück. Der Standardwert ist US. Wenn eine nicht unterstützte Region angegeben ist, kann YouTube dennoch eine andere Region anstelle des Standardwerts für die Verarbeitung der Anfrage auswählen.

    • Die Definitionen der Eigenschaften snippet.label und snippet.secondaryReasons[].label der Ressource „videoAbuseReportReason“ wurden aktualisiert. Die Eigenschaften enthalten nun lokalisierten Labeltext für die Gründe für die Missbrauchsmeldung.

      Darüber hinaus unterstützt die Methode videoAbuseReportReasons.list jetzt den Parameter hl, der die Sprache angibt, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardparameterwert ist en_US.

    • Die neue contentDetails.contentRating.ecbmctRating-Property der video-Ressource gibt die Bewertung eines Videos durch die türkische Abteilung für Bewertung und Klassifizierung des Ministeriums für Kultur und Tourismus an.

      Außerdem unterstützen API-Properties für andere Bewertungssysteme die folgenden neuen Attributwerte:

      • contentDetails.contentRating.fpbRating (Südafrika)
        Bewertung: 10; Wert der Immobilie: fpb10
      • contentDetails.contentRating.moctwRating (Taiwan)
        Bewertung: R-12; Wert der Immobilie: moctwR12
      • contentDetails.contentRating.moctwRating (Taiwan)
        Bewertung: R-15; Wert der Immobilie: moctwR15
    • Das Attribut liveStreamingDetails.activeLiveChatId der Ressource „video“ enthält die ID des aktiven Livechats, der mit dem Video verknüpft ist. Der Wert der Eigenschaft ist nur vorhanden, wenn das Video eine aktuelle Liveübertragung ist, für die der Livechat aktiviert ist. Nach dem Ende der Übertragung und dem Ende des Livechats wird die Property für das Video nicht mehr zurückgegeben.

    • Das Attribut status.rejectionReason der Ressource video unterstützt den neuen Attributwert legal.

  • Die API unterstützt die folgenden neuen Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) notEditable Die Methoden channelSections.insert, channelSections.update und channelSections.delete geben diesen Fehler zurück, um anzugeben, dass der angegebene Kanalabschnitt nicht erstellt, aktualisiert oder gelöscht werden kann.
    badRequest (400) styleRequired Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete Ressource channelSection einen Wert für das Attribut snippet.style enthalten muss.
    badRequest (400) typeRequired Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete Ressource channelSection einen Wert für das Attribut snippet.type enthalten muss.
    badRequest (400) processingFailure Die Methode commentThreads.list gibt diesen Fehler zurück, um anzuzeigen, dass der API-Server die Anfrage nicht verarbeiten konnte. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der Ressource commentThread im Anfragetext, um sicherzustellen, dass sie gültig ist.
    forbidden (403) commentsDisabled Die Methode commentThreads.list gibt diesen Fehler zurück, um anzuzeigen, dass für das durch den Parameter videoId angegebene Video Kommentare deaktiviert wurden.
    badRequest (400) commentTextTooLong Die Methode commentThreads.insert gibt diesen Fehler zurück, um anzugeben, dass die eingefügte Ressource comment zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal enthält.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serienplaylist enthalten ist. Weitere Informationen zu Serien-Playlists findest du in der YouTube-Hilfe.
    badRequest (400) subscriptionForbidden Die Methode subscriptions.insert gibt diesen Fehler zurück, um anzuzeigen, dass Sie die maximale Anzahl an Abos erreicht haben oder in letzter Zeit zu viele Abos erstellt haben. In letzterem Fall können Sie die Anfrage nach einigen Stunden wiederholen.
    badRequest (400) invalidCategoryId Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.categoryId in der hochgeladenen Ressource vom Typ video eine ungültige Kategorie-ID angegeben hat. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
    badRequest (400) invalidDescription Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.description in der hochgeladenen Ressource video einen ungültigen Wert angegeben hat.
    badRequest (400) invalidPublishAt Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut status.publishAt in der hochgeladenen Ressource vom Typ video eine ungültige geplante Veröffentlichungszeit angegeben hat.
    badRequest (400) invalidRecordingDetails Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das recordingDetails-Objekt in der hochgeladenen video-Ressource ungültige Aufnahmedetails angegeben hat.
    badRequest (400) invalidTags Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.tags in der hochgeladenen Ressource video einen ungültigen Wert angegeben hat.
    badRequest (400) invalidTitle Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass die snippet.title-Eigenschaft in der hochgeladenen video-Ressource einen ungültigen oder leeren Videotitel angegeben hat.
    badRequest (400) invalidVideoMetadata Die Methode videos.update gibt diesen Fehler zurück, um anzuzeigen, dass die Metadaten der Anfrage ungültig sind. Dieser Fehler tritt auf, wenn die Anfrage den snippet-Teil einer video-Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt.

18. Dezember 2015

Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzern in der EU bestimmte Informationen offengelegt und Einwilligungen von Endnutzern eingeholt werden. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Einen entsprechenden Hinweis finden Sie in den Nutzungsbedingungen für die YouTube API.

19. November 2015

Die API unterstützt jetzt die Möglichkeit, lokalisierten Text für die Attribute snippet.title und snippet.description der Ressourcen playlist und video, die Attribute snippet.title der Ressource channelSection und snippet.description der Ressource channel festzulegen und abzurufen.

  • Lokalisierte Titel und Beschreibungen festlegen

    Sie können lokalisierte Werte für eine Ressource festlegen, wenn Sie die Methode insert oder update für diese Ressource aufrufen. Führen Sie die beiden folgenden Schritte aus, um lokalisierte Werte für eine Ressource festzulegen:

    • Für das Attribut snippet.defaultLanguage der Ressource muss ein Wert festgelegt sein. Dieses Attribut gibt die Sprache der Attribute snippet.title und snippet.description der Ressource an. Der Wert kann eine beliebige unterstützte Anwendungssprache oder die meisten anderen Sprachcodes gemäß ISO 639-1:2002 sein. Wenn du beispielsweise ein Video mit einem englischen Titel und einer Beschreibung hochlädst, würdest du die Property snippet.defaultLanguage auf en setzen.

      Hinweis zum Aktualisieren von channel-Ressourcen:Wenn Sie das Attribut snippet.defaultLanguage für eine Ressource vom Typ channel festlegen möchten, müssen Sie das Attribut brandingSettings.channel.defaultLanguage aktualisieren.

    • Fügen Sie der Ressource, die Sie aktualisieren möchten, das Objekt localizations hinzu. Jeder Objektschlüssel ist ein String, der eine Anwendungssprache oder einen Sprachcode gemäß ISO 639-1:2002 identifiziert. Jeder Schlüssel ist einem Objekt zugeordnet, das den lokalisierten Titel (und die Beschreibung) für die Ressource enthält.

      Im folgenden Beispiel-Snippet wird als Standardsprache der Ressource Englisch festgelegt. Außerdem werden dem Video lokalisierte deutsche und spanische Titel und Beschreibungen hinzugefügt:

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • Wichtig:Wenn Sie die lokalisierten Daten für eine Ressource aktualisieren, muss Ihre API-Anfrage alle vorhandenen lokalisierten Versionen der Daten enthalten. Wenn Sie beispielsweise im Beispiel oben eine Anfrage zum Hinzufügen von portugiesischen Daten zum Video gesendet haben, muss die Anfrage die lokalisierten Daten für Deutsch, Spanisch und Portugiesisch enthalten.

  • Lokalisierte Werte abrufen

    Die API unterstützt zwei Möglichkeiten zum Abrufen lokalisierter Werte für eine Ressource:

    • Füge den hl-Parameter deiner channels.list-, channelSections.list-, playlists.list- oder videos.list-Anfrage hinzu, um lokalisierte Daten für eine bestimmte App-Sprache abzurufen, die von der YouTube-Website unterstützt wird. Wenn lokalisierte Ressourcendetails in dieser Sprache verfügbar sind, enthält das snippet.localized-Objekt der Ressource die lokalisierten Werte. Wenn jedoch keine lokalisierten Details verfügbar sind, enthält das snippet.localized-Objekt Ressourcendetails in der Standardsprache der Ressource.

      Angenommen, mit einer videos.list-Anfrage wurden Daten für das oben beschriebene Video mit lokalisierten deutschen und spanischen Daten abgerufen. Wenn der Parameter hl auf de gesetzt würde, würde die Ressource die folgenden Daten enthalten:

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          "localized": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          }
          ...
        }
      }

      Wird der Parameter hl jedoch auf fr gesetzt, enthält das Objekt snippet.localized den englischen Titel und die Beschreibung, da Englisch die Standardsprache für die Ressource ist und keine lokalisierten französischen Details verfügbar sind.

      Wichtig:Der Parameter hl unterstützt nur Werte, mit denen die von der YouTube-Website unterstützten Anwendungssprachen angegeben werden. Um festzustellen, ob lokalisierter Text für andere Sprachen verfügbar ist, musst du den localizations-Teil für die Ressource und einen Filter abrufen, um festzustellen, ob der lokalisierte Text vorhanden ist.

      Beispielsweise müsstest du die vollständige Liste der Lokalisierungen abrufen, um festzustellen, ob lokalisierter Text auf Appalachen-Englisch verfügbar ist.

    • Füge beim Abrufen einer Ressource localizations in den Parameterwert part ein, um alle lokalisierten Details für diese Ressource abzurufen. Wenn du lokalisierte Daten für eine Sprache abrufst, die nicht der aktuellen YouTube-App-Sprache entspricht, musst du mit diesem Ansatz alle Lokalisierungen abrufen und anschließend filtern, um festzustellen, ob die gewünschten lokalisierten Daten vorhanden sind.

  • Fehler im Zusammenhang mit lokalisierten Textwerten

    Die API unterstützt außerdem die folgenden neuen Fehler für lokalisierte Textwerte:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) defaultLanguageNotSetError Dieser Fehler weist darauf hin, dass eine Anfrage, bei der versucht wird, das Objekt localizations für eine Ressource einzufügen oder zu aktualisieren, fehlschlägt, weil das Attribut snippet.defaultLanguage für diese Ressource nicht festgelegt ist. Die Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert und videos.update unterstützen diesen Fehler.
    badRequest (400) localizationValidationError Dieser Fehler weist darauf hin, dass einer der Werte im localizations-Objekt einer Ressource nicht validiert werden konnte. Dieser Fehler kann beispielsweise auftreten, wenn das Objekt einen ungültigen Sprachcode enthält. Die Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert und playlists.update unterstützen diesen Fehler.

4. November 2015

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Der Parameter order der Methode search.list wurde aktualisiert. Wenn du Liveübertragungen nach viewCount sortierst, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer sortiert, während die Übertragungen noch läuft.

    • Der Parameter relatedToVideoId der Methode search.list wurde aktualisiert. Wenn der Parameter festgelegt ist, werden nur noch die Parameter part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (die auf video gesetzt sein müssen) und fields unterstützt werden. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Definition der snippet.publishedAt-Eigenschaft der video-Ressource wurde aktualisiert. Der Eigenschaftswert, der das Datum und die Uhrzeit der Veröffentlichung des Videos angibt, kann sich von dem Zeitpunkt des Uploads des Videos unterscheiden. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt der Property-Wert den Zeitpunkt an, zu dem das Video veröffentlicht wurde. Die aktualisierte Definition erklärt außerdem, wie der Wert für private und nicht gelistete Videos ausgefüllt wird.

      Diese Änderung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Definition des Attributs status.publishAt der Ressource video wurde aktualisiert:

      • Wenn du den Wert dieser Eigenschaft beim Aufrufen der videos.update-Methode festlegst, musst du auch den status.privacyStatus-Eigenschaftswert auf private setzen, auch wenn das Video bereits privat ist.
      • Wenn durch den Antrag die Veröffentlichung eines Videos in der Vergangenheit geplant wird, wird es sofort veröffentlicht. Wenn du die Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit setzt, hat das dieselbe Auswirkung wie die Änderung der privacyStatus des Videos von private zu public.
    • Die Eigenschaft contentDetails.contentRating.cncRating der video-Ressource gibt die Bewertung des Videos durch die französische Klassifikationskommission der Klassifikationskommission an. Dieses Attribut ersetzt das Attribut contentDetails.contentRating.fmocRating, das mittlerweile eingestellt wurde.

    • Die Definition der channel-Ressource brandingSettings.channel.keywords wurde aktualisiert, um korrekt wiederzugeben, dass der Eigenschaftswert eine durch Leerzeichen getrennte Liste von Strings und keine durch Kommas getrennte Liste enthält, wie zuvor beschrieben. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Dokumentation für die Methode thumbnails.set wurde aktualisiert, um genau wiederzugeben, dass der Hauptteil der Anfrage das Thumbnail enthält, das Sie hochladen und mit einem Video verknüpfen. Der Anfragetext enthält keine thumbnail-Ressource. Bisher wurde in der Dokumentation angegeben, dass Sie beim Aufrufen dieser Methode keinen Anfragetext angeben sollten. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Beschreibung der Ressource activity wurde aktualisiert, um zu berücksichtigen, dass die Methode activities.list derzeit keine Ressourcen für neue Videokommentare enthält. Die snippet.type und contentDetails.comment der Ressource wurden ebenfalls aktualisiert.

  • Neue und aktualisierte Fehler

    • Die API unterstützt jetzt die folgenden Fehler:

      Fehlerdetails
      activities.insert
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidMetadata
      BeschreibungDas Attribut kind stimmt nicht mit dem angegebenen ID-Typ überein.
      commentThreads.update
      comments.insert
      comments.update
      HTTP-AntwortcodebadRequest (400)
      GrundcommentTextTooLong
      BeschreibungDie Ressource comment, die eingefügt oder aktualisiert wird, enthält zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal.
      playlistItems.insert
      playlistItems.update
      HTTP-Antwortcodeforbidden (403)
      GrundplaylistItemsNotAccessible
      BeschreibungDie Anfrage ist nicht berechtigt, das angegebene Playlist-Element einzufügen, zu aktualisieren oder zu löschen.
      playlists.delete
      playlists.insert
      playlists.update
      HTTP-AntwortcodebadRequest (400)
      GrundplaylistForbidden
      BeschreibungDieser Vorgang ist unzulässig oder die Anfrage ist nicht ordnungsgemäß autorisiert.
      search.list
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidLocation
      BeschreibungDer Parameterwert location und/oder locationRadius war falsch formatiert.
      search.list
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidRelevanceLanguage
      BeschreibungDer Parameterwert relevanceLanguage war falsch formatiert.
      subscriptions.insert
      HTTP-AntwortcodebadRequest (400)
      GrundsubscriptionForbidden
      BeschreibungDieser Fehler tritt auf, wenn eine der folgenden Bedingungen erfüllt ist:
      • Das Abo, das Sie erstellen möchten, ist bereits vorhanden
      • Du hast bereits die maximale Anzahl an Abos erreicht
      • Du versuchst, deinen eigenen Kanal zu abonnieren. Dies wird nicht unterstützt.
      • Sie haben in letzter Zeit zu viele Abos erstellt und müssen einige Stunden warten, bevor Sie die Anfrage wiederholen können.
      videos.update
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidDefaultBroadcastPrivacySetting
      BeschreibungBei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.

28. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Das Attribut statistics.favoriteCount der Ressource video wurde eingestellt.

      Gemäß unserer Einstellungsrichtlinie wird diese Property nach dieser Ankündigung noch mindestens ein Jahr lang in video-Ressourcen enthalten sein. Der Attributwert ist jetzt jedoch immer auf 0 festgelegt.

7. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Die Definition der Eigenschaft video der Ressource snippet.tags[] wurde aktualisiert und enthält nun mehr Informationen darüber, wie der API-Server die Länge des Eigenschaftswerts berechnet. Beachten Sie, dass diese Aktualisierung keine Änderung im Verhalten der API widerspiegelt.

      Insbesondere erklärt die Definition nun, dass der API-Server den Tag-Wert so behandelt, als wäre er in Anführungszeichen gesetzt, wenn ein Tag ein Leerzeichen enthält. Die Anführungszeichen werden dann auf die Zeichenbeschränkung angerechnet. Im Sinne der Zeichenbeschränkung enthält das Tag Foo-Baz sieben Zeichen, das Tag Foo Baz jedoch neun Zeichen.

    • Die Methode commentThreads.insert unterstützt den Parameter shareOnGooglePlus nicht mehr, der zuvor angegeben hat, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+ Profil des Autors gepostet werden sollen. Wenn der Parameter bei einer Anfrage übermittelt wird, ignoriert der API-Server den Parameter, verarbeitet die Anfrage aber ansonsten.

18. Juni 2015

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Der neue Parameter order der Methode commentThreads.list gibt die Reihenfolge an, in der die API-Antwort Kommentarthreads auflisten soll. Threads können nach Zeit oder Relevanz sortiert werden. Standardmäßig werden sie nach Zeit sortiert.

    • Die neue snippet.defaultAudioLanguage-Eigenschaft der video-Ressource gibt die Sprache des Standard-Audiotracks des Videos an.

    • Die Definition der contentDetails.licensedContent-Property der video-Ressource wurde aktualisiert, um klarzustellen, dass die Inhalte ursprünglich auf einen Kanal hochgeladen worden sein müssen, der mit einem YouTube-Contentpartner verknüpft ist, und dann von diesem Partner Anspruch erhoben haben. Dies stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Methoden captions.delete, captions.download, captions.insert, captions.list und captions.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen außerdem mit einem Token autorisiert werden, das Zugriff auf den Bereich https://www.googleapis.com/auth/youtubepartner bietet.

  • Neue und aktualisierte Fehler

    • Die API unterstützt jetzt die folgenden Fehler:

      Fehlerdetails
      videos.rate
      HTTP-AntwortcodebadRequest (400)
      GrundemailNotVerified
      BeschreibungDer Nutzer muss vor der Bewertung des Videos seine E-Mail-Adresse bestätigen.
      videos.rate
      HTTP-AntwortcodebadRequest (400)
      GrundvideoPurchaseRequired
      BeschreibungLeihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben.
    • Die Methoden subscriptions.delete und subscriptions.insert unterstützen die Fehler accountClosed und accountSuspended nicht mehr.

27. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die neue videoAbuseReportReason-Ressource enthält Informationen zu einem Grund, warum ein Video wegen missbräuchlicher Inhalte gemeldet wurde. Mit der Methode videoAbuseReportReasons.list kannst du eine Liste aller Gründe abrufen, aus denen Videos möglicherweise gemeldet werden.

    • Die neue Methode videos.reportAbuse bietet eine Möglichkeit, ein Video mit missbräuchlichen Inhalten zu melden. Der Text der Anfrage enthält ein JSON-Objekt, das das gemeldete Video sowie den Grund für die mutmaßlich missbräuchliche Inhalte angibt. Über die oben beschriebene Methode videoAbuseReportReason.list können Sie gültige Gründe abrufen.

      Die Migrationsanleitung wurde ebenfalls um ein Beispiel für das Melden eines missbräuchlichen Videos ergänzt. Mit dieser Änderung unterstützt die API V3 jetzt alle Funktionen der API V2, die voraussichtlich unterstützt werden. Diese Funktionen werden auch in der Migrationsanleitung erläutert.

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Der neue forDeveloper-Filterparameter der search.list-Methode beschränkt die Suche auf Videos, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. Der Parameter forDeveloper kann in Verbindung mit optionalen Suchparametern wie dem Parameter q verwendet werden.

      Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der App des Entwicklers in der Google Developers Console zugeordnet ist.

      Wenn der Parameter forDeveloper anschließend auf true gesetzt wird, verwendet der API-Server die Autorisierungsanmeldedaten der Anfrage, um den Entwickler zu identifizieren. Daher kann ein Entwickler die Ergebnisse auf Videos beschränken, die über seine eigene App oder Website hochgeladen wurden, nicht jedoch auf Videos, die über andere Apps oder Websites hochgeladen wurden.

      Die neue Funktion ähnelt den von der API V2 unterstützten Entwickler-Tags.

    • Mit der neuen snippet.country-Property der channel-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.

      Hinweis: Um das Attribut snippet.country für eine channel-Ressource festzulegen, müssen Sie das Attribut brandingSettings.channel.country aktualisieren.

    • Die API unterstützt jetzt das Targeting für channelSection-Ressourcen. Mit dem Targeting auf Kanalabschnitte kann die Sichtbarkeit eines Inhaltsbereichs auf Nutzer beschränkt werden, die bestimmte Kriterien erfüllen.

      Die API enthält drei Ausrichtungsoptionen. Ein Nutzer muss alle Targeting-Einstellungen erfüllen, damit ein Kanalbereich sichtbar ist.

    • Die Definition der contentDetails.duration-Eigenschaft der video-Ressource wurde korrigiert, sodass der Wert Stunden, Tage usw. widerspiegeln kann.

    • Die Dokumentation für die Methode channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete und videos.delete wurde korrigiert, um zu verdeutlichen, dass diese Methoden im Erfolgsfall den HTTP-Antwortcode 204 (No Content) zurückgeben.

  • Neue und aktualisierte Fehler

    • Die API unterstützt jetzt die folgenden Fehler:

      Fehlertyp Fehlerdetails Beschreibung
      badRequest (400) targetInvalidCountry Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.countries[] enthielt.
      badRequest (400) targetInvalidLanguage Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.languages[] enthielt.
      badRequest (400) targetInvalidRegion Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.regions[] enthielt.
      badRequest (400) operationNotSupported Die Methode comments.insert gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den Kommentar der obersten Ebene einfügen kann, der durch das Attribut snippet.parentId angegeben wird. Bei einer commentThread-Ressource gibt das Attribut snippet.canReply an, ob der aktuelle Betrachter auf den Thread antworten kann.
      badRequest (400) invalidChannelId Die Methode search.list gibt diesen Fehler zurück, wenn der Parameter channelId in der Anfrage eine ungültige Kanal-ID angegeben hat.
      badRequest (400) subscriptionForbidden Die Methode subscriptions.insert gibt diesen Fehler zurück, wenn der API-Nutzer versucht, den eigenen Kanal zu abonnieren.
    • Die Methode captions.update unterstützt die Fehler invalidMetadata und videoNotFound nicht mehr.

16. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Das Migrationshandbuch wurde aktualisiert und erklärt, wie Anwendungen migriert werden, die noch die Kommentarfunktion von Version 2 der API verwenden.

    Der Leitfaden enthält auch verschiedene Kommentarfunktionen, die von der API V2 nicht unterstützt wurden, aber von der API V3 unterstützt werden. Dazu gehören:

    • Kommentare zu einem Kanal abrufen
    • Alle Kommentarthreads zu einem Kanal abrufen, d. h., die API-Antwort kann Kommentare zum Kanal oder zu seinen Videos enthalten.
    • Text eines Kommentars aktualisieren
    • Kommentare als Spam markieren
    • Moderationsstatus eines Kommentars festlegen

  • Der Leitfaden zum Abonnieren von Push-Benachrichtigungen wurde aktualisiert, um zu berücksichtigen, dass Benachrichtigungen nur an den Google PubSubHubBub-Hub und nicht wie zuvor erwähnt an den Superfeedr-Hub gesendet werden.

9. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Mit den neuen Ressourcen commentThread und comment der API können Sie Kommentare abrufen, einfügen, aktualisieren, löschen und moderieren.

    • 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.

      Der Kommentar der obersten Ebene und die Antworten sind eigentlich comment Ressourcen, die in der Ressource commentThread verschachtelt sind. Wichtig: Die Ressource commentThread enthält nicht unbedingt alle Antworten auf einen Kommentar. Du musst die Methode comments.list verwenden, wenn du alle Antworten für einen bestimmten Kommentar abrufen möchtest. Außerdem gibt es auf einige Kommentare keine Antworten.

      Die API unterstützt die folgenden Methoden für commentThread-Ressourcen:

      • commentThreads.list: Liste der Kommentarthreads abrufen Mit dieser Methode kannst du Kommentare abrufen, die mit einem bestimmten Video oder Kanal verknüpft sind.
      • commentThreads.insert: Damit wird ein neuer Kommentar auf oberster Ebene erstellt. Verwenden Sie die Methode comments.insert, um auf einen vorhandenen Kommentar zu antworten.
      • commentThreads.update: Damit kannst du einen Kommentar auf oberster Ebene ändern.

    • 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.

      Die API unterstützt die folgenden Methoden für comment-Ressourcen:

      • comments.list: Liste mit Kommentaren abrufen Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.
      • comments.insert: Damit wird eine Antwort auf einen vorhandenen Kommentar erstellt.
      • comments.update: Kommentare bearbeiten.
      • comments.markAsSpam: Einen oder mehrere Kommentare als Spam melden.
      • comments.setModerationStatus: Legt den Moderationsstatus für einen oder mehrere Kommentare fest. So können Sie beispielsweise einen Kommentar löschen, damit er öffentlich angezeigt wird, oder einen Kommentar ablehnen, da er für die Anzeige nicht geeignet ist. Die API-Anfrage muss vom Inhaber des mit den Kommentaren verknüpften Kanals oder Videos autorisiert werden.
      • comments.delete: Ein Kommentar wird gelöscht.

    Beachten Sie, dass der neue API-Bereich https://www.googleapis.com/auth/youtube.force-ssl, der im Überarbeitungsverlauf vom 2. April 2015 beschrieben wird, für Aufrufe der Methoden comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert und commentThreads.update erforderlich ist.

  • Im neuen Leitfaden Push-Benachrichtigungen abonnieren wird erläutert, wie die API Push-Benachrichtigungen über PubSubHubBub unterstützt, ein Server-zu-Server-Veröffentlichungs-/Abo-Protokoll für über das Web zugängliche Ressourcen. Ihr PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen erhalten, wenn ein Kanal eine der folgenden Aktivitäten ausführt:

    • ein Video hochlädt
    • aktualisiert den Titel eines Videos
    • aktualisiert die Beschreibung eines Videos

  • Der Migrationsleitfaden wurde ebenfalls aktualisiert, um die neue Unterstützung für Push-Benachrichtigungen zu berücksichtigen. Da die API V2 jedoch zahlreiche andere Arten von Push-Benachrichtigungen unterstützte, die von der API V3 nicht unterstützt werden, wird die PubSubHubBub-Unterstützung weiterhin im Abschnitt Verworfen dieses Leitfadens aufgeführt.

  • Der neue API-Bereich https://www.googleapis.com/auth/youtube.force-ssl ist jetzt ein gültiger Bereich für jede API-Methode, die zuvor den https://www.googleapis.com/auth/youtube-Bereich unterstützt hat.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) invalidRating Die Methode videos.rate gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameter rating enthielt.
  • Die Methode subscriptions.insert unterstützt den Fehler subscriptionLimitExceeded nicht mehr, der zuvor darauf hinweist, dass der mit der Anfrage identifizierte Abonnent die Ratenbegrenzung für Abos überschritten hatte.

2. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Die neue captions-Ressource steht für einen YouTube-Untertiteltrack. Ein Untertiteltrack ist mit genau einem YouTube-Video verknüpft.

    Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren, Herunterladen und Löschen von Untertiteltracks.

  • Das Migrationshandbuch wurde ebenfalls aktualisiert. Es wird jetzt erklärt, wie Anwendungen migriert werden können, die noch Untertitelfunktionen in Version 2 der API verwenden.

  • Der neue API-Bereich https://www.googleapis.com/auth/youtube.force-ssl erfordert die Kommunikation mit dem API-Server über eine SSL-Verbindung.

    Dieser neue Bereich gewährt denselben Zugriff wie der Bereich https://www.googleapis.com/auth/youtube. Funktional sind diese beiden Bereiche identisch, da der YouTube API-Server nur über einen HTTPS-Endpunkt verfügbar ist. Obwohl der Bereich https://www.googleapis.com/auth/youtube keine SSL-Verbindung erfordert, gibt es eigentlich keine andere Möglichkeit, eine API-Anfrage zu stellen.

    Der neue Bereich ist für Aufrufe aller Methoden der caption-Ressource erforderlich.

11. März 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Migrationsanleitung für die YouTube Data API (Version 3) enthält einen neuen Tab namens Neu in der v3 API. Dort sind Funktionen aufgeführt, die von der API für Version 3 unterstützt werden, die von der API für Version 2 nicht unterstützt werden. Dieselben Funktionen wie bisher sind auch auf anderen Tabs in der Übersicht aufgeführt. Die neue Funktion, mit der erklärt wird, wie die Daten zu In-Video-Werbekampagnen eines Kanals aktualisiert werden, ist auch auf dem Tab Kanäle (Profile) aufgeführt.

  • Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Die API unterstützt nun die folgenden API-Funktionen von Version 2:

  • Die Migrationsanleitung für Version 3 der YouTube Data API wurde aktualisiert. Die folgenden Funktionen der API V2 werden in Version 3 nicht mehr unterstützt:

    • Videoempfehlungen abrufen: Die API Version 3 ruft keine Liste ab, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Du kannst jedoch die API v3 verwenden, um empfohlene Videos zu finden, indem du die Methode activities.list aufrufst und den Wert des Parameters home auf true festlegst.

      In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der snippet.type-Property recommendation ist. In diesem Fall enthalten die Properties contentDetails.recommendation.reason und contentDetails.recommendation.seedResourceId Informationen dazu, warum das Video empfohlen wurde. Es gibt keine Garantie, dass die Antwort eine bestimmte Anzahl von empfohlenen Videos enthält.

    • Kanalvorschläge abrufen

    • Neue Abovideos abrufen: Die API V3 ruft keine Liste ab, die nur Videos enthält, die kürzlich auf Kanäle hochgeladen wurden, die der API-Nutzer abonniert hat. Du kannst jedoch die API v3 verwenden, um neue Abovideos zu finden. Rufe dazu die Methode activities.list auf und setze den Wert des Parameters home auf true.

      In der API-Antwort entspricht eine Ressource einem neuen Abovideo, wenn der Wert des Attributs snippet.type upload ist. Beachte, dass es keine Garantie gibt, dass die Antwort eine bestimmte Anzahl neuer Abovideos enthält.

    • Unterstützung von RSS-Feeds

    • Push-Benachrichtigungen für Feedaktualisierungen: Die API V2 unterstützte Push-Benachrichtigungen und verwendet entweder das Simple Update Protocol (SUP) oder PubSubHubbub, um die Feeds der Nutzeraktivitäten für YouTube-Nutzer im Blick zu behalten. Es wurden Benachrichtigungen über neue Kanalabos und darüber informiert, wann Videos bewertet, geteilt, als Favoriten markiert, kommentiert oder hochgeladen wurden.

      Version 3 der API unterstützt zwar Push-Benachrichtigungen über das PubSubHubbub-Protokoll, decken jedoch nur Videouploads und Aktualisierungen von Videotiteln oder -beschreibungen ab.

    • Kanalstandort: In der API Version 2 wurde das Tag <yt:location> verwendet, um den Standort des Nutzers so zu identifizieren, wie er im öffentlichen YouTube-Profil des Kanals angegeben ist. Einige Entwickler haben dieses Feld zwar verwendet, um einen Kanal mit einem bestimmten Land zu verknüpfen, die Daten des Felds konnten jedoch nicht konsistent für diesen Zweck verwendet werden.

    • Entwickler-Tags festlegen oder abrufen: Mit der API Version 2 konnten beim Upload des Videos Keywords oder Entwickler-Tags mit einem Video verknüpft werden. Entwickler-Tags werden YouTube-Nutzern nicht angezeigt, aber Videoinhaber konnten Videos abrufen, die mit einem bestimmten Entwickler-Tag übereinstimmen.

      Die API v3 bietet eine ähnliche, aber nicht identische Funktion. Entwickler können nach Videos suchen, die über ihre eigene App hochgeladen wurden. Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der App des Entwicklers in der Google Developers Console zugeordnet ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.

    • Videos nach Veröffentlichungsdatum, Anzahl der Aufrufe oder Bewertung auflisten: In Version 2 der API kannst du mit dem Parameter orderby Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und verschiedenen anderen Werten sortieren. In der API Version 3 werden Playlist-Elemente normalerweise in aufsteigender Reihenfolge nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.

      Es gibt jedoch einige Ausnahmen. Ein neues Video, ein neues Lieblingsvideo, ein Video mit „Mag ich“-Bewertung oder ein kürzlich angesehenes Video wird bei den folgenden Arten von Playlists automatisch als erstes Element (snippet.position=0) hinzugefügt. Somit wird jede dieser Listen effektiv in der Reihenfolge vom neuesten zum ältesten Element basierend auf dem Zeitpunkt sortiert, zu dem die Elemente zur Liste hinzugefügt wurden.

      • Nutzeruploads
      • Lieblingsvideos
      • positiv bewertete Videos
      • Wiedergabeverlauf

      Ein neuer Titel, der der Playlist „Später ansehen“ hinzugefügt wurde, wird jedoch als letztes Element in der Liste hinzugefügt. Die Liste wird also faktisch aufsteigend sortiert.

    • Batchverarbeitung: Die API V3 unterstützt einen der Anwendungsfälle der Batchverarbeitung, die bereits von der API V2 unterstützt wurden. Die Methoden channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list und videos.list der API V3 unterstützen alle den Parameter id, mit dem eine durch Kommas getrennte Liste von IDs (Video-IDs, Kanal-IDs usw.) angegeben werden kann. Mit diesen Methoden können Sie mit einer einzigen Anfrage eine Liste mehrerer Ressourcen abrufen.

    Mit diesen Änderungen werden nun alle Funktionen aufgeführt, die in der alten API (v2) unterstützt wurden und in der aktuellen API-Version (v3) eingestellt werden.

4. März 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Methoden channelSections.delete und channelSections.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

  • Die folgenden Properties und ihre untergeordneten Properties wurden eingestellt:

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    Hinweis:Keine dieser Eigenschaften unterliegt der Richtlinie zur Einstellung von APIs.

  • Die neue contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons-Property der video-Ressource gibt die Gründe an, warum das Video die DJCQT-Bewertung (Brasilien) erhalten hat.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    notFound (404) channelNotFound Die Methode channels.update gibt diesen Fehler zurück, wenn der Parameter id der Anfrage einen Kanal angibt, der nicht gefunden werden kann.
    badRequest (400) manualSortRequiredinvalidValue Die Methoden playlistItems.insert und playlistItems.update geben diesen Fehler zurück, wenn die Anfrage versucht, die Position des Playlist-Elements festzulegen, die Playlist aber keine manuelle Sortierung verwendet. Playlists können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können diesen Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die im Anfragetext gesendet wurde. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Reihenfolge der Playlist in Manuell ändern. Diese Einstellung kann im Video-Manager von YouTube angepasst werden.
    forbidden (403) channelClosed Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter channelId der Anfrage einen Kanal angibt, der geschlossen wurde.
    forbidden (403) channelSuspended Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter channelId der Anfrage einen Kanal angibt, der gesperrt wurde.
    forbidden (403) playlistForbidden Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter id der Anfrage die Anfrage nicht unterstützt oder die Anfrage nicht ordnungsgemäß autorisiert ist.
    notFound (404) channelNotFound Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter channelId der Anfrage einen Kanal angibt, der nicht gefunden werden kann.
    notFound (404) playlistNotFound Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter id der Anfrage eine Playlist angibt, die nicht gefunden werden kann.
    notFound (404) videoNotFound Die Methode videos.list gibt diesen Fehler zurück, wenn der Parameter id der Anfrage ein Video angibt, das nicht gefunden werden kann.
    badRequest (400) invalidRating Die Methode videos.rate gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameter rating enthält.

2. März 2015

Dieses Update enthält die folgenden Änderungen:

14. Januar 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Jetzt wird erklärt, wie du mit der API Version 3 Videos mithilfe von JavaScript hochladen kannst. Weitere Informationen findest du im Abschnitt Video hochladen. Diese Funktion ist vergleichbar mit der Funktion für browserbasierte Uploads, die von der API Version 2 unterstützt wird. Hinweis: Diese Änderung des Migrationsleitfadens bezieht sich nicht auf eine tatsächliche API-Änderung, sondern auf die Verfügbarkeit von neuem Beispielcode für das Hochladen von Videos mit clientseitigem JavaScript.

    Da das Hochladen von Videos mit der JavaScript-Clientbibliothek und CORS unterstützt wird, wird das browserbasierte Hochladen in der Migrationsanleitung nicht mehr als Funktion aufgeführt, die in Version 3 der API eingestellt wurde.

  • Die Dokumentation für die Methode videos.insert wurde aktualisiert und enthält jetzt das oben beschriebene neue JavaScript-Codebeispiel. Die Liste der JavaScript-Codebeispiele für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert.

11. November 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Kontingentkosten für einen Aufruf der Methode search.list wurden auf 100 Einheiten erhöht.

    Wichtig:In vielen Fällen können Sie andere API-Methoden verwenden, um Informationen zu niedrigeren Kontingentkosten abzurufen. Es gibt zwei Möglichkeiten, Videos zu finden, die auf dem GoogleDevelopers-Kanal hochgeladen wurden:

    • Kontingentkosten: 100 Einheiten

      Rufen Sie die Methode search.list auf und suchen Sie nach GoogleDevelopers.

    • Kontingentkosten: 6 Einheiten

      Rufe die Methode channels.list auf, um die richtige Kanal-ID zu ermitteln. Legen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails fest. In der API-Antwort gibt die Eigenschaft contentDetails.relatedPlaylists.uploads die Playlist-ID für die hochgeladenen Videos des Kanals an.

      Rufen Sie dann die Methode playlistItems.list auf und legen Sie den Parameter playlistId auf die erfasste ID und den Parameter part auf snippet fest.

8. Oktober 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Ressource channel enthält zwei neue Attribute:

    • Die Eigenschaft status.longUploadsStatus gibt an, ob der Kanal die Voraussetzungen zum Hochladen von Videos erfüllt, die länger als 15 Minuten sind. Diese Eigenschaft wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Gültige Attributwerte sind:

      • allowed: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.
      • eligible: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden, allerdings muss die Funktion zuerst aktiviert werden.
      • disallowed: Auf dem Kanal können keine Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.

      Weitere Informationen zu diesen Werten finden Sie in der Property-Definition. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe.

    • Die Property invideoPromotion.useSmartTiming gibt an, ob für die Werbekampagne des Kanals Smart Timing verwendet wird. Mit dieser Funktion wird Werbung an einer Stelle im Video präsentiert, an der sie mit höherer Wahrscheinlichkeit angeklickt werden und die Wiedergabe nicht stören. Diese Funktion wählt außerdem eine einzelne Werbung aus, die dann in jedem Video angezeigt wird.

  • Die Definitionen der Attribute snippet.title und snippet.categoryId der Ressource video wurden aktualisiert, um zu verdeutlichen, wie die API Aufrufe an die Methode videos.update verarbeitet. Wenn Sie diese Methode aufrufen, um den snippet-Teil einer video-Ressource zu aktualisieren, müssen Sie für beide Attribute einen Wert festlegen.

    Wenn Sie versuchen, den snippet-Teil einer video-Ressource zu aktualisieren und keinen Wert für beide Attribute festlegen, gibt die API den Fehler invalidRequest zurück. Die Beschreibung dieses Fehlers wurde ebenfalls aktualisiert.

  • Die contentDetails.contentRating.oflcRating-Property der video-Ressource, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Einstufungen: oflcRp13 und oflcRp16. Sie entsprechen den Bewertungen RP13 bzw. RP16.

  • Die Methode channelBanners.insert unterstützt jetzt den folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest bannerAlbumFull Das Album mit den YouTube-Kanalbildern des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber muss http://photos.google.com aufrufen, die Seite mit den Alben aufrufen und einige davon von den Bildern aus diesem Album entfernen.

12. September 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Kontingentkosten für einen Aufruf der Methode search.list haben sich von einer Einheit auf zwei Einheiten zusätzlich zu den Kosten für die angegebenen Ressourcenteile geändert.

13. August 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Methode subscriptions.insert unterstützt jetzt den folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest subscriptionLimitExceeded Der mit der Anfrage angegebene Abonnent hat die Ratenbegrenzung für Abos überschritten. In wenigen Stunden können Sie versuchen, weitere Abos abzuschließen.

12. August 2014

Dieses Update enthält die folgenden Änderungen:

  • In der neuen Anleitung Anwendung zur YouTube Data API (Version 3) migrieren wird erläutert, wie du die YouTube Data API (Version 3) verwendest, um die in der YouTube Data API (Version 2) verfügbaren Funktionen auszuführen. Die ältere API wurde offiziell am 4. März 2014 eingestellt. Dieser Leitfaden soll Sie bei der Migration von Anwendungen, die noch die v2 API verwenden, auf die neueste API-Version unterstützen.

8. Juli 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Methode playlists.insert unterstützt jetzt den folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest maxPlaylistExceeded Dieser Fehler tritt auf, wenn keine Playlist erstellt werden kann, weil der Kanal bereits die maximal zulässige Anzahl von Playlists enthält.

18. Juni 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Beschreibung jeder API-Methode wurde aktualisiert und enthält jetzt die Kontingentkosten, die bei einem Aufruf der jeweiligen Methode anfallen. In ähnlicher Weise wurden die Definitionen der part-Parameter aktualisiert, um die Kontingentkosten für jeden Teil anzugeben, der in einem API-Aufruf abgerufen werden kann. Ein Aufruf der Methode subscriptions.insert hat beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressource subscription besteht ebenfalls aus drei Teilen (snippet, contentDetails und subscriberSnippet), die jeweils zwei Einheiten kosten.

    Beachten Sie, dass sich die Kontingentkosten ohne Vorwarnung ändern können.

  • Die Ressource video unterstützt jetzt 43 neue Altersfreigabesysteme, die die Altersfreigaben ermitteln, die Videos von verschiedenen nationalen Einstufungsstellen erhalten haben. Die neuen unterstützten Bewertungssysteme kommen aus Argentinien,Österreich,Österreich,Belgium, Bulgarien, Chile (television), Chile (film), Tschechische Republik, Kolumbien, Dänemark Dänisch EstoniaFin

28. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Methode search.list unterstützt jetzt die Parameter location und locationRadius, mit denen Sie nach Videos suchen können, die einem geografischen Standort zugeordnet sind. Eine Anfrage muss einen Wert für beide Parameter angeben, um Ergebnisse basierend auf dem Standort abzurufen, und das API gibt einen Fehler zurück, wenn eine Anfrage nur einen der beiden Parameter enthält.

    • Der Parameter location gibt die Breiten- und Längengradkoordinaten im Mittelpunkt des kreisförmigen geografischen Bereichs an.

    • Der Parameter locationRadius gibt die maximale Entfernung an, die der mit einem Video verknüpfte Standort von der Mitte des Bereichs sein darf, damit das Video weiterhin in den Suchergebnissen enthalten ist.

13. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Eigenschaft invideoPromotion.items[] der Ressource „channel“ wurde aktualisiert. Du kannst jetzt normalerweise nur ein beworbenes Element für deinen Kanal festlegen. Wenn Sie versuchen, zu viele beworbene Artikel einzufügen, gibt die API den Fehler tooManyPromotedItems mit dem HTTP-Statuscode 400 zurück.

  • Die Ressource channelSection kann jetzt Informationen zu einigen neuen Arten von empfohlenen Inhalten enthalten. Das Attribut snippet.type der Ressource channelSection unterstützt jetzt die folgenden Werte:

    • postedPlaylists: Playlists, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hat
    • postedVideos: Videos, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hat
    • subscriptions: Kanäle, die der Kanalinhaber abonniert hat

  • Die neue contentDetails.contentRating.ifcoRating-Property der video-Ressource gibt die Einstufung eines Videos vom Irish Film Classification Office an.

  • Die Definition der position.cornerPosition-Eigenschaft der watermark-Ressource wurde aktualisiert. Das Wasserzeichen wird nun immer oben rechts im Player angezeigt.

  • Die Definition des q-Parameters für die search.list-Methode wurde aktualisiert. Der Suchbegriff kann jetzt den booleschen NOT-Operator (-) verwenden, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Der Wert kann auch den booleschen Operator ODER (|) verwenden, um Videos zu finden, die mit einem von mehreren Suchbegriffen verknüpft sind.

  • Die Definition des Attributs pageInfo.totalResults, die in einer API-Antwort auf einen search.list-Aufruf zurückgegeben wird, wurde aktualisiert. Der Wert ist nun eine Näherung und stellt möglicherweise keinen genauen Wert dar. Darüber hinaus beträgt der Maximalwert 1.000.000. Sie sollten diesen Wert nicht zum Erstellen von Paginierungslinks verwenden. Verwenden Sie stattdessen die Attributwerte nextPageToken und prevPageToken, um zu bestimmen, ob Paginierungslinks angezeigt werden sollen.

  • Die Methoden watermarks.set und watermarks.unset wurden aktualisiert, um zu berücksichtigen, dass die API bei erfolgreichen Anfragen an diese Methoden einen HTTP-204-Antwortcode zurückgibt.

2. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die neue 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.

    Die API unterstützt eine Methode zum Auflisten unterstützter Anwendungssprachen. Unterstützte Sprachen können als Wert des Parameters hl verwendet werden, wenn API-Methoden wie videoCategories.list und guideCategories.list aufgerufen werden.

  • Die neue 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 kann auf Grundlage von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch ein Content-Bereich ausgewählt werden. Nutzer können die gewünschte Content-Region auch manuell aus der Fußzeile der YouTube-Website auswählen.

    Die API unterstützt eine Methode zum Auflisten unterstützter Inhaltsbereiche. Unterstützte Regionscodes können als Wert des Parameters regionCode verwendet werden, wenn API-Methoden wie search.list, videos.list, activities.list und videoCategories.list aufgerufen werden.

7. April 2014

Dieses Update enthält die folgenden Änderungen:

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

    Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren oder Löschen von Kanalabschnitten. Du kannst eine Liste mit Kanalabschnitten für den Kanal des authentifizierten Nutzers abrufen, indem du eine bestimmte Kanal-ID oder eine Liste eindeutiger Kanalabschnitts-IDs angibst.

    Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun die Fehlermeldungen, die die API speziell für diese neuen Methoden unterstützt.

  • Die Definition des fileDetails-Objekts der video-Ressource wurde aktualisiert, um zu verdeutlichen, dass dieses Objekt nur zurückgegeben wird, wenn die processingDetails.fileDetailsAvailability-Eigenschaft des Videos den Wert available hat.

    Die Definition des suggestions-Objekts der video-Ressource wurde aktualisiert, um zu erklären, dass dieses Objekt nur dann zurückgegeben wird, wenn die processingDetails.tagSuggestionsAvailability-Eigenschaft des Videos oder die processingDetails.editorSuggestionsAvailability-Eigenschaft des Videos den Wert available hat.

  • Die Dokumentation für die Methoden videos.insert und videos.update wurde aktualisiert, um zu berücksichtigen, dass beim Aufrufen dieser Methoden das Attribut status.publishAt festgelegt werden kann.

  • Die Definition des invideoPromotion-Objekts der Ressource channel wurde aktualisiert, um zu verdeutlichen, dass das Objekt nur vom Inhaber des Kanals abgerufen werden kann.

  • Die Parameterliste für die Methode videos.rate wurde aktualisiert, um zu verdeutlichen, dass diese Methode den Parameter onBehalfOfContentOwner nicht unterstützt. Dies war ein Dokumentationsfehler, da videos.rate-Anfragen, die diesen Parameter festlegen, den Fehler 500 zurückgeben.

31. März 2014

Dieses Update enthält die folgenden Änderungen:

13. März 2014

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt den contentOwnerDetails-Teil für channel-Ressourcen. Der neue Teil enthält Kanaldaten, die für mit dem Kanal verknüpfte YouTube-Partner relevant sind, darunter die ID des mit dem Kanal verknüpften Rechteinhabers sowie Datum und Uhrzeit der Verknüpfung des Rechteinhabers und des Kanals. Hinweis: Dieser neue Teil unterliegt nicht der Einstellungsrichtlinie.

  • In der Dokumentation ist jetzt die maximal unterstützte Zeichenlänge für die folgenden Eigenschaften aufgeführt:

    Ressource Property Maximale Länge
    channel invideoPromotion.items[].customMessage 40 Zeichen
    video snippet.title 100 Zeichen
    video snippet.description 5.000 Byte
    video snippet.tags 500 Zeichen Beachten Sie, dass es sich bei dem Attributwert um eine Liste handelt und dass Kommas zwischen den Elementen in der Liste auf den Grenzwert angerechnet werden.
  • Das Attribut brandingSettings.watch.featuredPlaylistId der Ressource channel wurde eingestellt. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen.

  • Die folgenden video-Ressourceneigenschaften wurden der Liste der Werte hinzugefügt, die beim Einfügen oder Aktualisieren eines Videos festgelegt werden können:

  • In der Fehlerdokumentation wird jetzt der HTTP-Antwortcode für jeden Fehlertyp angegeben.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) invalidCriteria Die Methode channels.list gibt diesen Fehler zurück, wenn in der Anfrage Filterparameter angegeben sind, die nicht in Kombination miteinander verwendet werden können.
    badRequest (400) channelTitleUpdateForbidden Die Methode channels.update gibt diesen Fehler zurück, wenn du versuchst, den brandingSettings-Teil eines Kanals zu aktualisieren und den Wert der brandingSettings.channel.title-Eigenschaft zu ändern. Beachten Sie, dass die API den Fehler nicht zurückgibt, wenn Sie die Eigenschaft auslassen.
    badRequest (400) invalidRecentlyUploadedBy Die Methode channels.update gibt diesen Fehler zurück, wenn die Eigenschaft invideoPromotion.items[].id.recentlyUploadedBy eine ungültige Kanal-ID angibt.
    badRequest (400) invalidTimingOffset Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil einen ungültigen Zeitversatz angibt.
    badRequest (400) tooManyPromotedItems Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil mehr als die zulässige Anzahl von hochgestuften Elementen angibt.
    forbidden (403) promotedVideoNotAllowed Die Methode channels.update gibt diesen Fehler zurück, wenn die Property invideoPromotion.items[].id.videoId eine Video-ID angibt, die entweder nicht gefunden oder nicht als beworbenes Element verwendet werden kann.
    forbidden (403) websiteLinkNotAllowed Die Methode channels.update gibt diesen Fehler zurück, wenn die Property invideoPromotion.items[].id.websiteUrl eine unzulässige URL angibt.
    required (400) requiredTimingType Die Methode channels.update gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardzeiteinstellungen für den Zeitpunkt angegeben sind, zu dem YouTube ein beworbenes Element anzeigen soll.
    required (400) requiredTiming In der Methode channels.update muss für jedes beworbene Element ein invideoPromotion.items[].timing-Objekt angegeben werden.
    required (400) requiredWebsiteUrl Bei der Methode channels.update muss für jedes beworbene Element eine invideoPromotion.items[].id.websiteUrl-Eigenschaft angegeben werden.
    badRequest (400) invalidPublishAt Die Methode videos.insert gibt diesen Fehler zurück, wenn die Metadaten der Anfrage eine ungültige geplante Veröffentlichungszeit angeben.

4. März 2014

Dieses Update enthält die folgenden Änderungen:

5. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumentation zur Methode search.list wurde aktualisiert, um zu verdeutlichen, dass Sie beim Senden einer Suchanfrage keinen Wert für genau einen Filterparameter angeben müssen. Stattdessen können Sie einen Wert für Null-Filterparameter oder für einen einzelnen Filterparameter festlegen.

  • Die Definitionen der Parameter der search.list-Methode wurden aktualisiert. Sie müssen nun den Wert des type-Parameters auf video festlegen, wenn Sie auch einen Wert für einen der folgenden Parameter angeben:

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • Die Mindestgröße von hochgeladenen Kanalbannerbildern wurde auf 2048 x 1152 Pixel reduziert. Früher betrug die Mindestgröße 2.120 x 1.192 Pixel. Beachten Sie außerdem, dass in der Dokumentation zu channel-Ressourcen die maximale Größe aller Bannerbilder angegeben ist, die von der API ausgeliefert werden. Die maximale Größe des brandingSettings.image.bannerTvImageUrl-Bildes für Fernsehanwendungen beträgt beispielsweise 2.120 x 1.192 Pixel, das tatsächliche Bild kann jedoch 2.048 x 1.152 Pixel groß sein. In der YouTube-Hilfe findest du weitere Informationen zur Optimierung von Kanalbildern für die Anzeige auf verschiedenen Gerätetypen.

  • Mehrere Definitionen von channel-Ressourcenattributen wurden aktualisiert, um die folgenden Informationen zu berücksichtigen:

    • Der Wert des Attributs brandingSettings.channel.description darf maximal 1.000 Zeichen lang sein.
    • Das Attribut brandingSettings.channel.featuredChannelsTitle darf maximal 30 Zeichen lang sein.
    • In der Property brandingSettings.channel.featuredChannelsUrls[] können jetzt bis zu 100 Channels aufgelistet werden.
    • Wenn der Eigenschaftswert brandingSettings.channel.unsubscribedTrailer festgelegt ist, muss er die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos angeben, dessen Inhaber der Kanalinhaber ist.

  • Die Methode channels.update unterstützt jetzt Aktualisierungen des Attributs invideoPromotion.items[].promotedByContentOwner. Diese Eigenschaft gibt an, ob der Name des Inhaltseigentümers bei der Anzeige der Werbung angezeigt wird. Sie kann nur festgelegt werden, wenn die API-Anfrage, mit der der Attributwert festgelegt wird, mit dem Parameter onBehalfOfContentOwner im Namen des Rechteinhabers erfolgt.

  • Die Methoden playlistItems.list und playlistItems.insert unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

  • In der Property contentDetails.contentRating.acbRating kann jetzt entweder vom Australian Classification Board (ACB) eine Altersfreigabe für Filme oder von der Australian Communications and Media Authority (ACMA) für Fernsehprogramme für Kinder angegeben werden.

  • Die neuen Properties contentDetails.contentRating.catvRating und contentDetails.contentRating.catvfrRating geben die Bewertungen an, die ein Video nach dem kanadischen TV-Klassifizierungssystem und dem in Québec verwendeten französischsprachigen Altersfreigabesystem Régie du cinéma erhalten hat.

  • Die neue snippet.assignable-Property der videoCategory-Ressource gibt an, ob dieser Videokategorie aktualisierte oder neu hochgeladene Videos zugeordnet werden können.

  • Für die folgenden Methoden wurden Codebeispiele hinzugefügt:

24. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API umfasst zwei zusätzliche Funktionen, die dabei helfen, Liveübertragungen zu finden und anzuzeigen:

    Die neue snippet.liveBroadcastContent-Eigenschaft in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Attributwerte sind upcoming, active und none.

    • Die neue snippet.liveBroadcastContent-Property der video-Ressource gibt an, ob das Video eine anstehende oder aktive Liveübertragung ist. In der folgenden Liste werden die möglichen Werte der Property erläutert:

      • upcoming: Das Video ist eine Liveübertragung, die noch nicht begonnen hat.
      • active: Das Video ist eine laufende Liveübertragung.
      • none: Das Video ist keine anstehende oder aktive Liveübertragung. Dies ist der Property-Wert für abgeschlossene Übertragungen, die noch auf YouTube sichtbar sind.

    • Das neue Attribut liveStreamingDetails der Ressource video ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen Sie liveStreamingDetails in die Liste der Ressourcenteile des Parameterwerts part auf. Die Metadaten enthalten die folgenden neuen Attribute:

      Fügen Sie zum Abrufen dieser Metadaten liveStreamingDetails in den part-Parameterwert ein, wenn Sie die Methode videos.list, videos.insert oder videos.update aufrufen.

    Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Liveübertragungen veröffentlicht: der Parameter eventType der Methode search.list und die Eigenschaft snippet.liveBroadcastContent des Suchergebnisses.

  • Die Methode videos.insert unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonnieren. Der Standardwert des Parameters lautet True. Dies bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch auf False setzen, damit er nicht jedes neue Video an die Abonnenten des Kanals sendet.

  • Die Liste der Attribute, die beim Aufrufen der Methode channels.update geändert werden können, wurde aktualisiert und enthält nun die Attribute invideoPromotion.items[].customMessage und invideoPromotion.items[].websiteUrl. Außerdem wurde die Liste geändert, um die brandingSettings-Properties anzugeben, die änderbar sind. Diese brandingSettings-Eigenschaften konnten bereits geändert werden, sodass die Änderung der Dokumentation keine Änderung der bestehenden Funktionalität der API widerspiegelt.

  • Die Methoden playlists.insert, playlists.update und playlists.delete unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

  • Die Methode playlists.insert unterstützt jetzt den Parameter onBehalfOfContentOwnerChannel, der bereits für einige andere Methoden unterstützt wird.

  • Das Attribut contentDetails.contentRating.tvpgRating der Ressource video unterstützt jetzt den Wert pg14, der der Bewertung TV-14 entspricht.

  • Die Definition der Eigenschaft snippet.liveBroadcastContent, die Teil der Suchergebnisse ist, wurde korrigiert, um zu verdeutlichen, dass live ein gültiger Eigenschaftswert ist, active jedoch kein gültiger Eigenschaftswert.

  • Das Attribut contentDetails.contentRating.mibacRating der Ressource video unterstützt jetzt zwei zusätzliche Bewertungen:

    • mibacVap (VAP): Kinder sollten von einem Erwachsenen begleitet werden.
    • mibacVm6 (V.M.6): Nur für Zuschauer ab 6 Jahren.
    • mibacVm12 (V.M.12): Nur für Zuschauer ab 12 Jahren.

  • Die neue invideoPromotion.items[].promotedByContentOwner-Eigenschaft der channel-Ressource gibt an, ob der Name des Rechteinhabers bei der Anzeige der Werbung angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn die API-Anfrage, durch die der Wert festgelegt wird, im Namen des Rechteinhabers erfolgt. Weitere Informationen finden Sie im Abschnitt zum Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

  • Das neue auditDetails-Objekt der channel-Ressource enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu bestimmen, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten muss. Darüber hinaus muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach Ausstellung des Tokens.

  • Die Eigenschaft invideoPromotion.items[].id.type der Ressource channel unterstützt jetzt den Wert recentUpload. Dieser Wert gibt an, dass das beworbene Element das zuletzt hochgeladene Video eines bestimmten Kanals ist.

    Der Kanal ist standardmäßig derjenige, für den die Daten zur In-Video-Werbung festgelegt sind. Du kannst jedoch das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem du den Wert der neuen invideoPromotion.items[].id.recentlyUploadedBy-Eigenschaft auf die Kanal-ID für diesen Kanal festlegst.

  • Die Ressource channel enthält drei neue Eigenschaften – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl –, die die URLs für die Bannerbilder angeben, die auf Kanalseiten in Fernsehanwendungen angezeigt werden.

  • Die neue snippet.liveBroadcastContent-Eigenschaft in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Attributwerte sind upcoming, active und none.

    • Bei einer video-Ressource bedeutet der Wert upcoming, dass das Video eine Liveübertragung ist, die noch nicht begonnen hat. Der Wert active gibt an, dass es sich um eine laufende Liveübertragung handelt.
    • Bei einer channel-Ressource bedeutet der Wert upcoming, dass die geplante Übertragung auf dem Kanal noch nicht begonnen hat. Der Wert acive gibt an, dass auf dem Kanal eine laufende Liveübertragung vorhanden ist.

  • In der Ressource watermark wurde das Attribut targetChannelId von einem Objekt in einen String geändert. Statt eine untergeordnete Eigenschaft zu enthalten, die die YouTube-Kanal-ID des Kanals angibt, mit dem das Wasserzeichenbild verknüpft ist, gibt die targetChannelId-Eigenschaft jetzt diesen Wert selbst an. Dementsprechend wurde das Attribut targetChannelId.value der Ressource entfernt.

  • Die Methode thumbnails.set unterstützt jetzt den Parameter onBehalfOfContentOwner, der bereits für einige andere Methoden unterstützt wird.

  • Die Methode search.list unterstützt jetzt den Parameter eventType, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungen einschränkt.

  • Die neue contentDetails.contentRating.mibacRating-Property gibt die Bewertung an, die ein Video vom italienischen Ministero dei Beni e delle Attivita Culturali e del Turismo erhalten hat.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest invalidImage Die Methode thumbnails.set gibt diesen Fehler zurück, wenn der bereitgestellte Bildinhalt ungültig ist.
    forbidden videoRatingDisabled Die Methode videos.rate gibt diesen Fehler zurück, wenn der Eigentümer des gerade bewerteten Videos Bewertungen für dieses Video deaktiviert hat.

27. August 2013

Dieses Update enthält die folgenden Änderungen:

  • Die neue watermark-Ressource identifiziert ein Bild, 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.

    Mit der watermarks.set-Methode wird das Wasserzeichenbild eines Kanals hochgeladen und festgelegt. Mit der Methode watermarks.unset wird das Wasserzeichenbild eines Kanals gelöscht.

    In der Fehlerdokumentation werden die Fehlermeldungen beschrieben, die die API speziell für die Methoden watermarks.set und watermarks.unset unterstützt.

  • Das neue Attribut statistics.hiddenSubscriberCount der Ressource channel enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Daher lautet der Wert der Eigenschaft false, wenn die Abonnentenzahl des Kanals öffentlich sichtbar ist.

  • Die Methode playlists.list unterstützt jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Beide Parameter werden bereits für einige andere Methoden unterstützt.

  • Die Methode videos.list unterstützt jetzt den Parameter regionCode, der den Inhaltsbereich angibt, für den ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart verwendet werden. Der Parameterwert ist ein Alpha-2-Ländercode gemäß ISO 3166-1.

  • In error documentation wird der folgende neue häufige Anfragefehler beschrieben, der bei mehreren API-Methoden auftreten kann:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden insufficientPermissions Die mit dem OAuth 2.0-Token verknüpften Bereiche für die Anfrage reichen nicht aus, um auf die angeforderten Daten zuzugreifen.

15. August 2013

Dieses Update enthält die folgenden Änderungen:

  • Das Objekt invideoPromotion der Ressource channel hat die folgenden neuen und aktualisierten Attribute:

    • In der API kann jetzt eine Website als beworbener Artikel angegeben werden. Setzen Sie dazu den Wert des Attributs invideoPromotion.items[].id.type auf website und verwenden Sie das neue Attribut invideoPromotion.items[].id.websiteUrl, um die URL anzugeben. Mit der neuen Eigenschaft invideoPromotion.items[].customMessage kannst du außerdem eine benutzerdefinierte Nachricht definieren, die für das Angebot angezeigt wird.

      Links können zu verknüpften Websites, Händlerwebsites oder Websites sozialer Netzwerke führen. Weitere Informationen zum Aktivieren von Links für deine Inhalte findest du in der YouTube-Hilfe für verknüpfte Websites und Händlerwebsites.

      Indem Sie Werbelinks hinzufügen, erklären Sie sich damit einverstanden, dass diese Links nicht dazu verwendet werden, Zugriffe auf nicht autorisierte Websites weiterzuleiten, und dass diese Links den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.

    • Die Eigenschaften in Bezug auf die Timing-Einstellungen für die Anzeige beworbener Artikel während der Videowiedergabe wurden neu strukturiert:

      • Das Objekt invideoPromotion.timing wurde in den Ordner invideoPromotion.items[].timing verschoben. Mit diesem Objekt kannst du jetzt die Zeitdaten für jedes hochgestufte Element in der invideoPromotion.items[]-Liste anpassen.

      • Über das neue invideoPromotion.defaultTiming-Objekt werden Standard-Timing-Einstellungen für dein Angebot festgelegt. Mit diesen Einstellungen kannst du festlegen, wann ein beworbener Artikel bei der Wiedergabe eines Videos auf deinem Kanal angezeigt wird. Du kannst das Standardtiming für jeden beworbenen Artikel mit dem Objekt invideoPromotion.items[].timing überschreiben.

      • Mit der neuen invideoPromotion.items[].timing.durationMs-Property wird angegeben, wie lange das Angebot in Millisekunden zu sehen sein soll. Das invideoPromotion.defaultTiming-Objekt enthält auch ein durationMs-Feld, das die Standarddauer angibt, für die der beworbene Artikel angezeigt wird.

    • Die Properties invideoPromotion.items[].type und invideoPromotion.items[].videoId wurden in das Objekt invideoPromotion.items[].id verschoben.

  • Die Methode subscriptions.list unterstützt jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Beide Parameter werden bereits für einige andere Methoden unterstützt.

  • In der API-Antwort auf eine thumbnails.set-Anfrage wurde der Attributwert kind von youtube#thumbnailListResponse in youtube#thumbnailSetResponse geändert.

  • Für die folgenden Methoden wurden Codebeispiele hinzugefügt:

    Das Python-Beispiel für die Methode playlistItems.insert wurde ebenfalls entfernt, da die gezeigte Funktionalität jetzt von der Methode videos.rate verarbeitet wird.

  • In error documentation wird der folgende neue Anfragekontextfehler beschrieben, der bei jeder API-Methode auftreten kann, die den Anfrageparameter mine unterstützt:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest invalidMine Der Parameter mine kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Du solltest entweder den mine-Parameter entfernen, dich durch Entfernen des onBehalfOfContentOwner-Parameters als YouTube-Nutzer authentifizieren oder als einer der Partnerkanäle agieren, indem du den onBehalfOfContentOwnerChannel-Parameter angibst, sofern für die aufgerufene Methode verfügbar.

8. August 2013

Dieses Update enthält die folgenden Änderungen:

30. Juli 2013

Dieses Update enthält die folgenden Änderungen:

  • In einer channelBanner-Ressource hat sich der Wert des Attributs kind von youtube#channelBannerInsertResponse zu youtube#channelBannerResource geändert. Diese Ressource wird als Antwort auf eine channelBanners.insert-Anfrage zurückgegeben.

  • Mit der neuen brandingSettings.channel.profileColor-Eigenschaft der channel-Ressource wird eine auffällige Farbe angegeben, die zu den Inhalten des Kanals passt. Der Attributwert besteht aus einem Pfundzeichen (#) gefolgt von einem sechsstelligen Hexadezimalstring, z. B. #2793e6.

  • Mit der API kannst du jetzt angeben, ob ein Abo für alle Aktivitäten eines Kanals oder nur für neue Uploads gilt. Das neue Attribut contentDetails.activityType der Ressource subscription gibt die Arten von Aktivitäten an, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sind all und uploads.

  • Die Methode videos.list unterstützt neue Parameter zum Abrufen eines Diagramms der beliebtesten Videos auf YouTube:

    • Der Parameter chart gibt das Diagramm an, das Sie abrufen möchten. Derzeit wird nur der Wert mostPopular unterstützt. Der chart-Parameter ist ein Filterparameter. Das bedeutet, dass er nicht in derselben Anfrage wie andere Filterparameter (id und myRating) verwendet werden kann.
    • Der Parameter videoCategoryId gibt die Videokategorie an, für die das Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart verwendet werden. Standardmäßig sind Diagramme nicht auf eine bestimmte Kategorie beschränkt.

  • Das neue Attribut topicDetails.relevantTopicIds[] der video-Ressource enthält eine Liste mit IDs der Freebase-Themen, die für das Video oder dessen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt oder im Video vorkommen.

  • Das Attribut recordingDetails.location.elevation der Ressource video wurde in recordingDetails.location.altitude umbenannt und das Attribut fileDetails.recordingLocation.location.elevation wurde in fileDetails.recordingLocation.location.altitude umbenannt.

  • Das Objekt contentDetails.contentRating der video-Ressource gibt die Altersfreigaben an, die ein Video nach verschiedenen Einstufungsschemata erhalten hat, einschließlich MPAA-Bewertungen, TVPG-Bewertungen usw. Die API unterstützt jetzt für jedes Bewertungssystem einen Bewertungswert, der angibt, dass das Video noch nicht bewertet wurde. Beachten Sie, dass bei MPAA-Altersfreigaben häufig die Einstufung "Nicht bewertet" verwendet wird, um ungeschnittene Versionen von Filmen zu kennzeichnen, für die die geschnittene Version des Films eine offizielle Einstufung erhalten hat.

  • Das neue Attribut contentDetails.contentRating.ytRating der Ressource video identifiziert Inhalte mit Altersbeschränkung. Der Property-Wert ist ytAgeRestricted, wenn YouTube festgestellt hat, dass das Video Inhalte enthält, die für Nutzer unter 18 Jahren unangemessen sind. Wenn die Property nicht vorhanden oder der Property-Wert leer ist, wurde der Inhalt nicht als Altersbeschränkung eingestuft.

  • Der Parameter mySubscribers der Methode channels.list wurde verworfen. Verwende die Methode subscriptions.list und den zugehörigen Parameter mySubscribers, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen.

  • Die Methoden channelBanners.insert, channels.update, videos.getRating und videos.rate unterstützen jetzt alle den Parameter onBehalfOfContentOwner. Dieser Parameter gibt an, dass der authentifizierte Nutzer im Namen des im Parameterwert angegebenen Rechteinhabers handelt.

  • Die Dokumentation der Methode channels.update wurde aktualisiert, um die Tatsache zu berücksichtigen, dass mit dieser Methode das Objekt brandingSettings der Ressource channel und ihre untergeordneten Attribute aktualisiert werden können. In der Dokumentation finden Sie jetzt auch die aktualisierte Liste der Attribute, die Sie für das invideoPromotion-Objekt der Ressource channel festlegen können.

  • In der error documentation werden die folgenden neuen Fehler beschrieben:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden accountDelegationForbidden Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Sie weist darauf hin, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln.
    forbidden authenticatedUserAccountClosed Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers geschlossen ist. Wenn der Nutzer im Auftrag eines anderen Google-Kontos handelt, bedeutet diese Fehlermeldung, dass das andere Konto geschlossen wurde.
    forbidden authenticatedUserAccountSuspended Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers gesperrt ist. Falls der Nutzer im Auftrag eines anderen Google-Kontos handelt, bedeutet diese Fehlermeldung, dass das andere Konto gesperrt wurde.
    forbidden authenticatedUserNotChannel Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Sie gibt an, dass der API-Server den mit der API-Anfrage verknüpften Kanal nicht identifizieren kann. Wenn die Anfrage autorisiert ist und den Parameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen.
    forbidden cmsUserAccountNotFound Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln.
    notFound contentOwnerAccountNotFound Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das angegebene Rechteinhaber-Konto wurde nicht gefunden.
    badRequest invalidPart Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Der Parameter part der Anfrage gibt Teile an, die nicht gleichzeitig geschrieben werden können.
    badRequest videoChartNotFound Die Methode videos.list gibt diesen Fehler zurück, wenn in der Anfrage ein nicht unterstütztes oder nicht verfügbares Videodiagramm angegeben ist.
    notFound videoNotFound Die Methode videos.update gibt diesen Fehler zurück, um anzuzeigen, dass das Video, das Sie aktualisieren möchten, nicht gefunden wurde. Prüfen Sie, ob der Wert des Attributs id im Anfragetext korrekt ist.

10. Juni 2013

Dieses Update enthält die folgenden Änderungen:

  • Mit dem neuen forUsername-Parameter der channels.list-Methode können Sie Informationen zu einem Kanal abrufen, indem Sie den zugehörigen YouTube-Nutzernamen angeben.

  • Die Methode activities.list unterstützt jetzt den Parameter regionCode, der die API anweist, Ergebnisse zurückzugeben, die für das angegebene Land relevant sind. YouTube verwendet diesen Wert, wenn die vorherige Aktivität des autorisierten Nutzers auf YouTube nicht genügend Informationen bietet, um den Aktivitätsfeed zu generieren.

  • Playlist-Ressourcen enthalten jetzt das Attribut snippet.tags. Die Property wird nur an autorisierte Nutzer zurückgegeben, die Daten zu ihren eigenen Playlists abrufen. Autorisierte Nutzer können auch Playlist-Tags festlegen, wenn sie die Methoden playlists.insert oder playlists.update aufrufen.

  • Der Parameter onBehalfOfContentOwner, der bisher für die Methoden channels.list und search.list unterstützt wurde, wird jetzt auch für die Methoden videos.insert, videos.update und videos.delete unterstützt. Wenn dieser Parameter in einem Aufruf der videos.insert-Methode verwendet wird, muss die Anfrage auch einen Wert für den neuen onBehalfOfContentOwnerChannel-Parameter angeben, der den Kanal identifiziert, zu dem das Video hinzugefügt wird. Der Kanal muss mit dem Rechteinhaber verknüpft sein, der durch den Parameter onBehalfOfContentOwner angegeben wird.

    Der Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

    Dieser Parameter ist für Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle haben und verwalten. Der Parameter ermöglicht es diesen Partnern, sich einmal zu authentifizieren und Zugriff auf alle ihre Video- und Kanaldaten zu erhalten, ohne Authentifizierungsdaten für jeden einzelnen Kanal angeben zu müssen.

    Insbesondere in Bezug auf diese Version ermöglicht der Parameter einem Content-Partner nun das Einfügen, Aktualisieren oder Löschen von Videos in allen YouTube-Kanälen, die dem Partner gehören.

  • In der error documentation werden die folgenden neuen Fehler beschrieben:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden insufficientCapabilities Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Es gibt an, dass der CMS-Nutzer, der die API aufruft, nicht über ausreichende Berechtigungen verfügt, um den angeforderten Vorgang auszuführen. Dieser Fehler hängt mit der Verwendung des Parameters onBehalfOfContentOwner zusammen, der für mehrere API-Methoden unterstützt wird.
    unauthorized authorizationRequired Die Methode activities.list gibt diesen Fehler zurück, wenn die Anfrage den Parameter home verwendet, aber nicht ordnungsgemäß autorisiert ist.
  • In der Ressource channels wurde das Attribut invideoPromotion.channelId entfernt, da die Channel-ID bereits über das Attribut id der Ressource angegeben wurde.

  • Im neuen Leitfaden Mit Kanal-IDs arbeiten wird erläutert, wie Kanal-IDs in der API verwendet werden. Das Handbuch ist besonders nützlich für Entwickler, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den default-Nutzer anfordern oder die auf der Annahme basieren, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat, was mittlerweile nicht mehr der Fall ist.

22. Mai 2013

Dieses Update enthält die folgenden Änderungen:

14. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Eigenständige Seiten enthalten jetzt Codebeispiele für Java, .NET, PHP und Ruby.

  • Die Seite mit Python-Codebeispielen enthält jetzt Beispiele zum Hinzufügen eines Abos, zum Erstellen einer Playlist und zum Aktualisieren eines Videos.

10. Mai 2013

Dieses Update enthält die folgenden Änderungen:

8. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Kanalressourcen unterstützen jetzt das Objekt inVideoPromotion, das Informationen zu einer mit dem Kanal verknüpften Werbekampagne enthält. Ein Kanal kann eine In-Video-Werbekampagne verwenden, um Thumbnail-Bilder für ein gesponsertes Video im Videoplayer anzuzeigen, während die Videos des Kanals wiedergegeben werden.

    Sie können diese Daten abrufen, indem Sie in einer channels.list-Anfrage invideoPromotion in den Parameterwert part aufnehmen.

  • Mit der neuen channels.update-Methode können die Daten der In-Video-Werbekampagne eines Kanals aktualisiert werden. Die Methode unterstützt nur Aktualisierungen des invideoPromotion-Teils der channel-Ressource. Aktualisierungen für andere Teile dieser Ressource werden noch nicht unterstützt.

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Kanalressourcen unterstützen jetzt die status.isLinked-Property, die angibt, ob die Kanaldaten einen Nutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+ Konto verknüpft ist. Ein Nutzer, der einen dieser Links hat, verfügt bereits über eine öffentliche YouTube-Identität. Diese ist Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos.

  • Aboressourcen unterstützen jetzt den subscriberSnippet-Teil. Das eingekapselte Objekt enthält Snippet-Daten für den Kanal des Abonnenten.

  • Die API unterstützt jetzt die Methode videos.getRating, mit der die Bewertungen abgerufen werden, die der authentifizierte Nutzer einer Liste mit einem oder mehreren Videos gegeben hat.

  • Mit dem neuen Parameter myRating der Methode videos.list können Sie eine Liste von Videos abrufen, die der authentifizierte Nutzer mit einer Bewertung von like oder dislike bewertet hat.

    Die Parameter myRating und id werden jetzt beide als Filterparameter betrachtet. Das bedeutet, dass in einer API-Anfrage genau einer der Parameter angegeben werden muss. Bisher war der Parameter id ein erforderlicher Parameter für diese Methode.

    Die Methode gibt den Fehler forbidden für Anfragen zurück, mit denen versucht wird, Informationen zur Videobewertung abzurufen, aber nicht über die entsprechende Berechtigung verfügen.

  • Mit der Einführung des Parameters myRating wurde auch die Methode videos.list aktualisiert, um die Paginierung zu unterstützen. Seitenparameter werden jedoch nur für Anfragen mit dem Parameter myRating unterstützt. (Paging-Parameter und -Informationen werden für Anfragen mit dem id-Parameter nicht unterstützt.)

    • Der Parameter maxResults gibt die maximale Anzahl von Videos an, die die API in den Ergebnissen zurückgeben kann, und der Parameter pageToken gibt eine bestimmte Seite in der Ergebnismenge an, die Sie abrufen möchten.

    • Die Ressource youtube#videoListResponse, die als Antwort auf eine videos.list-Anfrage zurückgegeben wird, enthält jetzt das Objekt pageInfo, das Details wie die Gesamtzahl der Ergebnisse und die Anzahl der Ergebnisse im aktuellen Ergebnissatz enthält. Die Ressource youtube#videoListResponse kann auch die Attribute nextPageToken und prevPageToken enthalten, die jeweils ein Token bereitstellen, mit dem eine bestimmte Seite im Ergebnissatz abgerufen werden kann.

  • Die Methode videos.insert unterstützt die folgenden neuen Parameter:

    • autoLevels: Setze diesen Parameterwert auf true, um YouTube anzuweisen, Licht und Farbe des Videos automatisch zu optimieren.
    • stabilize: Setze diesen Parameterwert auf true, um YouTube anzuweisen, Verwacklungen infolge von Kamerabewegungen zu entfernen.

  • Das Attribut channelTitle wurde dem snippet für die folgenden Ressourcen hinzugefügt:

    • playlistItem: Die Eigenschaft gibt den Namen des Kanals an, über den das Playlist-Element hinzugefügt wurde.
    • playlist: Die Eigenschaft gibt den Namen des Kanals an, der die Playlist erstellt hat.
    • subscription: Die Eigenschaft gibt den Namen des abonnierten Kanals an.

  • Für die folgenden Methoden wurden Codebeispiele hinzugefügt:

  • Mit dem neuen Parameter mySubscribers der Methode subscriptions.list können Sie eine Liste der Abonnenten des aktuell authentifizierten Nutzers abrufen. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

    Hinweis: Diese Funktion ersetzt den Parameter mySubscribers, der derzeit für die Methode channels.list unterstützt wird. Dieser Parameter wird eingestellt.

  • In einer video-Ressource ist der Attributwert unspecified nicht mehr ein möglicher Wert für folgende Attribute:

  • API-Anfragen, die einen unerwarteten Parameter enthalten, geben jetzt den Fehler badRequest zurück und als Grund für den Fehler wird unexpectedParameter gemeldet.

  • Der Fehler, den die Methode playlistItems.insert zurückgibt, wenn die Playlist bereits die maximal zulässige Anzahl von Elementen enthält. Der Fehler wird jetzt als forbidden-Fehler gemeldet und die Fehlerursache ist playlistContainsMaximumNumberOfVideos.

19. April 2013

Dieses Update enthält die folgenden Änderungen:

  • Mit der neuen videos.rate-Methode können Nutzer eine like- oder dislike-Bewertung für ein Video festlegen oder eine Bewertung für ein Video entfernen.

    Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun eine Liste der Fehler, die die API möglicherweise als Antwort auf einen videos.rate-Methodenaufruf zurückgibt.

  • Thumbnail-Bilder werden in der API-Dokumentation jetzt als separate Ressource identifiziert. Mit der neuen thumbnails.set-Methode kannst du ein benutzerdefiniertes Video-Thumbnail auf YouTube hochladen und für ein Video festlegen.

    Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun eine Liste der Fehler, die die API möglicherweise als Antwort auf einen thumbnails.set-Methodenaufruf zurückgibt.

    Diese Änderung wirkt sich nicht wirklich auf vorhandene Ressourcen aus, die Miniaturansichten zurückgeben. Miniaturansichten werden in diesen Ressourcen auf dieselbe Weise wie zuvor zurückgegeben. Allerdings werden jetzt in der Dokumentation die Namen der verschiedenen Miniaturansichtsgrößen aufgeführt, die von der API zurückgegeben werden könnten.

  • Der neue brandingSettings-Teil der channel-Ressource identifiziert Einstellungen, Text und Bilder für die Kanalseite und die Videowiedergabeseiten des Kanals.

  • Die Ressource playlistItem enthält die folgenden neuen Attribute:

    • Das neue status-Objekt enthält Statusinformationen über das Playlist-Element und die status.privacyStatus-Eigenschaft gibt den Datenschutzstatus des Playlist-Elements an.

  • Die Ressource video enthält die folgenden neuen Attribute:

  • Die Dokumentation der Methode playlistItems.update wurde aktualisiert, um die Tatsache zu berücksichtigen, dass das Attribut snippet.resourceId in der als Anfragetext gesendeten Ressource angegeben werden muss.

  • Die Methode search.list unterstützt jetzt die folgenden Funktionen:

    • Der neue forMine-Parameter schränkt eine Suche so ein, dass nur die Videos des authentifizierten Nutzers abgerufen werden.

    • Mit dem Parameter order können Ergebnisse jetzt alphabetisch nach Titel (order=title) oder nach Anzahl der Videos in absteigender Reihenfolge (order=videoCount) sortiert werden.

    • Der neue safeSearch-Parameter gibt an, ob Suchergebnisse eingeschränkte Inhalte enthalten sollen.

  • Die Methode videos.insert unterstützt mehrere neue Fehler, die in der folgenden Tabelle aufgeführt sind:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest invalidCategoryId Die Eigenschaft snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating Die Metadaten der Anfrage geben eine ungültige Altersfreigabe für das Videospiel an.
    badRequest invalidVideoMetadata Die Metadaten der Anfrage sind ungültig.
  • Der Parameter onBehalfOfContentOwner wurde aus der Liste der unterstützten Parameter für die Methoden videos.update und videos.delete entfernt.

12. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Das Attribut channelTitle wurde dem snippet für die folgenden Ressourcen hinzugefügt:

    • activity: Die Property gibt den Namen des Kanals an, der für die Aktivität verantwortlich ist.
    • search: Die Eigenschaft gibt den Namen des Kanals an, der mit der Ressource verknüpft ist, die das Suchergebnis angibt.
    • video: Die Property gibt den Namen des Kanals an, über den das Video hochgeladen wurde.

  • Die Methode search.list unterstützt die folgenden neuen Parameter:

    • Mit dem Parameter channelType kannst du die Suche nach Kanälen auf alle Kanäle oder nur auf Sendungen beschränken.

    • Mit dem Parameter videoType kannst du die Suche nach Videos einschränken, um alle Videos oder nur Filme oder Folgen von Serien abzurufen.

  • Die Definition des recordingDetails-Teils der video-Ressource wurde aktualisiert. Das Objekt wird nur dann für ein Video zurückgegeben, wenn die Daten zur Standortbestimmung oder die Aufzeichnungszeit des Videos festgelegt wurden.

  • Die Methode playlistItems.update gibt jetzt den Fehler invalidSnippet zurück, der zurückgegeben wird, wenn in der API-Anfrage kein gültiges Snippet angegeben ist.

  • Mehrere API-Methoden unterstützen neue Parameter, die ausschließlich für YouTube-Content-Partner bestimmt sind. Zu den YouTube-Content-Partnern gehören Film- und Fernsehstudios, Plattenfirmen und andere Ersteller von Inhalten, die ihre Inhalte auf YouTube zur Verfügung stellen.

    • Der Parameter onBehalfOfContentOwner gibt an, dass in den Autorisierungsdaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

      Dieser Parameter ist für Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle haben und verwalten. Der Parameter ermöglicht es diesen Partnern, sich einmal zu authentifizieren und Zugriff auf alle ihre Video- und Kanaldaten zu erhalten, ohne Authentifizierungsdaten für jeden einzelnen Kanal angeben zu müssen.

      Die Methoden channels.list, search.list, videos.delete, videos.list und videos.update unterstützen diesen Parameter.

    • Der von der channels.list-Methode unterstützte managedByMe-Parameter weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die mit dem onBehalfOfContentOwner-Parameter angegeben werden.

    • Der von der search.list-Methode unterstützte forContentOwner-Parameter weist die API an, Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der mit dem onBehalfOfContentOwner-Parameter angegeben wird.

25. Februar 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt mehrere neue Teile und Eigenschaften für video-Ressourcen:

    • Die neuen Abschnitte fileDetails, processingDetails und suggestions bieten Videoinhabern Informationen zu ihren hochgeladenen Videos. Diese Daten sind in Anwendungen, die Videouploads ermöglichen, sehr nützlich und umfassen Folgendes:

      • Verarbeitungsstatus und Fortschritt
      • Fehler oder andere Probleme bei der Verarbeitung eines Videos
      • Verfügbarkeit von Thumbnail-Bildern
      • Vorschläge zur Verbesserung der Qualität von Videos oder Metadaten
      • Details zur Originaldatei, die auf YouTube hochgeladen wurde

      Alle diese Teile können nur vom Videoinhaber abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der video-Ressourcendokumentation werden alle Eigenschaften definiert, die die einzelnen Teile enthalten.

      • Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, einschließlich Auflösung, Dauer, Audio- und Video-Codecs, Stream-Bitraten und mehr.

      • Das Objekt processingProgress enthält Informationen zum Fortschritt bei der Verarbeitung der hochgeladenen Videodatei durch YouTube. Die Eigenschaften des Objekts geben den aktuellen Verarbeitungsstatus an und schätzen die verbleibende Zeit, bis YouTube das Video verarbeitet hat. Dieser Teil gibt auch an, ob verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Miniaturansichten für das Video verfügbar sind.

        Dieses Objekt ist für den Abruf vorgesehen, damit der Video-Uploader den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei verfolgen kann.

      • Das suggestions-Objekt enthält Vorschläge zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video.

    • Der contentDetails-Teil enthält vier neue Attribute. Diese Attribute können mit nicht authentifizierten Anfragen abgerufen werden.

      • dimension: Gibt an, ob das Video in 2D oder 3D verfügbar ist.
      • definition: Gibt an, ob das Video in Standard oder High Definition verfügbar ist.
      • caption: Gibt an, ob für das Video Untertitel verfügbar sind.
      • licensedContent: Gibt an, ob das Video Inhalte enthält, auf die ein YouTube-Contentpartner Anspruch erhoben hat.

    • Der Teil status enthält zwei neue Attribute. Videoeigentümer können beim Einfügen oder Aktualisieren eines Videos Werte für beide Eigenschaften festlegen. Diese Attribute können auch mit nicht authentifizierten Anfragen abgerufen werden.

      • embeddable: Gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
      • license: Gibt die Lizenz des Videos an. Gültige Werte sind creativeCommon und youtube.

  • Die Definition des Parameters part wurde für die Methoden videos.list, videos.insert und videos.update aktualisiert, um die oben beschriebenen neu hinzugefügten Teile sowie den Teil recordingDetails aufzulisten, der versehentlich weggelassen wurde.

  • Die neue Eigenschaft contentDetails.googlePlusUserId der Ressource channel gibt die mit dem Kanal verknüpfte Google+ Profil-ID an. Dieser Wert kann verwendet werden, um einen Link zum Google+ Profil zu generieren.

  • Für jedes Miniaturansicht-Bildobjekt werden nun Breite und Höhe des Bildes angegeben. Miniaturansichten werden derzeit in Ressourcen vom Typ activity, channel, playlist, playlistItem, search result, subscription und video zurückgegeben.

  • playlistItems.list unterstützt jetzt den videoId-Parameter, der zusammen mit dem playlistId-Parameter verwendet werden kann, um nur das Playlist-Element abzurufen, das das angegebene Video repräsentiert.

    Die API gibt den Fehler notFound zurück, wenn das durch den Parameter identifizierte Video nicht in der Playlist gefunden wird.

  • In der Fehlerdokumentation wird ein neuer forbidden-Fehler beschrieben, der angibt, dass eine Anfrage für die angeforderte Aktion nicht ordnungsgemäß autorisiert ist.

  • Das Attribut snippet.channelId der Ressource channel wurde entfernt. Das Attribut id der Ressource hat denselben Wert.

30. Januar 2013

Dieses Update enthält die folgenden Änderungen:

  • Auf der neuen error-Seite werden Fehler aufgelistet, die die API zurückgeben kann. Die Seite enthält allgemeine Fehler, die bei mehreren verschiedenen API-Methoden auftreten können, sowie methodenspezifische Fehler.

16. Januar 2013

Dieses Update enthält die folgenden Änderungen:

  • Für die in der folgenden Liste aufgeführten Methoden und Sprachen sind jetzt Codebeispiele verfügbar:

  • Eine activity-Ressource kann jetzt eine channelItem-Aktion melden, die auftritt, wenn YouTube einem automatisch generierten YouTube-Kanal ein Video hinzufügt. YouTube ermittelt anhand von Algorithmen Themen, die auf der YouTube-Website häufig vorkommen, und erstellt automatisch Kanäle für diese Themen.

  • Die folgenden search.list-Parameter wurden aktualisiert:

    • Der Parameter q ist nicht mehr als Filter gekennzeichnet.
    • Der Parameter relatedToVideo wurde in relatedToVideoId umbenannt.
    • Der Parameter published wurde durch die beiden neuen Parameter publishedAfter und publishedBefore ersetzt, die unten beschrieben werden.

  • Die Methode search.list unterstützt die folgenden neuen Parameter:

    Parametername Wert Beschreibung
    channelId string Gibt Ressourcen zurück, die vom angegebenen Kanal erstellt wurden.
    publishedAfter datetime Gibt Ressourcen zurück, die nach der angegebenen Zeit erstellt wurden.
    publishedBefore datetime Gibt Ressourcen zurück, die vor dem angegebenen Zeitpunkt erstellt wurden.
    regionCode string Gibt Ressourcen für das angegebene Land zurück.
    videoCategoryId string Sie können die Videosuchergebnisse so filtern, dass nur Videos enthalten sind, die der angegebenen Videokategorie zugeordnet sind.
    videoEmbeddable string Sie können die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die in einem eingebetteten Player auf einer Webseite abgespielt werden können. Setze den Parameterwert auf true, um nur einzubettende Videos abzurufen.
    videoSyndicated string Filtere die Videosuchergebnisse so, dass nur Videos enthalten sind, die außerhalb von YouTube.com abgespielt werden können. Setze den Parameterwert auf true, um nur syndizierte Videos abzurufen.
  • Mehrere API-Ressourcen unterstützen neue Attribute. In der folgenden Tabelle sind die Ressourcen und ihre neuen Eigenschaften aufgeführt:

    Ressource Property-Name Wert Beschreibung
    activity contentDetails.playlistItem.playlistItemId string Die ID des Playlist-Elements, die YouTube zugewiesen hat, um das Element in der Playlist eindeutig zu identifizieren.
    activity contentDetails.channelItem object Ein Objekt, das Informationen zu einer Ressource enthält, die einem Channel hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type den Wert channelItem hat.
    activity contentDetails.channelItem.resourceId object Ein Objekt, das die Ressource identifiziert, die dem Kanal hinzugefügt wurde. Wie andere resourceId-Properties enthält sie eine kind-Eigenschaft, die den Ressourcentyp angibt, z. B. Video oder Playlist. Es enthält auch genau eine von mehreren Eigenschaften – videoId, playlistId usw. –, die die ID angibt, die diese Ressource eindeutig identifiziert.
    channel status object Dieses Objekt enthält Informationen zum Datenschutzstatus des Kanals.
    channel status.privacyStatus string Der Datenschutzstatus des Kanals. Gültige Werte sind private und public.
    playlist contentDetails object Dieses Objekt enthält Metadaten zum Inhalt der Playlist.
    playlist contentDetails.itemCount unsigned integer Die Anzahl der Videos in der Playlist.
    playlist player object Dieses Objekt enthält Informationen, mit denen du die Playlist in einem eingebetteten Player abspielen würdest.
    playlist player.embedHtml string Ein <iframe>-Tag, das einen Videoplayer einbettet, der die Playlist wiedergibt.
    video recordingDetails object Dieses Objekt enthält Informationen, die den Ort und die Uhrzeit der Videoaufzeichnung identifizieren oder beschreiben.
    video recordingDetails.location object Dieses Objekt enthält Standortinformationen, die mit dem Video verknüpft sind.
    video recordingDetails.location.latitude double Breitengrad in Grad
    video recordingDetails.location.longitude double Längengrad in Grad
    video recordingDetails.location.elevation double Höhe über der Erde in Metern
    video recordingDetails.locationDescription string Eine Textbeschreibung des Ortes, an dem das Video aufgezeichnet wurde.
    video recordingDetails.recordingDate datetime Datum und Uhrzeit der Videoaufzeichnung Der Wert wird im Format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
  • In der Dokumentation für mehrere API-Methoden werden nun Eigenschaften angegeben, die im Anfragetext angegeben werden müssen oder basierend auf den Werten im Anfragetext aktualisiert werden. In der folgenden Tabelle sind diese Methoden sowie die erforderlichen oder änderbaren Eigenschaften aufgeführt.

    Hinweis:In der Dokumentation für andere Methoden werden möglicherweise bereits erforderliche und änderbare Eigenschaften aufgeführt.

    Methode Attribute
    activities.insert Erforderliche Attribute:
    • snippet.description
    Anpassbare Eigenschaften:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update Erforderliche Attribute:
    • id
    playlistItems.update Erforderliche Attribute:
    • id
    videos.update Erforderliche Attribute:
    • id
  • Die API meldet keinen playlistAlreadyExists-Fehler mehr, wenn du versuchst, eine Playlist zu erstellen oder zu aktualisieren, die denselben Titel wie eine bereits auf demselben Kanal vorhandene Playlist hat.

  • Mehrere API-Methoden unterstützen neue Fehlertypen. In der folgenden Tabelle sind die Methode und die neu unterstützten Fehler aufgeführt:

    Methode Fehlertyp Fehlerdetails Beschreibung
    guideCategories.list notFound notFound Die durch den Parameter id identifizierte Guide-Kategorie wurde nicht gefunden. Verwenden Sie die Methode guideCategories.list, um eine Liste gültiger Werte abzurufen.
    playlistItems.delete forbidden playlistItemsNotAccessible Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen.
    videoCategories.list notFound videoCategoryNotFound Die durch den Parameter id angegebene Videokategorie kann nicht gefunden werden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.