Diese Seite wurde von der Cloud Translation API übersetzt.

Überarbeitungsverlauf

Auf dieser Seite findest du Änderungen an der YouTube Data API (Version 3) und Aktualisierungen der Dokumentation. Dieses Änderungsprotokoll abonnieren.

30. Oktober 2024

Die API unterstützt jetzt die Identifizierung von Videos, die realistische veränderte oder synthetische (A/S) Inhalte enthalten. Weitere Informationen zu den YouTube-Richtlinien zu Inhalten mit Alters- und Geschlechtsidentität

Beispiele für A/S-Inhalte:

Eine echte Person etwas sagen oder tun lassen, was sie nicht gesagt oder getan hat
veränderte Aufnahmen eines realen Ereignisses oder Orts enthalten
Es enthält eine realistisch anmutende Szene, die nicht wirklich stattgefunden hat.

Mit der Property status.containsSyntheticMedia kannst du angeben, ob ein Video A/S-Inhalte enthält. Dieses Attribut kann beim Aufrufen der Methoden videos.insert oder videos.update festgelegt werden. Wenn festgelegt, wird die Property in der Ressource video zurückgegeben.

30. April 2024

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Dieses Update enthält die folgenden Änderungen:

Die API unterstützt nicht mehr das Einfügen oder Abrufen von Kanaldiskussionen. Diese Änderung entspricht der Funktion auf der YouTube-Website, bei der das Posten von Kommentaren auf Kanälen nicht unterstützt wird.

13. März 2024

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Dieses Update enthält die folgenden Änderungen:

Der Parameter sync für die Methoden captions.insert und captions.update wurde eingestellt. YouTube unterstützt den Parameter ab dem 12. April 2024 nicht mehr.

Aufgrund dieser Änderung müssen Entwickler beim Einfügen oder Aktualisieren von Untertiteln Zeitinformationen angeben, damit der Upload fehlschlägt.

12. März 2024

Dieses Update enthält die folgenden Änderungen:

Die Dokumentation für die Ressource captions wurde aktualisiert, um zu verdeutlichen, dass die maximal zulässige Länge für das Feld snippet.name 150 Zeichen beträgt. Die API gibt den Fehler nameTooLong zurück, wenn der Trackname länger ist.

7. März 2024

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Die channel-Ressourceneigenschaft brandingSettings.channel.moderateComments wird nicht mehr unterstützt. YouTube unterstützt den Parameter ab dem 7. März 2024 nicht mehr.

31. Januar 2024

Dieses Update enthält die folgenden Änderungen:

Mit dem neuen Parameter forHandle der Methode channels.list kannst du Informationen zu einem Kanal abrufen, indem du seinen YouTube-Alias angibst.

9. November 2023

Alle Verweise auf die videoId-Ressource unter Comments wurden entfernt, da die videoId-Ressource nicht über einen API-Aufruf zurückgegeben wird.

12. September 2023

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Die Methode comments.markAsSpam wurde vor einigen Jahren eingestellt. Diese Methode wird bereits auf YouTube nicht mehr unterstützt und wird auch nicht mehr über die API unterstützt.

Allen Dokumenten, in denen auf die Methode comments.markAsSpam verwiesen wird, wurde ein Hinweis auf die Einstellung hinzugefügt.

22. August 2023

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

18. August 2023

Die Definition von liveStreamingDetails.concurrentViewers für die video-Ressource wurde aktualisiert. Es wird nun darauf hingewiesen, dass sich die Anzahl der gleichzeitigen Zuschauer, die von der YouTube Data API zurückgegeben wird, von der Anzahl der verarbeiteten, von Spam befreiten gleichzeitigen Zuschauer unterscheiden kann, die über YouTube Analytics verfügbar ist. 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: Dies ist eine Ankündigung zu eingestellten Funktionen.

Der Parameter relatedToVideoId der Methode search.list wurde eingestellt. YouTube unterstützt den Parameter ab dem 7. August 2023 nicht mehr.

Derzeit wurde der Dokumentation der search.list-Methode eine entsprechende Mitteilung hinzugefügt. Dieser Parameter wird ab dem 7. August 2023 vollständig aus der search.list-Dokumentation entfernt.

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

22. August 2022

Korrektur der Typanmerkungen für Felder von video.statistics von „unsigned long“ zu „string“.

5. August 2022

YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Rahmen dieser Änderung werden allen Untertitel-Tracks neue Untertitel-IDs zugewiesen. Diese Änderung ist möglicherweise nicht abwärtskompatibel für Anwendungen, die caption_id-Werte speichern. Sie hat jedoch keine Auswirkungen auf Anwendungen, die keine caption_id-Werte speichern.

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

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 Untertiteldaten speicherst, die aktuell gespeicherten Daten löschen und dann die Methode captions.list aufrufen solltest, um die aktuellen 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 finden Sie in der Versionsgeschichte der Nutzungsbedingungen für YouTube API-Dienste.

27. April 2022

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

8. April 2022

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

15. Dezember 2021

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

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

18. November 2021

Im Zusammenhang mit den Änderungen an der Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform wird die Property statistics.dislikeCount der Ressource video ab dem 13. Dezember 2021 zu „Privat“ geändert. Das bedeutet, dass die Property nur dann in einer API-Antwort vom videos.list-Endpunkt enthalten ist, wenn die API-Anfrage vom Inhaber des Videos authentifiziert wurde.

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

Entwickler, die die Anzahl der „Mag ich nicht“-Bewertungen nicht öffentlich anzeigen, sie aber für ihren API-Client benötigen, können eine Ausnahme beantragen und auf die Zulassungsliste 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: Dies ist eine Ankündigung zur Einstellung.

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

und, wenn für Ihren Code eine commentThreads-Ressource erforderlich ist, führen Sie einen sekundären Aufruf der Methode commentThreads.list aus.

1. Juli 2021

Alle Entwickler, die die API-Dienste von YouTube verwenden, müssen sich einer API-Compliance-Prüfung unterziehen, damit ihnen ein höheres Kontingent von 10.000 Einheiten zugewiesen werden kann. Bisher wurden sowohl die Complianceprüfung als auch Anfragen nach zusätzlichen Kontingenten von Entwicklern durchgeführt, die das Formular für YouTube API-Dienste – Audit und Kontingenterweiterung ausgefüllt und eingereicht haben.

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

Formular für Anfragen von geprüften Entwicklern: Entwickler, die bereits eine API-Compliance-Prüfung bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Erhöhung des zugewiesenen Kontingents zu beantragen.
Einspruchsformular: Entwickler, deren API-Projekte die Complianceprüfung nicht bestanden haben oder deren Erhöhung abgelehnt wurde, können dieses Formular ausfüllen und einreichen.
Formular für den Kontrollwechsel: Entwickler oder andere Parteien, die einen API-Client im Namen eines Entwicklers betreiben und bei denen ein Kontrollwechsel (z. B. durch einen Aktienkauf oder -verkauf, eine Fusion oder eine andere Unternehmenstransaktion) im Zusammenhang mit einem API-Projekt auftritt, müssen dieses Formular ausfüllen und einreichen. So kann das API-Team von YouTube unsere Aufzeichnungen aktualisieren, die Compliance des neuen API-Projekts prüfen und die aktuelle Kontingentzuweisung des Entwicklers validieren.

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

Weitere Informationen finden Sie in unserem neuen Leitfaden zu Compliance-Audits für APIs.

12. Mai 2021

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Dieses Update umfasst die folgenden API-Änderungen:

Die Property contentDetails.relatedPlaylists.favorites der Ressource channel wird nicht mehr unterstützt. Wie im Überarbeitungsverlauf am 28. April 2016 erwähnt, wurde die Funktion „Favoriten“ bereits vor einigen Jahren eingestellt.

Vor diesem Update wurde von der API weiterhin eine neue Playlist erstellt, wenn ein API-Client versuchte, einem nicht vorhandenen Favoriten-Video eine Video hinzuzufügen. In diesem Fall wird die Playlist in Zukunft nicht erstellt und die API gibt einen Fehler zurück. Versuche, Favoritenplaylists durch Hinzufügen, Ändern oder Löschen von Elementen zu ändern, sind gemäß vorherigen Ankündigungen ebenfalls eingestellt und können jederzeit Fehler zurückgeben.
Die folgenden channel-Ressourceneigenschaften wurden eingestellt. Diese Eigenschaften werden bereits in der YouTube Studio-Benutzeroberfläche und auf YouTube 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 Attribute wurden aus der channel-Ressourcendarstellung entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden Fehler, die mit diesen Properties zusammenhängen, aus der methodenspezifischen Dokumentation entfernt.
Die folgenden channelSection-Ressourceneigenschaften wurden eingestellt. Diese Properties werden in der Benutzeroberfläche von YouTube Studio 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 Zusammenhang mit dieser Änderung wurde auch der Parameter hl der Methode channelSection.list eingestellt, da die von ihm unterstützten Funktionen nicht mehr unterstützt werden.

Alle Attribute wurden aus der channelSection-Ressourcendarstellung entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden Fehler, die mit diesen Properties zusammenhängen, aus der methodenspezifischen Dokumentation entfernt.
Für das Attribut snippet.type der Ressource channelSection wurden die folgenden Werte eingestellt. Diese Werte werden auf YouTube-Kanalseiten bereits nicht unterstützt und daher auch nicht mehr über die API unterstützt.
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
Die Property snippet.tags[] der Ressource playlist wird nicht mehr unterstützt. Dieses Attribut wird bereits auf YouTube nicht mehr unterstützt und daher auch nicht mehr über die API.

9. Februar 2021

Die Ressource playlistItem unterstützt zwei neue Properties:

Die Eigenschaft snippet.videoOwnerChannelId identifiziert die ID des Kanals, auf dem das Playlist-Video hochgeladen wurde.
Die Eigenschaft snippet.videoOwnerChannelTitle gibt den Namen des Kanals an, über den das Playlist-Video hochgeladen wurde.

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 einen neuen playlistOperationUnsupported-Fehler. Der Fehler tritt auf, wenn bei einer Anfrage versucht wird, eine Aktion auszuführen, die für eine bestimmte Playlist nicht zulässig ist. Ein Nutzer kann beispielsweise kein Video aus der Playlist mit seinen hochgeladenen Videos löschen oder die Playlist selbst löschen.

In allen Fällen wird bei diesem 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 der Nutzer kann zwar nicht über die API zugegriffen werden, diese Fehler werden jedoch nicht von der API zurückgegeben.

15. Oktober 2020

Den Richtlinien für Entwickler wurden zwei neue Abschnitte hinzugefügt:

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 über einen eingebetteten YouTube-Player an uns sendest, bevor der Nutzer mit dem Player interagiert hat, um seine Wiedergabeabsicht zu signalisieren. Du kannst die Daten, die mit YouTube geteilt werden, einschränken, bevor ein Nutzer mit dem Player interagiert. Dazu musst du „Autoplay“ auf „false“ setzen.
Der neue Abschnitt III.E.4.j bezieht sich auf die Prüfung des Status „Inhalte speziell für Kinder“ (MFK) von Inhalten, bevor sie in Websites und Apps eingebettet werden. Du bist dafür verantwortlich, zu wissen, wann Videos, die du in deinem API-Client einbettest, speziell für Kinder sind, und die über den eingebetteten Player erhobenen Daten entsprechend zu behandeln. Daher musst du den Status der Inhalte mit dem YouTube Data API-Dienst prüfen, bevor du sie über einen eingebetteten YouTube-Player in deinen API-Client einbettest.

Im neuen Leitfaden So findest du den MadeForKids-Status eines Videos erfährst du, wie du mit dem YouTube Data API-Dienst den Status „speziell für Kinder“ eines Videos ermittelst.

Im Zusammenhang mit diesen Änderungen wurde der Dokumentation zu den Parametern für eingebettete Player eine Erinnerung hinzugefügt, dass bei aktivierter automatischer Wiedergabe die Wiedergabe ohne Nutzerinteraktion mit dem Player erfolgt. Die Erfassung und Weitergabe von Wiedergabedaten erfolgt daher beim Laden der Seite.

8. Oktober 2020

Dieses Update umfasst drei kleine Änderungen an der channel-Ressource:

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

9. September 2020

Hinweis: Dies ist eine Ankündigung zur Einstellung.

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

Die folgenden API-Ressourcen, ‑Methoden, ‑Parameter und ‑Ressourceneigenschaften werden sofort eingestellt und funktionieren ab dem Datum dieser Mitteilung nicht mehr:
- Die folgenden channel-Ressourcenattribute:
  - Das statistics.commentCount-Attribut
  - Das brandingSettings.image-Objekt und alle untergeordneten Attribute
  - Die Liste brandingSettings.hints und alle untergeordneten Attribute
- 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 der Parameter managedByMe in der API-Anfrage auf true festgelegt wird. Diese Änderung hat keine Auswirkungen auf die Property prevPageToken bei anderen channels.list-Anfragen und auch nicht auf die Property nextPageToken bei Anfragen.
Die Attribute contentDetails.relatedPlaylists.watchLater und contentDetails.relatedPlaylists.watchHistory der Ressource channel wurden beide am 11. August 2016 als veraltet angekündigt. Die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurde ebenfalls vollständig eingestellt und die beiden Attribute wurden aus der Dokumentation entfernt.
Der Parameter mySubscribers der Methode channels.list, der am 30. Juli 2013 eingestellt wurde, wurde aus der Dokumentation entfernt. Verwende die Methode subscriptions.list und den 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 die Abrechnung des Kontingents für API-Anfragen vereinfacht, indem wir die zusätzlichen Kosten für den Parameter part entfernt haben. Ab sofort werden Ihnen nur die Grundkosten für die aufgerufene Methode in Rechnung gestellt. Weitere Informationen zum vereinfachten Kontingent finden Sie hier.

Die meisten API-Aufrufe haben dadurch geringfügig niedrigere Kontingentkosten, bei einigen API-Aufrufen bleiben die Kosten jedoch gleich. Die Kosten für API-Aufrufe werden durch diese Änderung nicht erhöht. Insgesamt wird Ihr zugewiesenes Kontingent, das Sie in der Google Cloud Console sehen, wahrscheinlich etwas länger reichen.

Wir empfehlen allen Entwicklern dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, damit sie weiterhin auf die YouTube API-Dienste zugreifen können.

Dieser Eintrag in der Versionsgeschichte wurde ursprünglich am 20. Juli 2020 veröffentlicht.

28. Juli 2020

Alle Videos, die über den videos.insert-Endpunkt aus nicht bestätigten API-Projekten hochgeladen wurden, die nach dem 28. Juli 2020 erstellt wurden, sind nur im Modus „Privat ansehen“ verfügbar. Damit diese Einschränkung aufgehoben wird, muss jedes Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu bestätigen.

Creator, die Videos mit einem nicht bestätigten API-Client hochladen, erhalten eine E-Mail, in der sie darüber informiert werden, dass ihr Video als „Privat“ gesperrt ist und sie die Einschränkung mithilfe eines offiziellen oder geprüften Clients vermeiden können.

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

21. Juli 2020

[Aktualisiert am 28. Juli 2020] Die in diesem Änderungsverlauf erwähnte Dokumentenaktualisierung wurde am 28. Juli 2020 noch einmal veröffentlicht.

Gestern haben wir eine Aktualisierung der Dokumentation zu unserem Verfahren zur Abrechnung des Kontingents veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Änderung des Kontingents jedoch noch nicht in Kraft. Daher wurde die Dokumentation zugunsten der Richtigkeit rückgängig gemacht. Um Verwirrung zu vermeiden, wurde der Eintrag im Änderungsverlauf, der die Änderung erklärt, entfernt. Er wird in Kürze wieder veröffentlicht.

7. Juli 2020

Hinweis: Dies ist eine Ankündigung zur Einstellung.

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 keine Auswirkungen auf die Verarbeitung neu hochgeladener Videos.

15. Juni 2020

In der neuen Anleitung Einhaltung der YouTube-Richtlinien für Entwickler findest du Hinweise und Beispiele, wie du dafür sorgen kannst, dass deine API-Clients bestimmte Teile der Nutzungsbedingungen und Richtlinien für YouTube API-Dienste einhalten.

Dieser Leitfaden bietet einen Einblick darin, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt, ersetzt jedoch keine vorhandenen Dokumente. In diesem Leitfaden werden einige der häufigsten Fragen von Entwicklern bei API-Compliance-Audits beantwortet. Wir hoffen, dass die Entwicklung von Funktionen durch die Interpretation und Durchsetzung unserer Richtlinien vereinfacht werden kann.

4. Juni 2020

Hinweis: Dies ist eine Aktualisierung einer früheren Ankündigung zur Einstellung.

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

17. April 2020

Hinweis: Dies ist eine Ankündigung zur Einstellung.

Das Kanalbulletin wird von YouTube eingestellt. Daher wird die Methode activities.insert eingestellt und die Methode activities.list gibt keine Kanalmeldungen mehr zurück. Diese Änderungen treten am oder nach dem 18. Mai 2020 in der API in Kraft. Weitere Informationen findest du in der YouTube-Hilfe.

31. März 2020

Dieses Update enthält die folgenden Änderungen:

Neue Ressourcen und Methoden
- Die neue member-Ressource steht für ein Kanalmitglied eines YouTube-Kanals. Ein Mitglied unterstützt einen Creator regelmäßig finanziell und erhält dafür spezielle Vorteile. So können Mitglieder beispielsweise chatten, wenn der Creator den Modus „Nur für Mitglieder“ für einen Chat aktiviert.
  
  Diese Ressource ersetzt die sponsor-Ressource, die in der YouTube Live Streaming API dokumentiert ist. Die Ressource sponsor wird jetzt eingestellt. API-Clients sollten Aufrufe der Methode sponsors.list so aktualisieren, dass stattdessen die Methode members.list verwendet wird.
- Die neue Ressource membershipsLevel 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 Erkennung von Inhalten, die sich an Kinder richten und auf YouTube als „speziell für Kinder“ gekennzeichnet sind. 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 speziell für Kinder erkennen können:

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

Bei Kanälen kann diese Eigenschaft beim Aufrufen der Methode channels.update festgelegt werden. Bei Videos kann dieses Attribut beim Aufrufen der Methode videos.insert oder videos.update festgelegt werden.

Hinweis: Dieses Attribut wird nur dann in API-Antworten mit Ressourcen vom Typ channel oder video einbezogen, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
Über die Property madeForKids kann jeder Nutzer den Status „speziell für Kinder“ eines Kanals oder Videos abrufen. Der Status kann beispielsweise anhand des Werts der Eigenschaft 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 und die Richtlinien für Entwickler der YouTube API-Dienste aktualisiert. Weitere Informationen finden Sie in der Versionsgeschichte der Nutzungsbedingungen für YouTube API-Dienste. Die Änderungen an den Nutzungsbedingungen für YouTube API-Dienste und den Entwicklerrichtlinien treten am 10. Januar 2020 (UTC-8) in Kraft.

10. September 2019

Die API-Referenzdokumentation wurde aktualisiert, um die Art und Weise zu berücksichtigen, wie Abonnentenzahlen auf YouTube und folglich auch in API-Antworten angezeigt werden. Aufgrund dieser Änderung wird die vom YouTube Data API-Dienst zurückgegebene Abonnentenzahl bei Abonnentenzahlen von mehr als 1.000 Abonnenten auf drei signifikante Stellen abgerundet. Diese Änderung betrifft die Property statistics.subscriberCount der Ressource channel.

Hinweis: Diese Änderung wirkt sich auf diesen Property-Wert auch dann 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. In der folgenden Tabelle findest du Beispiele dafür, wie Abonnentenzahlen in API-Antworten gerundet und auf 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 hierfür finden Sie in der Dokumentation der 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 und dann tatsächliche API-Anfragen senden und die tatsächlichen API-Antworten sehen. 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 Gängige Anwendungsfälle werden ein oder mehrere gängige Anwendungsfälle für die auf der Seite beschriebene Methode beschrieben. Du könntest beispielsweise die Methode channels.list aufrufen, um Daten zu einem 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 APIs Explorer im Vollbildmodus öffnen, in dem diese Werte bereits eingetragen sind. Diese Änderungen sollen es Ihnen leichter machen, 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 für Codebeispiele wurde ebenfalls aktualisiert und bietet jetzt eine neue Benutzeroberfläche mit den oben beschriebenen Funktionen. 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 zu erhalten.

Im Rahmen dieser Änderung wurden auch 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 beschrieben, wie Sie ein Beispiel mit einem API-Schlüssel und ein anderes Beispiel mit einer OAuth 2.0-Client-ID mithilfe von Codebeispielen aus dem APIs Explorer 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 Eigenschaft snippet.thumbnails der channel-Ressource wurde aktualisiert. Sie enthält jetzt folgende Änderungen: Wenn Miniaturansichten in Ihrer Anwendung angezeigt werden, müssen im Code die Bild-URLs genauso verwendet werden, wie sie in API-Antworten zurückgegeben werden. Ihre Anwendung sollte beispielsweise in einer URL, die in einer API-Antwort zurückgegeben wird, nicht die Domain http anstelle der Domain https verwenden.

Ab Juli 2018 sind URLs für Kanal-Thumbnails nur noch in der Domain https verfügbar. So werden die URLs in API-Antworten angezeigt. Danach werden in deiner App möglicherweise fehlerhafte Bilder angezeigt, wenn versucht wird, YouTube-Bilder von der Domain http zu laden.
Hinweis: Dies ist eine Ankündigung zur Einstellung.

Die Property recordingDetails.location.altitude der Ressource video wird nicht mehr unterstützt. Es kann nicht garantiert werden, dass Videos Werte für diese Property zurückgeben. Ebenso ist es möglich, dass die eingehenden Daten nicht gespeichert werden, selbst wenn API-Anfragen versuchen, einen Wert für diese Eigenschaft festzulegen.

22. Juni 2018

Der Implementierungsleitfaden, zuvor als Implementierungs- und Migrationsleitfaden bezeichnet, wurde aktualisiert, um Anweisungen für die Migration von API V2 zur API V3 zu entfernen. Außerdem wurden Anleitungen für Funktionen entfernt, die mittlerweile in Version 3 der API eingestellt wurden, z. B. Favoriten.

27. November 2017

Dieses Update enthält die folgenden Änderungen:

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

YouTube entfernt die Unterstützung für die Funktionen Angesagtes Video und Angesagte 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 Attribute eingestellt.

Bis zum 14. Dezember 2017 können Sie noch invideoPromotion-Daten abrufen und festlegen. Nach diesem Datum gilt Folgendes:
- Wenn Sie beim Aufrufen von channels.list versuchen, den Teil invideoPromotion abzurufen, wird eine leere invideoPromotion oder gar keine invideoPromotion-Daten zurückgegeben.
- Versuche, invideoPromotion-Daten beim Aufrufen von channels.update zu aktualisieren, werden bis mindestens zum 27. Mai 2018 als erfolgreich zurückgegeben. Sie werden jedoch als No-Ops behandelt, d. h., es wird kein Update durchgeführt.
Nach dem 27. Mai 2018 können bei diesen Anfragen Fehlermeldungen zurückgegeben 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 zu sehen, z. B. für die Methode channels.list.

Die anpassbaren Beispiele sollen Ihnen einen nutzungsspezifischen 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 angezeigt werden:
- Die Funktion removeEmptyParameters nimmt eine Liste von Schlüssel/Wert-Paaren entgegen, die den Parametern der API-Anfrage entsprechen, und entfernt die Parameter ohne Werte.
- Die Funktion createResource erstellt eine Liste von Schlüssel/Wert-Paaren, die den Attributen in einer API-Ressource entsprechen. Anschließend werden die Properties in ein JSON-Objekt umgewandelt, 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 Samples können heruntergeladen und lokal ausgeführt werden. Weitere Informationen finden Sie in den Voraussetzungen zum lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.

25. Oktober 2017

Dieses Update enthält die folgenden Änderungen:

Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert. Statt der oauth2client-Bibliothek, die jetzt eingestellt wird, werden jetzt die google-auth- und google-auth-oauthlib-Bibliotheken verwendet.

Zusätzlich zu dieser Änderung bietet das Tool jetzt vollständige Codebeispiele für installierte Python-Anwendungen und Python-Webserveranwendungen, die etwas unterschiedliche Autorisierungsabläufe verwenden. So rufen Sie die vollständigen Samples (und diese Änderung) auf:
1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine beliebige API-Methode wie die channels.list-Methode auf.
2. Klicken Sie über den Codebeispielen auf den Tab Python.
3. Klicken Sie auf den Schalter über den Tabs, um zwischen einem Snippet und einem vollständigen Sample zu wechseln.
4. Auf dem Tab sollte jetzt ein vollständiges Codebeispiel mit dem InstalledAppFlow-Autorisierungsablauf angezeigt werden. 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-Webanwendungs-Framework und ein anderer Autorisierungsablauf verwendet.
Alle diese Beispiele sind für den Download und die lokale Ausführung vorgesehen. Wenn Sie die Beispiele ausführen möchten, folgen Sie der 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 festgelegt ist, muss der Parameter type auf video festgelegt sein.
Die Definition des Parameters regionCode der Methode search.list wurde aktualisiert, um zu verdeutlichen, dass die Suchergebnisse mit diesem Parameter auf Videos beschränkt werden, die sich in der angegebenen Region ansehen lassen.
YouTube hat seine Markenlogos und -symbole aktualisiert. Neue mit YouTube entwickelte Logos können auf der Seite mit den Branding-Richtlinien heruntergeladen werden. Auf dieser Seite findest du auch weitere neue YouTube-Logos und -Symbole, die du auf der YouTube-Markenwebsite herunterladen kannst.

24. Juli 2017

Dieses Update enthält die folgenden Änderungen:

Für iOS ist eine neue Kurzanleitung zur YouTube Data API verfügbar. In der Anleitung wird beschrieben, wie du die YouTube Data API in einer einfachen iOS-Anwendung verwendest, die in Objective-C oder Swift geschrieben wurde.
Das interaktive Code-Snippet-Tool für die YouTube Data API enthält jetzt eine Dokumentation, in der einige der Funktionen des Tools erläutert werden:
- API-Anfragen ausführen
- Zwischen Code-Snippets und vollständigen Codebeispielen wechseln
- Boilerplate-Funktionen verwenden
- Vorhandene Ressourcen laden (für Aktualisierungsmethoden)
Hinweis: Das Tool ist auch in der API-Referenzdokumentation für API-Methoden eingebettet (Beispiel).

1. Juni 2017

Dieses Update enthält die folgenden Änderungen:

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Die folgenden video-Ressourcenattribute werden nicht mehr unterstützt. Die Eigenschaften werden zwar noch bis zum 1. Dezember 2017 unterstützt, es gibt jedoch keine Garantie, dass Videos bis zu diesem Zeitpunkt weiterhin Werte für diese Eigenschaften zurückgeben. Ebenso generieren videos.insert- und videos.update-Anfragen, die diese Attributwerte festlegen, vor diesem Datum keine Fehler. Es ist jedoch möglich, dass die eingehenden Daten nicht gespeichert werden.

17. Mai 2017

Dieses Update enthält die folgenden Änderungen:

Die API-Referenzdokumentation wurde aktualisiert, um Code-Snippets vielseitiger und interaktiver zu machen. Seiten, auf denen API-Methoden wie channels.list oder videos.rate erklärt werden, enthalten jetzt ein interaktives Tool, mit dem Sie Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen können.

Für jede Methode zeigt das Tool Code-Snippets für einen oder mehrere Anwendungsfälle an. Jeder Anwendungsfall beschreibt eine gängige Methode zum Aufrufen dieser Methode. Du kannst 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:
- Ändern Sie Parameter- und Eigenschaftswerte. Die Code-Snippets werden dynamisch aktualisiert, um die von Ihnen angegebenen Werte widerzuspiegeln.
- 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 Samples können kopiert und über die Befehlszeile oder einen lokalen Webserver 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 ersetzt hat, auf denen es verfügbar ist. Auf jeder Seite wird ein Link angezeigt, über den Sie auch die Anfrage laden können, an der Sie gerade im APIs Explorer arbeiten.
Das Tool Code-Snippets für die Daten-API 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, bei denen Daten geschrieben werden.
- Unterstützung für Java-Beispiele
- Flexibler und umfassender Boilerplate-Code zum Autorisieren von Nutzern und zum Erstellen von API-Anfragen.

27. April 2017

Dieses Update enthält die folgenden Änderungen:

In den neuen Kurzanleitungen wird erklärt, wie du eine einfache Anwendung einrichtest, die YouTube Data API-Anfragen stellt. Aktuell sind Anleitungen für Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python und Ruby verfügbar.

30. März 2017

Dieses Update enthält die folgenden Änderungen:

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

27. Februar 2017

Wie bereits am 11. August 2016 angekündigt, hat YouTube die Liste der unterstützten Themen-IDs durch eine ausgewählte Liste ersetzt. Eine vollständige Liste der unterstützten Themen-IDs ist in den topicDetails-Properties für channel- und video-Ressourcen sowie im topicId-Parameter der search.list-Methode enthalten.

Es gibt jedoch einige Änderungen an der Liste der ausgewählten Elemente:

Die folgenden Themen wurden als Unterthemen zu Society hinzugefügt:

Name Themen-ID

Unternehmen /m/09s1f

Gesundheit /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.

Name	Themen-ID
Unternehmen	`/m/09s1f`
Gesundheit	`/m/0kt51`
Militär	`/m/01h6rj`
Politik	`/m/05qt0`
Religion	`/m/06bvp`

Aufgrund dieser Änderung werden Themen, die sich auf ein Video beziehen, jetzt immer im topicDetails.relevantTopicIds[]-Attributwert 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 Entertainment untergeordnet.
- Die Kategorie TV shows, die Entertainment untergeordnet ist, ist neu.
- Die Kategorie Health, die zuvor Lifestyle untergeordnet war, wurde entfernt.
Beachten Sie außerdem, 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 am 11. August 2016 angekündigt, erfordern die Einstellung von Freebase und der Freebase API mehrere Änderungen im Zusammenhang mit Themen-IDs. Mithilfe von Themen-IDs werden Themen identifiziert, die mit channel- und video-Ressourcen verknüpft sind. Du kannst auch den Suchparameter topicId verwenden, um Kanäle oder Videos zu einem bestimmten Thema zu finden.

Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Auswahl an Themen-IDs zurück, anstatt wie bisher eine viel detailliertere Auswahl. Außerdem ist nicht garantiert, dass Kanäle und Videos mit Themen verknüpft sind. Das entspricht dem aktuellen API-Verhalten.

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 ab diesem Zeitpunkt unterstützt werden. Die Liste der Kategorien ist für alle Unterkünfte identisch.
- Das Attribut topicDetails.topicIds[] der Ressource channel.
- Die topicDetails.relevantTopicIds[]-Property der video-Ressource.
- Der Parameter topicId der Methode search.list.
Hinweis: Dies ist eine Ankündigung zur Einstellung.

Die folgenden Attribute werden nicht mehr unterstützt:
- Die topicDetails.topicIds[]-Property der channel-Ressource. Diese Property wird bis zum 10. November 2017 unterstützt.
- Die topicDetails.relevantTopicIds[]-Property der video-Ressource. Diese Property wird bis zum 10. November 2017 unterstützt.
- Die topicDetails.topicIds[]-Property der video-Ressource. Diese Property enthält nach dem 10. Februar 2017 keine Werte mehr. Nach diesem Datum gibt der Eigenschaftswert topicDetails.relevantTopicIds[] alle Themen an, die mit einem Video verknüpft sind.
Da Freebase bereits eingestellt wurde, wurde der Leitfaden Mit Freebase-Themen suchen aus der Dokumentation entfernt. Dieser Leitfaden enthielt Codebeispiele, die zeigen, wie eine Anwendung mit der Freebase API funktioniert.

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

2. November 2016

Dieses Update enthält die folgenden Änderungen:

Neue Properties und Parameter
- Die Ressource video enthält mehrere neue Attribute:
  - Die player.embedHtml-Property enthält ein <iframe>-Tag, mit dem Sie einen Player einbetten können, der das Video abspielt. Die neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des eingebetteten Players an. Diese Eigenschaften werden nur zurückgegeben, wenn in der API-Anfrage ein Wert für mindestens einen der Parameter maxHeight oder maxWidth angegeben wird. Diese beiden neuen Parameter werden weiter unten in diesem Überarbeitungsverlaufseintrag erläutert.
  - Die neue hasCustomThumbnail-Eigenschaft gibt an, ob der Video-Uploader ein benutzerdefiniertes Thumbnail-Bild für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar.
  - Die neue fpbRatingReasons[] gibt die Gründe an, aus denen das Video die Altersfreigabe des FPB (Südafrika) erhalten hat.
  - Die neue mcstRating gibt die Altersfreigabe an, die das Video in Vietnam erhalten hat.
- Die videos.list-Methode unterstützt zwei neue Parameter: maxHeight und maxWidth. Sie können entweder einen oder beide Parameter verwenden, wenn Sie den player-Teil in video-Ressourcen abrufen.
  
  Standardmäßig beträgt die Höhe von <iframe>, die in der Eigenschaft player.embedHtml zurückgegeben wird, 360 px. Die Breite wird an das Seitenverhältnis des Videos angepasst. Dadurch wird sichergestellt, dass der eingebettete Player keine schwarzen Balken um das Video hat. Wenn das Seitenverhältnis eines Videos beispielsweise 16:9 ist, beträgt die Breite des Players 640 Pixel.
  
  Mit den neuen Parametern kannst du festlegen, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwendet, die dem Layout deiner Anwendung entspricht. Der API-Server skaliert die Playerabmessungen so, dass der eingebettete Player keine schwarzen Balken um das Video herum hat. Beachte, dass beide Parameter die maximalen Abmessungen des eingebetteten Players angeben. Wenn also beide Parameter angegeben sind, ist eine Dimension möglicherweise immer noch kleiner als der für diese Dimension zulässige Maximalwert.
  
  Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Wenn der maxHeight- oder maxWidth-Parameter nicht festgelegt ist, würde das player.embedHtml-Tag also einen 640-x-360-Player enthalten.
  - Wenn der Parameter maxHeight auf 720 und der Parameter maxWidth nicht festgelegt ist, gibt die API einen Player mit einer Auflösung von 1280 × 720 zurück.
  - Wenn der maxWidth-Parameter auf 960 und der maxHeight-Parameter nicht festgelegt ist, gibt die API einen 960-x-540-Player zurück.
  - Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight auf 450 festgelegt ist, gibt die API einen Player mit einer Auflösung von 800 × 450 Pixeln zurück.
  Die oben beschriebenen neuen Properties player.embedHeight und player.embedWidth geben die Abmessungen des Players an.
Aktualisierungen bestehender Methoden, Attribute und Parameter
- Die Ressourcenbeschreibung für channelSection wurde aktualisiert. Dort wird jetzt darauf hingewiesen, dass ein Kanal ohne Festlegen von Targeting-Daten maximal 10 Bereiche und mit Targeting-Daten maximal 100 Bereiche erstellen kann.
  
  Außerdem wurde das Attribut targeting der Ressource channelSection aktualisiert, um darauf hinzuweisen, dass Targeting-Optionen nur über die API festgelegt werden können. Die Ausrichtungsoptionen werden gelöscht, wenn der Kanalabschnitt über die Benutzeroberfläche auf der YouTube-Website geändert wird.
- Die Definition des Attributs snippet.name der Ressource i18nLanguage wurde korrigiert. Sie zeigt jetzt, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den Parameter hl der Methode i18nLanguage.list angegeben wird.
- Das Attribut contentDetails.note der Ressource „playlistItem“ wurde aktualisiert, um zu beachten, dass die maximale Länge des Attributwerts 280 Zeichen beträgt.
- 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, bei denen diese Methode verwendet wird, müssen außerdem mit einem Token autorisiert werden, das Zugriff auf den Bereich https://www.googleapis.com/auth/youtubepartner gewährt.
- Die Parameter publishedBefore und publishedAfter der Methode search.list wurden aktualisiert, um anzugeben, dass die Parameterwerte inkludierend sind. Wenn beispielsweise der Parameter publishedBefore festgelegt ist, gibt die API Ressourcen zurück, die vor oder um der angegebenen Zeit erstellt wurden.
- Das Attribut contentDetails.contentRating.grfilmRating der Ressource video unterstützt drei zusätzliche Werte: grfilmK12, grfilmK15 und grfilmK18.
- In der Beschreibung der videos.insert-Methode wurde aktualisiert, dass die maximale Dateigröße für hochgeladene Videos von 64 GB auf 128 GB erhöht wurde.

Neue und aktualisierte Fehler

Die API unterstützt die folgenden neuen Fehler:

Fehlertyp	Fehlerdetails	Beschreibung
`forbidden (403)`	`homeParameterDeprecated`	Die `activities.list`-Methode gibt diesen Fehler zurück, um anzugeben, dass die Daten zu den Aktivitäten auf der Startseite des Nutzers über diese API nicht verfügbar sind. Dieser Fehler kann auftreten, wenn Sie den `home`-Parameter in einer nicht autorisierten Anfrage auf `true` setzen.
`invalidValue (400)`	`invalidContentDetails`	Die `playlistItems.insert`-Methode gibt diesen Fehler zurück, um anzugeben, dass das `contentDetails`-Objekt in der Anfrage ungültig ist. Ein Grund für diesen Fehler ist, dass das Feld `contentDetails.note` länger als 280 Zeichen ist.
`forbidden (403)`	`watchHistoryNotAccessible`	Die `playlistItems.list`-Methode gibt diesen Fehler zurück, um anzugeben, dass bei der Anfrage versucht wurde, Playlist-Elemente aus dem Wiedergabeverlauf abzurufen, die aber nicht mit der API abgerufen werden können.
`forbidden (403)`	`watchLaterNotAccessible`	Die Methode `playlistItems.list` gibt diesen Fehler zurück, um anzuzeigen, dass die Anfrage versucht hat, Playlist-Elemente zur „Später ansehen“-Playlist abzurufen, diese können jedoch nicht mit der API abgerufen werden.
`badRequest (400)`	`uploadLimitExceeded`	Die Methode `videos.insert` gibt diesen Fehler zurück, um anzugeben, dass die Anzahl der Videos, die auf dem Kanal hochgeladen werden dürfen, überschritten wurde.
`forbidden (403)`	`forbiddenEmbedSetting`	Die Methode `videos.update` gibt diesen Fehler zurück, um anzugeben, dass bei der API-Anfrage versucht wird, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachte, dass einige Kanäle möglicherweise nicht berechtigt sind, 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 einer Playlist ein doppeltes Video hinzufügst. Dieser Fehler trat bisher bei einigen Playlists auf, z. B. bei den Lieblingsvideos, in denen keine Duplikate erlaubt waren, die aber nicht mehr unterstützt werden. Grundsätzlich sind in Playlists doppelte Videos zulässig.

Weitere Updates
- Der Eintrag im Änderungsverlauf vom 15. September 2016 wurde aktualisiert, um klarzustellen, dass die Eigenschaften contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel in einer Antwort immer die Werte HL und WL enthalten. Außerdem sind diese Properties nur enthalten, wenn ein autorisierter Nutzer Daten zu seinem eigenen Kanal abruft.

15. September 2016

Dieses Update enthält die folgenden Änderungen:

In der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 wurden verschiedene Änderungen an Themen-IDs vorgenommen, darunter die Tatsache, dass sich die unterstützten Themen-IDs ab dem 10. Februar 2017 ändern. Die Liste der unterstützten Themen wird am 10. November 2016 veröffentlicht.
Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden im Überarbeitungsverlauf am 11. August 2016 bekannt gegeben:
- Wenn die activities.list-Methode mit dem Parameter home auf true festgelegt aufgerufen wird, enthält die API-Antwort jetzt Elemente, die einem nicht angemeldeten YouTube-Nutzer auf der Startseite angezeigt würden.
  Mit dieser geringfügigen Änderung möchten wir die Nutzererfahrung verbessern als im Überarbeitungsverlauf vom 11. August 2016 beschrieben. In dieser Aktualisierung wurde angegeben, dass Anfragen mit dem Parameter home eine leere Liste zurückgeben.
- Die contentDetails.relatedPlaylists.watchHistory- und contentDetails.relatedPlaylists.watchLater-Attribute der channel-Ressource enthalten jetzt für alle Kanäle die Werte HL und WL.
  
  Diese Eigenschaften sind nur für autorisierte Nutzer sichtbar, die Daten über den eigenen Kanal abrufen. Die Properties enthalten immer die Werte HL und WL, auch wenn ein autorisierter Nutzer Daten zu seinem eigenen Kanal abruft. Daher können die IDs des Wiedergabeverlaufs und der Playlists „Später ansehen“ nicht über die API abgerufen werden.
  
  Außerdem geben Anfragen zum Abrufen von Playlist-Details (playlists.list) oder Playlist-Elementen (playlistItems.list) für den Wiedergabeverlauf oder die Playlist „Später ansehen“ eines Kanals jetzt leere Listen zurück. Dieses Verhalten gilt für die neuen Werte HL und WL sowie für alle IDs des Wiedergabeverlaufs oder der Playlist-IDs mit späterer Wiedergabe, die dein API-Client möglicherweise bereits gespeichert hat.
Das fileDetails.recordingLocation-Objekt der video-Ressource und seine untergeordneten Properties werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnete fileDetails-Objekt) nur vom Rechteinhaber eines Videos abgerufen werden.

11. August 2016

Dieses Update enthält die folgenden Änderungen:

Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („die aktualisierten Nutzungsbedingungen“) wurden im YouTube Engineering and Developers Blog ausführlich erläutert. Sie enthalten eine Reihe von Änderungen an den aktuellen Nutzungsbedingungen. Neben den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere ergänzende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

Die vollständigen neuen Dokumente sind im Versionsverlauf der aktualisierten Nutzungsbedingungen beschrieben. Außerdem werden in diesem Änderungsverlauf zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an den zugehörigen Dokumenten erläutert. Sie können über einen Link in dem Dokument einen RSS-Feed abonnieren, der Änderungen in diesem Überarbeitungsverlauf auflistet.
Die Einstellung von Freebase und der Freebase API führt zu mehreren Änderungen im Zusammenhang mit Themen-IDs. Themen-IDs werden in den folgenden API-Ressourcen und -Methoden verwendet:
- Der topicDetails-Teil der Ressource channel gibt Themen an, die mit dem Kanal verknüpft sind.
- Im topicDetails-Teil der video-Ressource werden die Themen angegeben, die mit dem Video verknüpft sind.
- Mit dem Parameter topicId der Methode search.list kannst du nach Videos oder Kanälen zu einem bestimmten Thema suchen.
Die Änderungen an diesen Funktionen sind:
- Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Auswahl an Themen-IDs zurück, anstatt wie bisher eine viel detailliertere Auswahl. Diese Gruppe unterstützter Themen identifiziert übergeordnete Kategorisierungen wie Sport oder Basketball, aber beispielsweise keine spezifischen Teams oder Spieler. Wir werden die unterstützten Themen ankündigen, damit du genug Zeit hast, deine App 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 Auswahl an Themen verwenden, die im vorherigen Element ermittelt wurden, um Suchergebnisse nach Thema abzurufen.
- Wenn Sie nach dem 10. Februar 2017 versuchen, mithilfe einer Themen-ID nach Ergebnissen zu suchen, die nicht in der kleineren Anzahl unterstützter Themen-IDs enthalten ist, gibt die API einen leeren Ergebnissatz zurück.
Mehrere API-Felder und Parameter werden ab dem 12. September 2016 eingestellt:
- Mit dem Parameter home der Methode activities.list kann ein autorisierter Nutzer den Aktivitätsfeed abrufen, der für diesen Nutzer auf der YouTube-Startseite angezeigt werden soll. Nach dem 12. September 2016 wird bei Anfragen mit diesem Parameter eine leere Liste zurückgegeben.
- Die Properties contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der channel-Ressource sind nur für autorisierte Nutzer sichtbar, die Daten zu ihrem eigenen Kanal abrufen. Nach dem 12. September 2016 gibt contentDetails.relatedPlaylists.watchHistory für alle Channels den Wert HL und die Property contentDetails.relatedPlaylists.watchLater den Wert WL zurück.
  
  Anfragen zum Abrufen von Playlistdetails (playlists.list) für den Wiedergabeverlauf oder die „Später ansehen“-Playlist eines Kanals werden nach dem 12. September 2016 mit einer leeren Liste beantwortet. Bei Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list) in einer dieser Playlists wird nach diesem Zeitraum ebenfalls eine leere Liste zurückgegeben. Das gilt für die neuen Werte HL und WL sowie für alle Wiedergabeverläufe oder Playlist-IDs für „Später ansehen“, die dein API-Client möglicherweise bereits gespeichert hat.
- Das fileDetails.recordingLocation-Objekt der video-Ressource oder eine seiner untergeordneten Properties werden 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:

Die Property contentDetails.googlePlusUserId der Ressource channel wird nicht mehr unterstützt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+-Profil verknüpft war. Nach der Einstellung ist das Attribut nicht mehr in channel-Ressourcen enthalten.
Das Attribut snippet.authorGoogleplusProfileUrl der Ressource comment wurde verworfen. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+-Profil verknüpft war. Nach der Einstellung ist das Attribut nicht mehr in comment-Ressourcen enthalten.

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

31. Mai 2016

Dieses Update enthält die folgenden Änderungen:

Mit dem neuen Parameter myRecentSubscribers der Methode subscriptions.list kannst du eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge abrufen, d. h. nach dem Datum, an dem sie den Kanal abonniert haben.

Beachte, dass der neue Parameter nur den Abruf der letzten 1.000 Abonnenten des Kanals des authentifizierten Nutzers unterstützt. Mit dem Parameter mySubscribers kannst du eine vollständige Liste der Abonnenten abrufen. Dieser Parameter, mit dem Abonnenten nicht in einer bestimmten Reihenfolge zurückgegeben werden, schränkt die Anzahl der abrufbaren Abonnenten nicht ein.
Die Definition der Eigenschaft snippet.thumbnails.(key) wurde für die Ressourcen activity, playlistItem, playlist, Suchergebnis, thumbnail und video aktualisiert, um zu beachten, dass für einige Videos zusätzliche Bildgrößen für Miniaturansichten verfügbar sind.
- Das Bild standard ist 640 Pixel breit und 480 Pixel hoch.
- Das maxres-Bild ist 1.280 Pixel breit und 720 Pixel hoch.
Die Definition des part-Parameters der channelSection.list-Methode wurde aktualisiert, um zu verdeutlichen, dass der targeting-Teil zu einem Preis von 2 Kontingenteinheiten abgerufen werden kann.
Die Methode videos.list gibt jetzt einen verbotenen Fehler (403) zurück, wenn eine nicht ordnungsgemäß autorisierte Anfrage versucht, die Teile fileDetails, processingDetails oder suggestions einer Ressource vom Typ video abzurufen. Diese Teile sind nur für den Inhaber des Videos verfügbar.

17. Mai 2016

Das neue Tool Data API-Code-Snippets bietet kurze Code-Snippets für gängige 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.

Für jede Methode zeigt das Tool Codebeispiele für einen oder mehrere Anwendungsfälle an. So enthält er beispielsweise fünf Code-Snippets für die Methode search.list:

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

Für jeden Anwendungsfall werden die in der API-Anfrage verwendeten Parameter angezeigt. Sie können die Parameterwerte ändern. In diesem Fall aktualisiert das Tool die Code-Snippets entsprechend den von Ihnen 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 Ihren angegebenen Parameterwerten. Sie müssen das Tool autorisieren, Anfragen in Ihrem Namen zu senden, damit API-Antworten angezeigt werden.

28. April 2016

Dieses Update enthält die folgenden Änderungen:

Das neue Attribut contentDetails.projection der Ressource video gibt das Projektionsformat des Videos an. Gültige Attributwerte sind 360 und rectangular.
Die Properties recordingDetails.location und fileDetails.recordingLocation der video-Ressource wurden aktualisiert, um den Unterschied zwischen den beiden Properties zu erklären:
- Die Property recordingDetails.location gibt den Ort an, den der Rechteinhaber mit dem Video verknüpfen möchte. Dieser Speicherort kann in öffentlichen Videos bearbeitet werden, kann dort gesucht werden und kann Nutzern auch bei öffentlichen Videos angezeigt werden.
- Der fileDetails.recordingLocation-Eigenschaftswert ist unveränderlich und steht für den Speicherort, der der hochgeladenen Originalvideodatei zugeordnet ist. Der Wert ist nur für den Videoinhaber sichtbar.
Die Definition des Attributs contentDetails.relatedPlaylists.favorites der Ressource channel wurde aktualisiert, um zu beachten, dass der Attributwert möglicherweise eine Playlist-ID enthält, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Favoriten“ bereits eingestellt wurde. Hinweis: Diese Property unterliegt nicht der Richtlinie zur Einstellung von APIs.
Die Definition des Fehlers ineligibleAccount, der von der Methode comments.insert, comments.update, commentThreads.insert oder commentThreads.update zurückgegeben werden kann, wurde aktualisiert, um anzugeben, dass der Fehler auftritt, wenn das zum Autorisieren 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 Parameters part der Methode channels.update wurde aktualisiert, um zu verdeutlichen, dass localizations auch ein gültiger Wert für diesen Parameter ist.
Der Abschnitt Kontingentnutzung im Startleitfaden wurde aktualisiert und enthält nun einen Link zur Google Developers Console, in der Sie Ihre tatsächliche Kontingent- und Kontingentnutzung sehen können.

16. März 2016

Dieses Update enthält die folgenden Änderungen:

Aktualisierungen vorhandener Ressourcen und Methoden
- Die channelBanner-Ressourcendokumentation wurde aktualisiert. Die empfohlene Größe für das hochgeladene Kanalbannerbild ist 2.560 × 1.440 Pixel. Die Mindestgröße (2.048 × 1.152 Pixel) hat sich nicht geändert.
- Die neue Property snippet.customUrl der channel-Ressource gibt die benutzerdefinierte URL an, die mit dem Kanal verknüpft ist. Nicht alle Channels haben benutzerdefinierte URLs. In der YouTube-Hilfe erfährst du, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten, und wie du sie einrichtest.
- Das brandingSettings.watch-Objekt der Ressource channel und alle untergeordneten Attribute wurden eingestellt.
- Die API-Antwort auf eine search.list-Anfrage enthält jetzt das Attribut regionCode. Die Property gibt den Regionscode an, der für die Suchanfrage verwendet wurde. Der Regionscode weist die API an, Suchergebnisse für das angegebene Land zurückzugeben.
  Der Property-Wert 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, wählt YouTube möglicherweise trotzdem eine andere Region anstelle des Standardwerts für die Abfrage aus.
- Die Definitionen der Attribute snippet.label und snippet.secondaryReasons[].label der Ressource videoAbuseReportReason wurden aktualisiert. Sie enthalten nun lokalisierten Labeltext für die Gründe des Missbrauchsberichts.
  
  Außerdem unterstützt die videoAbuseReportReasons.list-Methode jetzt den Parameter hl, mit dem die Sprache angegeben wird, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardparameterwert ist en_US.
- Die neue Property contentDetails.contentRating.ecbmctRating der video-Ressource gibt die Altersfreigabe eines Videos durch die türkische Kommission für Bewertung und Klassifizierung des Ministeriums für Kultur und Tourismus an.
  
  Darüber hinaus unterstützen API-Properties für andere Altersfreigabesysteme die folgenden neuen Property-Werte:
  - contentDetails.contentRating.fpbRating (Südafrika)
    Bewertung: 10; Property-Wert: fpb10
  - contentDetails.contentRating.moctwRating (Taiwan)
    Altersfreigabe: R-12; Property-Wert: moctwR12
  - contentDetails.contentRating.moctwRating (Taiwan)
    Altersfreigabe: R-15; Property-Wert: moctwR15
- Das Attribut liveStreamingDetails.activeLiveChatId der Ressource video enthält die ID des aktiven Livechats, der mit dem Video verknüpft ist. Der Eigenschaftswert ist nur vorhanden, wenn das Video eine aktuelle Liveübertragung mit aktiviertem Livechat ist. Nach dem Ende der Übertragung und des Livechats wird die Property für das Video nicht mehr zurückgegeben.
- Die Property status.rejectionReason der Ressource video unterstützt den neuen Property-Wert 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 Kanalbereich 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 für die in der API-Anfrage eingereichte `channelSection`-Ressource ein Wert für die Property `snippet.style` angegeben werden muss.
`badRequest (400)`	`typeRequired`	Die Methoden `channelSections.insert` und `channelSections.update` geben diesen Fehler zurück, um anzugeben, dass für die in der API-Anfrage eingereichte `channelSection`-Ressource ein Wert für die Property `snippet.type` angegeben werden muss.
`badRequest (400)`	`processingFailure`	Die Methode `commentThreads.list` gibt diesen Fehler zurück, um anzugeben, dass der API-Server die Anfrage nicht verarbeiten konnte. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch in der Regel darauf hin, dass die Anfrageeingabe ungültig ist. Prüfen Sie die Struktur der `commentThread`-Ressource 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 sind.
`badRequest (400)`	`commentTextTooLong`	Die Methode `commentThreads.insert` gibt diesen Fehler zurück, um anzugeben, dass die eingefügte `comment`-Ressource in der `snippet.topLevelComment.snippet.textOriginal`-Eigenschaft zu viele Zeichen enthält.
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	Die Methode `playlistItems.insert` gibt diesen Fehler zurück, um anzugeben, dass sich das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serien-Playlist befindet. Weitere Informationen zu Serien-Playlists findest du in der YouTube-Hilfe.
`badRequest (400)`	`subscriptionForbidden`	Die Methode `subscriptions.insert` gibt diesen Fehler zurück, wenn die maximale Anzahl von Abos erreicht ist oder du in letzter Zeit zu viele Abos erstellt hast. Im letzteren 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 `video`-Ressource 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 `video`-Ressource 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 `video`-Ressource einen ungültigen Zeitpunkt für die geplante Veröffentlichung angibt.
`badRequest (400)`	`invalidRecordingDetails`	Die `videos.update`-Methode gibt diesen Fehler zurück, um anzugeben, dass für das `recordingDetails`-Objekt in der hochgeladenen `video`-Ressource ungültige Aufnahmedetails angegeben wurden.
`badRequest (400)`	`invalidTags`	Die Methode `videos.update` gibt diesen Fehler zurück, um anzugeben, dass für die Property `snippet.tags` in der hochgeladenen `video`-Ressource ein ungültiger Wert angegeben wurde.
`badRequest (400)`	`invalidTitle`	Die Methode `videos.update` gibt diesen Fehler zurück, um anzugeben, dass die Property `snippet.title` in der hochgeladenen `video`-Ressource einen ungültigen oder leeren Videotitel angegeben hat.
`badRequest (400)`	`invalidVideoMetadata`	Die `videos.update`-Methode gibt diesen Fehler zurück, um anzugeben, dass die Anfragemetadaten ungültig sind. Dieser Fehler tritt auf, wenn mit der Anfrage der `snippet`-Teil einer `video`-Ressource aktualisiert wird, aber weder für die `snippet.title`- noch für die `snippet.categoryId`-Eigenschaft ein Wert festgelegt wird.

18. Dezember 2015

Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzer in der EU bestimmte Informationen erhalten und ihre Einwilligung erteilt haben. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben in unseren Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung aufgenommen.

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, das Attribut snippet.title der Ressource channelSection und das Attribut 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. So legen Sie lokalisierte Werte für eine Ressource fest:
- Achten Sie darauf, dass für das Attribut snippet.defaultLanguage der Ressource ein Wert festgelegt ist. Dieses Attribut gibt die Sprache der Attribute snippet.title und snippet.description der Ressource an. Der Wert kann eine unterstützte Anwendungssprache oder die meisten anderen ISO 639-1:2002-Sprachcodes sein. Wenn du beispielsweise ein Video mit einem englischen Titel und einer englischen Beschreibung hochlädst, würdest du die snippet.defaultLanguage-Eigenschaft auf en setzen.
  
  Hinweis zum Aktualisieren von channel-Ressourcen: Wenn Sie die snippet.defaultLanguage-Eigenschaft für eine channel-Ressource festlegen möchten, müssen Sie die brandingSettings.channel.defaultLanguage-Eigenschaft aktualisieren.
- Fügen Sie der Ressource, die Sie aktualisieren möchten, das localizations-Objekt hinzu. Jeder Objektschlüssel ist eine Zeichenfolge, die eine Anwendungssprache oder einen ISO 639-1:2002-Sprachcode angibt. Jeder Schlüssel ist einem Objekt zugeordnet, das den lokalisierten Titel (und die Beschreibung) für die Ressource enthält.
  
  Im folgenden Beispiel wird die Standardsprache der Ressource auf Englisch festgelegt. Außerdem werden einem 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",
    }
  }
}
```
Lokalisierte Werte abrufen

Die API unterstützt zwei Möglichkeiten zum Abrufen lokalisierter Werte für eine Ressource:
- Fügen Sie der channels.list-, channelSections.list-, playlists.list- oder videos.list-Anfrage den Parameter hl hinzu, um lokalisierte Daten für eine bestimmte Anwendungssprache 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 wird, enthält die Ressource die folgenden Daten:
```
{
  "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"
    }
    ...
  }
}
```
  Wurde 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 zur Identifizierung von Anwendungssprachen, die von der YouTube-Website unterstützt werden. Wenn Sie wissen möchten, ob lokalisierter Text für andere Sprachen verfügbar ist, müssen Sie den Teil localizations der Ressource abrufen und filtern, um festzustellen, ob der lokalisierte Text vorhanden ist.
  
  Wenn Sie beispielsweise wissen möchten, ob lokalisierter Text auf Appalachian English verfügbar ist, müssen Sie die vollständige Liste der Lokalisierungen abrufen.
- 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 keine aktuelle Sprache für die YouTube-Anwendung ist, musst du auf diese Weise alle Lokalisierungen abrufen und dann mithilfe von Filtern ermitteln, 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, die versucht, das `localizations`-Objekt 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:

Aktualisierungen vorhandener Ressourcen und Methoden
- Der Parameter order der Methode search.list wurde aktualisiert. Wenn du Livestreams nach viewCount sortierst, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer sortiert, während die Livestreams noch laufen.
- Der Parameter relatedToVideoId der Methode search.list wurde aktualisiert. Wenn der Parameter festgelegt ist, werden nur part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (muss auf video gesetzt sein) und fields unterstützt. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.
- Die Definition der Property snippet.publishedAt der Ressource video wurde aktualisiert. Der Property-Wert, der das Datum und die Uhrzeit der Veröffentlichung des Videos angibt, kann sich jetzt von der Zeit unterscheiden, zu der das Video hochgeladen wurde. Wenn beispielsweise ein Video als privates Video hochgeladen und später veröffentlicht wird, gibt der Eigenschaftswert den Zeitpunkt an, zu dem das Video veröffentlicht wurde. In der aktualisierten Definition wird auch erläutert, wie der Wert für private und nicht gelistete Videos ermittelt wird.
  
  Diese Änderung entspricht nicht einem veränderten API-Verhalten.
- Die Definition des Attributs status.publishAt der Ressource video wurde aktualisiert, um Folgendes zu beachten:
  - Wenn du den Wert dieser Property beim Aufrufen der videos.update-Methode festlegst, musst du auch den Wert der Property status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
  - Wenn die Veröffentlichung eines Videos durch die Anfrage zu einem früheren Zeitpunkt geplant wird, wird es sofort veröffentlicht. Wenn du also für die Property „status.publishAt“ ein Datum und eine Uhrzeit in der Vergangenheit festlegst, hat das denselben Effekt wie eine Änderung des privacyStatus-Werts des Videos von private zu public.
- Die Eigenschaft contentDetails.contentRating.cncRating der video-Ressource gibt die Einstufung des Videos gemäß der französischen Kommission zur Klassifikation der Kinotografie an. Dieses Attribut ersetzt das Attribut contentDetails.contentRating.fmocRating, das eingestellt wird.
- Die Definition für brandingSettings.channel.keywords der Ressource channel wurde aktualisiert, damit klar wird, dass der Attributwert wie zuvor dokumentiert eine durch Leerzeichen getrennte Liste von Strings und keine durch Kommas getrennte Liste enthält. Diese Aktualisierung hat keine Auswirkungen auf die API-Funktionsweise.
- Die Dokumentation für die thumbnails.set-Methode wurde aktualisiert, um korrekt zu verdeutlichen, dass der Anfragetext das Thumbnail-Bild enthält, das du hochlädst und mit einem Video verknüpfst. Der Anfragetext enthält keine thumbnail-Ressource. Zuvor wurde in der Dokumentation angegeben, dass Sie beim Aufrufen dieser Methode keinen Anfragetext angeben sollten. Diese Aktualisierung hat keine Auswirkungen auf die API-Funktionsweise.
- Die Beschreibung der Ressource activity wurde aktualisiert, um zu verdeutlichen, dass die activities.list-Methode derzeit keine Ressourcen zu neuen Videokommentaren enthält. Auch snippet.type und contentDetails.comment der Ressource wurden aktualisiert.

Neue und aktualisierte Fehler

Die API unterstützt jetzt die folgenden Fehler:

Fehlerdetails

activities.insert

HTTP-Antwortcode	`badRequest (400)`
Grund	`invalidMetadata`
Beschreibung	Die Eigenschaft `kind` entspricht nicht dem angegebenen ID-Typ.

commentThreads.update
comments.insert
comments.update

HTTP-Antwortcode	`badRequest (400)`
Grund	`commentTextTooLong`
Beschreibung	Die `comment`-Ressource, die eingefügt oder aktualisiert wird, enthält in der Property `snippet.topLevelComment.snippet.textOriginal` zu viele Zeichen.

playlistItems.insert
playlistItems.update

HTTP-Antwortcode	`forbidden (403)`
Grund	`playlistItemsNotAccessible`
Beschreibung	Die Anfrage ist nicht ordnungsgemäß zum Einfügen, Aktualisieren oder Löschen des angegebenen Playlist-Elements autorisiert.

playlists.delete
playlists.insert
playlists.update

HTTP-Antwortcode	`badRequest (400)`
Grund	`playlistForbidden`
Beschreibung	Dieser Vorgang ist verboten oder die Anfrage ist nicht korrekt autorisiert.

search.list

HTTP-Antwortcode	`badRequest (400)`
Grund	`invalidLocation`
Beschreibung	Der Wert des Parameters `location` und/oder `locationRadius` wurde falsch formatiert.

search.list

HTTP-Antwortcode	`badRequest (400)`
Grund	`invalidRelevanceLanguage`
Beschreibung	Der Wert des Parameters `relevanceLanguage` ist falsch formatiert.

subscriptions.insert

HTTP-Antwortcode	`badRequest (400)`
Grund	`subscriptionForbidden`
Beschreibung	Dieser Fehler tritt in folgenden Fällen auf: Das Abo, das Sie erstellen möchten, ist bereits vorhanden Sie haben die maximale Anzahl von Abos bereits erreicht Du versuchst, deinen eigenen Kanal zu abonnieren. Das ist nicht möglich. 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-Antwortcode	`badRequest (400)`
Grund	`invalidDefaultBroadcastPrivacySetting`
Beschreibung	Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für den Standard-Broadcast festzulegen.

28. August 2015

Dieses Update enthält die folgenden Änderungen:

Aktualisierungen vorhandener Ressourcen und Methoden
- Das Attribut statistics.favoriteCount der Ressource video wurde verworfen.
  
  Gemäß unserer Einstellungsrichtlinie ist diese Property noch mindestens ein Jahr nach dieser Ankündigung in den video-Ressourcen enthalten. Der Attributwert ist jetzt jedoch immer auf 0 festgelegt.

7. August 2015

Dieses Update enthält die folgenden Änderungen:

Updates für vorhandene Ressourcen und Methoden
- Die Definition des Attributs snippet.tags[] der Ressource video wurde aktualisiert, um weitere Informationen dazu bereitzustellen, wie der API-Server die Länge des Attributwerts berechnet. Beachten Sie, dass diese Aktualisierung keine Änderung des Verhaltens der API widerspiegelt.
  
  Insbesondere wird jetzt erläutert, dass der API-Server den Tag-Wert behandelt, als wäre er in Anführungszeichen gesetzt, wenn ein Tag einen Leerraum enthält. Die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Zum Zweck der Zeichenbeschränkung enthält das Tag Foo-Baz also sieben Zeichen, während das Tag Foo Baz neun Zeichen enthält.
- Die Methode commentThreads.insert unterstützt den Parameter shareOnGooglePlus nicht mehr. Dieser Parameter gab zuvor an, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+-Profil des Autors gepostet werden sollten. Wird der Parameter von einer Anfrage gesendet, ignoriert der API-Server den Parameter, verarbeitet die Anfrage aber ansonsten.

18. Juni 2015

Dieses Update enthält die folgenden Änderungen:

Updates für vorhandene Ressourcen und Methoden
- Der neue Parameter order der Methode commentThreads.list gibt die Reihenfolge an, in der Kommentarthreads in der API-Antwort aufgeführt werden sollen. Threads können nach Zeit oder Relevanz geordnet werden. Standardmäßig werden sie nach Zeit sortiert.
- Die neue Eigenschaft snippet.defaultAudioLanguage der Ressource video gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird.
- Die Definition des Attributs contentDetails.licensedContent der Ressource video wurde aktualisiert. Es wird jetzt klargestellt, dass die Inhalte ursprünglich auf einen Kanal hochgeladen werden müssen, der mit einem YouTube-Contentpartner verknüpft ist, und dass dann von diesem Partner ein Anspruch darauf erhoben werden muss. Das tatsächliche API-Verhalten ändert sich dadurch nicht.
- 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 ebenfalls 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-Antwortcode	`badRequest (400)`
Grund	`emailNotVerified`
Beschreibung	Der Nutzer muss seine E-Mail-Adresse bestätigen, bevor er das Video bewerten kann.

videos.rate

HTTP-Antwortcode	`badRequest (400)`
Grund	`videoPurchaseRequired`
Beschreibung	Videos, die du dir ausgeliehen hast, können nur von dir bewertet werden.

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 gemeldet werden können.
- Mit der neuen videos.reportAbuse-Methode kannst du Videos melden, die missbräuchliche Inhalte enthalten. Der Text der Anfrage enthält ein JSON-Objekt, das das gemeldete Video sowie den Grund für missbräuchliche Inhalte angibt. Zulässige Gründe können über die oben beschriebene videoAbuseReportReason.list-Methode abgerufen werden.
  
  Der Leitfaden zur Migration wurde ebenfalls um ein Beispiel für die Meldung eines missbräuchlichen Videos ergänzt. Durch diese Änderung unterstützt die V3-API jetzt alle Funktionen der V2-API, die sie unterstützen soll. Diese Funktionen werden auch im Migrationsleitfaden erläutert.
Updates für vorhandene Ressourcen und Methoden
- Mit dem neuen Filterparameter forDeveloper der Methode search.list wird die Suche auf Videos beschränkt, die über die App 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 Anwendung des Entwicklers in der Google Developers Console zugewiesen ist.
  
  Wenn in einer Suchanfrage der Parameter forDeveloper anschließend auf true gesetzt wird, verwendet der API-Server die Autorisierungsdaten der Anfrage, um den Entwickler zu identifizieren. Daher kann ein Entwickler die Ergebnisse auf Videos beschränken, die über die eigene App oder Website des Entwicklers hochgeladen wurden, aber nicht auf Videos, die über andere Apps oder Websites hochgeladen wurden.
  
  Die neue Funktion bietet ähnliche, wenn auch nicht identische Funktionen für Entwickler-Tags, die von Version 2 der API unterstützt wurden.
- Mit der neuen Property snippet.country 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 tatsächlich das Attribut brandingSettings.channel.country aktualisieren.
- Die API unterstützt jetzt das Targeting für channelSection-Ressourcen. Mit Kanalabschnitts-Targeting können Sie die Sichtbarkeit eines Inhaltsbereichs auf Nutzer beschränken, die bestimmte Kriterien erfüllen.
  
  Die API bietet drei Targeting-Optionen. Ein Nutzer muss alle Targeting-Einstellungen erfüllen, damit ein Kanalbereich sichtbar ist.
  - targeting.languages[]: Eine Liste der Sprachen für die YouTube-Bewerbung. Nutzer, die eine dieser Sprachen ausgewählt haben, sehen den entsprechenden Kanalbereich.
  - targeting.regions[]: Eine Liste der Regionen mit bevorzugten Inhalten auf YouTube. Der Kanalabschnitt ist für Nutzer sichtbar, die eine dieser Regionen ausgewählt haben sowie für Nutzer, für die eine dieser Regionen automatisch ausgewählt wird.
  - targeting.countries[]: Eine Liste der Länder, in denen der Kanalbereich sichtbar ist. Jeder Wert in der Liste ist ein ISO 3166-1 Alpha-2-Ländercode.
- Die Definition des Attributs contentDetails.duration der Ressource video wurde korrigiert, um zu verdeutlichen, dass der Wert Stunden, Tage usw. umfassen kann.
- Die Dokumentation für die Methoden channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete und videos.delete wurde so korrigiert, dass sie alle den HTTP-Antwortcode 204 (No Content) zurückgeben, wenn der Vorgang erfolgreich war.

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 `channelSection`-Ressource einen ungültigen Wert für das Attribut `targeting.countries[]` enthält.
`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[]` enthält.
`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[]` enthält.
`badRequest (400)`	`operationNotSupported`	Die `comments.insert`-Methode gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den Kommentar auf oberster Ebene einfügen kann, der durch das `snippet.parentId`-Attribut angegeben ist. In einer `commentThread`-Ressource gibt das Attribut `snippet.canReply` an, ob der aktuelle Betrachter auf den Thread antworten kann.
`badRequest (400)`	`invalidChannelId`	Die `search.list`-Methode gibt diesen Fehler zurück, wenn im Parameter `channelId` in der Anfrage eine ungültige Kanal-ID angegeben wurde.
`badRequest (400)`	`subscriptionForbidden`	Die `subscriptions.insert`-Methode gibt diesen Fehler zurück, wenn der API-Nutzer versucht, seinen 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:

Der Migrationsleitfaden wurde aktualisiert. Darin wird jetzt erklärt, wie Anwendungen migriert werden, die noch die Kommentarfunktion der v2 API verwenden.

In diesem Leitfaden werden auch verschiedene Kommentarfunktionen aufgeführt, die von der API v2 nicht unterstützt wurden, aber in der API v3 unterstützt werden. Dazu gehören:
- Kommentare zu einem Kanal abrufen
- Alle Kommentarthreads abrufen, die sich auf einen Kanal beziehen, 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 Push-Benachrichtigungen abonnieren wurde aktualisiert, da Benachrichtigungen nicht wie zuvor angegeben auch an den Superfeedr-Hub gesendet werden, sondern nur an den Google PubSubHubBub-Hub.

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-Kommentar-Thread, der einen Kommentar auf oberster Ebene und ggf. Antworten auf diesen Kommentar enthält. Eine commentThread-Ressource kann Kommentare zu einem Video oder zu einem Kanal enthalten.
  
  Der Kommentar auf oberster Ebene und die Antworten sind tatsächlich comment-Ressourcen, die in der commentThread-Ressource verschachtelt sind. Die commentThread-Ressource enthält nicht unbedingt alle Antworten auf einen Kommentar. Wenn du alle Antworten für einen bestimmten Kommentar abrufen möchtest, musst du die Methode comments.list verwenden. Außerdem gibt es für einige Kommentare keine Antworten.
  
  Die API unterstützt die folgenden Methoden für commentThread-Ressourcen:
  - commentThreads.list – Ruft eine Liste von Kommentarthreads ab. Mit dieser Methode kannst du Kommentare abrufen, die mit einem bestimmten Video oder Kanal verknüpft sind.
  - commentThreads.insert – Erstellen Sie einen neuen Kommentar auf oberster Ebene. (Verwenden Sie die Methode comments.insert, um auf einen vorhandenen Kommentar zu antworten.)
  - commentThreads.update: Kommentar auf oberster Ebene bearbeiten.
- Eine comment-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment-Ressource kann einen Kommentar zu einem Video oder zu einem Kanal darstellen. Außerdem kann es sich um einen Kommentar auf oberster Ebene oder um eine Antwort auf einen Kommentar auf oberster Ebene handeln.
  
  Die API unterstützt die folgenden Methoden für comment-Ressourcen:
  - comments.list: Ruft eine Kommentarliste ab. Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.
  - comments.insert: Eine Antwort auf einen vorhandenen Kommentar erstellen.
  - comments.update: Kommentar ändern
  - comments.markAsSpam: Hiermit kannst du einen oder mehrere Kommentare als Spam melden.
  - comments.setModerationStatus: Hiermit kannst du den Moderationsstatus eines oder mehrerer Kommentare festlegen. Sie können beispielsweise einen Kommentar für die öffentliche Anzeige freigeben oder einen Kommentar als ungeeignet für die Anzeige ablehnen. Die API-Anfrage muss vom Inhaber des Kanals oder des Videos autorisiert werden, mit dem die Kommentare verknüpft sind.
  - comments.delete: Löscht einen Kommentar.
Beachten Sie, dass der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API, der im Überarbeitungsverlauf am 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 die neue Unterstützung der API für Push-Benachrichtigungen über PubSubHubBub erläutert, ein Server-zu-Server-Publish/Subscribe-Protokoll für über das Web zugängliche Ressourcen. Ihr PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen empfangen, wenn ein Kanal eine der folgenden Aktivitäten ausführt:
- ein Video hochlädt
- den Titel eines Videos aktualisiert
- 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 Push-Benachrichtigungstypen unterstützt hat, die in der API V3 nicht unterstützt werden, ist die Erwähnung der PubSubHubBub-Unterstützung weiterhin im Abschnitt Verworfen dieses Leitfadens aufgeführt.
Der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API ist jetzt ein gültiger Bereich für jede API-Methode, die zuvor den Bereich https://www.googleapis.com/auth/youtube 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` enthält.

Die Methode subscriptions.insert unterstützt den Fehler subscriptionLimitExceeded nicht mehr, der zuvor angegeben hatte, dass der mit der Anfrage identifizierte Abonnent die Ratenbegrenzung für Abos überschritten hat.

2. April 2015

Dieses Update enthält die folgenden Änderungen:

Die neue Ressource captions steht für einen YouTube-Untertiteltrack. Ein Untertiteltrack ist genau einem YouTube-Video zugeordnet.

Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren, Herunterladen und Löschen von Untertiteltracks.
Die Migrationsanleitung wurde ebenfalls aktualisiert. Dort wird jetzt beschrieben, wie Anwendungen migriert werden, in denen noch die Untertitelfunktion der v2 API verwendet wird.
Der neue https://www.googleapis.com/auth/youtube.force-ssl-Umfang der API erfordert, dass die Kommunikation mit dem API-Server über eine SSL-Verbindung erfolgt.

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

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

11. März 2015

Dieses Update enthält die folgenden Änderungen:

Der Migrationsleitfaden für die YouTube Data API (Version 3) enthält einen neuen Tab namens Neu in der Version 3 der API. Dort sind Funktionen aufgeführt, die von der Version 3 der API unterstützt werden, von der Version 2 aber nicht. Dieselben Funktionen waren zuvor und sind weiterhin auf anderen Tabs im Leitfaden aufgeführt. Die neue Funktion zum Aktualisieren der In-Video-Kampagnendaten eines Kanals ist beispielsweise auch auf dem Tab Kanäle (Profile) aufgeführt.
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde mit dem Hinweis aktualisiert, dass Version 3 der API die folgende API-Funktion der Version 2 unterstützt:
- Videos melden
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde mit dem Hinweis aktualisiert, dass die folgenden Funktionen der API v2 in der API v3 nicht unterstützt werden:
- Videoempfehlungen abrufen: Version 3 der API ruft keine Liste ab, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Mit der V3 API kannst du jedoch empfohlene Videos finden, indem du die Methode activities.list aufrufst und den Parameterwert home auf true festlegst.
  
  In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der Property snippet.type recommendation ist. In diesem Fall enthalten die Properties contentDetails.recommendation.reason und contentDetails.recommendation.seedResourceId Informationen darüber, warum das Video empfohlen wurde. Es gibt jedoch keine Garantie dafür, dass die Antwort eine bestimmte Anzahl von empfohlenen Videos enthält.
- Kanalvorschläge abrufen
- Neue Abovideos abrufen: Die V3 API ruft keine Liste ab, die nur Videos enthält, die vor Kurzem auf Kanäle hochgeladen wurden, die der API-Nutzer abonniert. Du kannst jedoch Version 3 der API verwenden, um neue Abovideos zu finden, indem du die Methode activities.list aufrufst und den Parameterwert home auf true setzt.
  
  In der API-Antwort entspricht eine Ressource einem neuen Abovideo, wenn der Wert der Property snippet.type upload ist. Es gibt jedoch keine Garantie dafür, dass die Antwort eine bestimmte Anzahl neuer Abovideos enthält.
- Unterstützung von RSS-Feeds
- Push-Benachrichtigungen für Feedaktualisierungen: Die API Version 2 unterstützte Push-Benachrichtigungen und nutzte entweder das Simple Update Protocol (SUP) oder PubSubHubbub, um die Feeds der Nutzeraktivitäten für YouTube-Nutzer zu überwachen. Es gab Benachrichtigungen zu neuen Kanalabonnements und wenn Videos bewertet, geteilt, zu Favoriten hinzugefügt, kommentiert oder hochgeladen wurden.
  
  Die V3 API unterstützt Push-Benachrichtigungen über das PubSubHubbub-Protokoll. Die Benachrichtigungen beziehen sich jedoch nur auf Videouploads und Aktualisierungen von Videotiteln oder Videobeschreibungen.
- Kanalstandort: Version 2 der API hat das Tag <yt:location> verwendet, um den im öffentlichen YouTube-Profil des Kanals eingegebenen Standort des Nutzers zu identifizieren. Einige Entwickler haben dieses Feld verwendet, um einen Kanal einem bestimmten Land zuzuordnen. Die Daten des Felds konnten jedoch nicht einheitlich für diesen Zweck verwendet werden.
- Entwickler-Tags festlegen oder abrufen: Mit der Version 2 der API konnten beim Hochladen eines Videos Keywords oder Entwickler-Tags verknüpft werden. Entwickler-Tags werden YouTube-Nutzern nicht angezeigt, aber Videoinhaber können Videos abrufen, die mit einem bestimmten Entwickler-Tag übereinstimmen.
  
  Version 3 des APIs bietet eine ähnliche, aber nicht identische Funktion. Insbesondere kann ein Entwickler nach Videos suchen, die von seiner eigenen Anwendung 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 der API Version 2 kannst du mit dem orderby-Parameter Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und verschiedenen anderen Werten sortieren. In der V3 API werden Playlist-Elemente in der Regel in aufsteigender Reihenfolge nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.
  
  Es gibt jedoch einige Ausnahmen. Ein neuer Upload, ein Favorit, ein Video mit „Mag ich“-Bewertung oder ein kürzlich angesehenes Video wird für die folgenden Playlists automatisch als erstes Element hinzugefügt (snippet.position=0). Jede dieser Listen wird also effektiv in der Reihenfolge vom neuesten zum ältesten Element sortiert, basierend auf dem Zeitpunkt, zu dem die Elemente zur Liste hinzugefügt wurden.
  - Uploads von Nutzern
  - Lieblingsvideos
  - positiv bewertete Videos
  - Wiedergabeverlauf
  Beachte jedoch, dass ein neues Element, das der Playlist „Später ansehen“ hinzugefügt wird, als letztes Element in dieser Liste hinzugefügt wird. Die Liste wird also faktisch vom ältesten zum neuesten Element sortiert.
- Batchverarbeitung: Die v3 API unterstützt einen der Anwendungsfälle für die Batchverarbeitung, die auch von der v2 API unterstützt wurde. Die Methoden channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list und videos.list der V3 API unterstützen alle den Parameter id, mit dem eine kommagetrennte 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.
Durch diese Änderungen werden in der Anleitung jetzt alle Funktionen aufgeführt, die in der alten API (Version 2) unterstützt wurden, aber in der aktuellen API-Version (Version 3) 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 Properties galt der Richtlinie zur Einstellung von APIs.
Die neue contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons-Eigenschaft 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 in der Anfrage versucht wird, die Position des Playlist-Elements festzulegen, die Playlist aber nicht manuell sortiert wird. Playlist-Elemente 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 der Playlist-Artikel eine bestimmte Position in der Liste haben soll, müssen Sie zuerst die Sortiereinstellung der Playlist zu Manuell ändern. Diese Einstellung kann im YouTube-Video-Manager angepasst werden.
`forbidden (403)`	`channelClosed`	Die Methode `playlists.list` gibt diesen Fehler zurück, wenn der Parameter `channelId` der Anfrage einen geschlossenen Kanal angibt.
`forbidden (403)`	`channelSuspended`	Die Methode `playlists.list` gibt diesen Fehler zurück, wenn der `channelId`-Parameter der Anfrage einen gesperrten Kanal angibt.
`forbidden (403)`	`playlistForbidden`	Die `playlists.list`-Methode gibt diesen Fehler zurück, wenn der `id`-Parameter 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 `id`-Parameter der Anfrage eine Playlist angibt, die nicht gefunden werden kann.
`notFound (404)`	`videoNotFound`	Die Methode `videos.list` gibt diesen Fehler zurück, wenn der `id`-Parameter 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:

Die Methode search.list unterstützt jetzt den Parameter relevanceLanguage, mit dem Sie Ergebnisse anfordern können, die für eine bestimmte Sprache am relevantesten sind.

In der Migrationsanleitung für die YouTube Data API (Version 3) wurde die Verwendung dieses neuen Parameters erläutert. Mit dem Parameter wird eine Funktionslücke geschlossen, die bisher zwischen der aktuellen API-Version (v3) und der vorherigen Version (v2) bestand, die bereits eingestellt wurde.
Der Migrationsleitfaden für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert. Darin wird darauf hingewiesen, dass die besonderen Feeds und Metadatenfelder, die in der Version 2 der API zur Beschreibung von Filmen, Trailern, Serien, Serienstaffeln und Serienfolgen bereitgestellt wurden, eingestellt werden.

14. Januar 2015

Dieses Update enthält die folgenden Änderungen:

Die Migrationsanleitung für die YouTube Data API (v3) wurde aktualisiert, um zu erklären, wie du API v3 zum Hochladen von Videos mithilfe von JavaScript verwendest. Weitere Informationen findest du im Abschnitt Video hochladen. Diese Funktion ist mit dem browserbasierten Upload vergleichbar, der von der v2 API unterstützt wird. Diese Änderung im Migrationsleitfaden spiegelt keine tatsächliche API-Änderung wider, sondern die Verfügbarkeit von neuem Beispielcode zum Hochladen von Videos mit clientseitigem JavaScript.

Da das Hochladen von Videos mit der JavaScript-Clientbibliothek und CORS unterstützt wird, wird das browserbasierte Hochladen im Migrationsleitfaden nicht mehr als Funktion aufgeführt, die in der API v3 möglicherweise eingestellt wird.
Die Dokumentation für die Methode videos.insert wurde um das oben beschriebene neue JavaScript-Codebeispiel ergänzt. Auch die Liste der JavaScript-Codebeispiele für die YouTube Data API (Version 3) wurde 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. Sehen Sie sich als Beispiel diese beiden Möglichkeiten an, um Videos zu finden, die auf den Kanal GoogleDevelopers hochgeladen wurden.
- Kontingentkosten: 100 Einheiten
  
  Rufen Sie die Methode search.list auf und suchen Sie nach GoogleDevelopers.
- Kontingentkosten: 6 Einheiten
  
  Rufen Sie die Methode channels.list auf, um die richtige Kanal-ID zu ermitteln. Setzen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails. 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 auf dem Kanal Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden können. Diese Property wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Gültige Attributwerte:
  - allowed: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.
  - eligible: Der Kanal ist berechtigt, Videos mit einer Länge von mehr als 15 Minuten hochzuladen, muss aber zuerst die Funktion aktivieren.
  - disallowed – Der Kanal kann keine Videos mit einer Länge von mehr als 15 Minuten hochladen.
  Weitere Informationen zu diesen Werten finden Sie in der Property-Definition. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe.
- Das Attribut invideoPromotion.useSmartTiming gibt an, ob für die Werbekampagne des Kanals „intelligentes Timing“ verwendet wird. Mit dieser Funktion werden Werbeunterbrechungen an einer Stelle im Video eingeblendet, an der sie mit höherer Wahrscheinlichkeit angeklickt werden und die Wiedergabe weniger stören. Außerdem wird mit dieser Funktion ein einzelnes Werbeangebot für jedes Video ausgewählt.
Die Definitionen der Attribute snippet.title und snippet.categoryId der video-Ressource wurden aktualisiert, um die Verarbeitung von Aufrufen der Methode videos.update durch die API zu verdeutlichen. 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 Property contentDetails.contentRating.oflcRating der Ressource video, die die Altersfreigabe eines Videos durch das neuseeländische Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Altersfreigaben: oflcRp13 und oflcRp16. Sie entsprechen den Bewertungen RP13 und RP16.

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

Fehlertyp	Fehlerdetails	Beschreibung
`badRequest`	`bannerAlbumFull`	Das Album des YouTube-Kanalbilds des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber sollte http://photos.google.com aufrufen, zur Seite „Alben“ gehen und einige Bilder aus diesem Album entfernen.

12. September 2014

Dieses Update enthält die folgenden Änderungen:

Die Kontingentkosten für einen Aufruf der Methode search.list wurden von 1 Einheit in 2 Einheiten geändert (zusätzlich zu den Kosten für die angegebenen Ressourcenteile).

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 das Limit für die Aborate überschritten. Sie können in ein paar Stunden weitere Abos ausprobieren.

12. August 2014

Dieses Update enthält die folgenden Änderungen:

In einer neuen Anleitung mit dem Titel Anwendung zur YouTube Data API (Version 3) migrieren wird erläutert, wie du mit der YouTube Data API (Version 3) die in der YouTube Data API (Version 2) verfügbaren Funktionen ausführen kannst. Die ältere API wurde am 4. März 2014 offiziell eingestellt. Dieser Leitfaden soll Ihnen dabei helfen, Anwendungen, die noch die v2 API verwenden, auf die neueste API-Version umzustellen.

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 eine Playlist nicht erstellt werden kann, weil der Kanal bereits die maximal zulässige Anzahl an Playlists erreicht hat.

18. Juni 2014

Dieses Update enthält die folgenden Änderungen:

Die Beschreibung der einzelnen API-Methoden wurde aktualisiert und enthält nun die Kontingentkosten, die durch den Aufruf dieser Methode entstehen. Ebenso 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 verursacht beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressource subscription enthält ebenfalls drei Teile (snippet, contentDetails und subscriberSnippet), von denen jeder Teil Kosten in Höhe von zwei Einheiten hat.

Bitte beachten Sie, dass sich Kontingentkosten ohne Vorwarnung ändern können.
Die Ressource video unterstützt inzwischen 43 neue Inhaltseinstufungssysteme, die die Einstufungen ermitteln, die Videos von verschiedenen nationalen Einstufungsstellen erhalten haben. Die neu unterstützten Bewertungssysteme sind Argentinien, Österreich, Belgien, Bulgarien, Chile (television), Chile (film), T Tschische Republik, Kolumbien, Dänemark, Ägyp, E-Ägyp, E2.} Esto Ägyp, E2.} Esto Ägyp, E2.

28. Mai 2014

Dieses Update enthält die folgenden Änderungen:

Die search.list-Methode unterstützt jetzt die Parameter location und locationRadius, mit denen du nach Videos suchen kannst, die mit einem geografischen Standort verknüpft sind. In einer Anfrage muss ein Wert für beide Parameter angegeben werden, um Ergebnisse basierend auf dem Standort abzurufen. Die 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 des Mittelpunkts des kreisförmigen geografischen Gebiets an.
- Der Parameter locationRadius gibt die maximale Entfernung an, die der mit einem Video verknüpfte Standort von der Mitte des Bereichs entfernt sein darf, damit das Video weiterhin in den Suchergebnissen angezeigt wird.

13. Mai 2014

Dieses Update enthält die folgenden Änderungen:

Die Property invideoPromotion.items[] der Ressource channel wurde aktualisiert. Du kannst 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 neuen Arten von empfohlenen Inhalten enthalten. Das Attribut snippet.type der Ressource channelSection unterstützt jetzt die folgenden Werte:
- postedPlaylists – Playlists, die der Inhaber des Kanals 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 Property contentDetails.contentRating.ifcoRating der video-Ressource gibt die Altersfreigabe an, die ein Video vom Irish Film Classification Office erhalten hat.
Die Definition der Eigenschaft position.cornerPosition der watermark-Ressource wurde aktualisiert. Das Wasserzeichen wird jetzt immer oben rechts im Player angezeigt.
Die Definition des q-Parameters für die search.list-Methode wurde aktualisiert, um zu beachten, dass der Suchbegriff den booleschen Operator NOT (-) verwenden kann, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Für den Wert kann auch der boolesche ODER-Operator (|) verwendet werden, 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, um zu verdeutlichen, dass es sich bei dem Wert um einen Näherungswert handelt und er möglicherweise keinen genauen Wert darstellt. Außerdem ist der Höchstwert 1.000.000. Sie sollten diesen Wert nicht zum Erstellen von Paginierungslinks verwenden. Verwenden Sie stattdessen die Eigenschaftswerte 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 den HTTP-Antwortcode 204 zurückgibt.

2. Mai 2014

Dieses Update enthält die folgenden Änderungen:

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

Die API unterstützt eine Methode, mit der unterstützte Anwendungssprachen aufgelistet werden. 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 Ressource i18nRegion gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugte Inhaltsregion auswählen kann. Der Inhaltsbereich kann auch als Inhaltssprache bezeichnet werden. Auf der YouTube-Website kann ein Inhaltsstandort basierend auf Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch ausgewählt werden. Nutzer können den gewünschten Inhaltsstandort auch manuell in der Fußzeile der YouTube-Website auswählen.

Die API unterstützt eine Methode, mit der unterstützte Inhaltsregionen aufgelistet werden. 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 Ressource channelSection enthält Informationen zu einer Reihe von Videos, die in einem Kanal empfohlen werden. Ein Bereich könnte beispielsweise die neuesten Uploads, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists eines Kanals enthalten.

Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren oder Löschen von Kanalabschnitten. Du kannst eine Liste der Kanalabschnitte 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, um die von der API unterstützten Fehlermeldungen speziell für diese neuen Methoden zu beschreiben.
Die Definition des fileDetails-Objekts der video-Ressource wurde aktualisiert, um zu erklären, dass dieses Objekt nur zurückgegeben wird, wenn die processingDetails.fileDetailsAvailability-Eigenschaft des Videos den Wert available hat.

In ähnlicher Weise wurde die Definition des suggestions-Objekts der video-Ressource aktualisiert, um zu erklären, dass dieses Objekt nur 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 verdeutlichen, dass das Attribut status.publishAt beim Aufrufen dieser Methoden festgelegt werden kann.
Die Definition des invideoPromotion-Objekts der Ressource channel wurde aktualisiert, um zu erklären, 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:

Mit der neuen Property status.publishAt der Ressource video kannst du das Datum und die Uhrzeit angeben, zu der ein privates Video veröffentlicht werden soll. Diese Eigenschaft kann nur festgelegt werden, wenn der Datenschutzstatus des Videos private lautet und das Video nie veröffentlicht wurde. Diese neue Property unterliegt nicht der Richtlinie zur Einstellung von Produkten und Diensten.

13. März 2014

Dieses Update enthält die folgenden Änderungen:

Die API unterstützt jetzt den Teil contentOwnerDetails für channel-Ressourcen. Der neue Teil enthält Kanaldaten, die für YouTube-Partner relevant sind, die mit dem Kanal verknüpft sind. Dazu gehören die ID des Rechteinhabers, der mit dem Kanal verknüpft ist, sowie Datum und Uhrzeit der Verknüpfung zwischen Rechteinhaber und Kanal. Beachten Sie, dass dieser neue Teil nicht der Richtlinie zur Einstellung von Produkten und Diensten unterliegt.

In der Dokumentation ist jetzt die maximal unterstützte Zeichenanzahl für die folgenden Properties aufgeführt:

Ressource	Attribut	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 der Eigenschaftswert eine Liste ist und Kommas zwischen den Elementen in der Liste auf den Grenzwert angerechnet werden.

Die Property brandingSettings.watch.featuredPlaylistId der Ressource channel wird nicht mehr unterstützt. Wenn Sie versuchen, den Wert festzulegen, gibt die API einen Fehler zurück.
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 werden, die nicht in Kombination 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. Hinweis: Die API gibt keinen Fehler zurück, wenn Sie das Attribut weglassen.
`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 `channels.update`-Methode gibt diesen Fehler zurück, wenn im Teil `invideoPromotion` ein ungültiger Zeitversatz angegeben ist.
`badRequest (400)`	`tooManyPromotedItems`	Die Methode `channels.update` gibt diesen Fehler zurück, wenn der `invideoPromotion`-Teil die zulässige Anzahl von beworbenen Artikeln überschreitet.
`forbidden (403)`	`promotedVideoNotAllowed`	Die Methode `channels.update` gibt diesen Fehler zurück, wenn die Eigenschaft `invideoPromotion.items[].id.videoId` eine Video-ID angibt, die entweder nicht gefunden werden kann oder nicht als beworbenes Element verwendet werden kann.
`forbidden (403)`	`websiteLinkNotAllowed`	Die Methode `channels.update` gibt diesen Fehler zurück, wenn für die Property `invideoPromotion.items[].id.websiteUrl` eine nicht zulässige URL angegeben ist.
`required (400)`	`requiredTimingType`	Die Methode `channels.update` gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardeinstellungen für die Zeitangabe angegeben werden, wann 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`	Für die `channels.update`-Methode muss für jeden beworbenen Artikel eine `invideoPromotion.items[].id.websiteUrl`-Property angegeben werden.
`badRequest (400)`	`invalidPublishAt`	Die `videos.insert`-Methode gibt diesen Fehler zurück, wenn in den Anfragemetadaten eine ungültige geplante Veröffentlichungszeit angegeben ist.

4. März 2014

Dieses Update enthält die folgenden Änderungen:

Die YouTube Data API Version 3 unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen für YouTube APIs beschrieben ist. Auf der Seite mit den APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen, werden insbesondere einige API-Funktionen der Version 3 von der Richtlinie ausgeschlossen.

5. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

Die Dokumentation für die Methode search.list wurde aktualisiert, um zu verdeutlichen, dass Sie beim Senden einer Suchanfrage keinen Wert für genau einen Filterparameter angeben müssen. Sie können stattdessen einen Wert für null oder einen Filterparameter festlegen.
Die Definitionen für die Parameter der search.list-Methode wurden aktualisiert. Sie müssen den Wert des Parameters type 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 für hochgeladene Kanalbannerbilder wurde auf 2.048 × 1.152 Pixel reduziert. Zuvor war die Mindestgröße 2.120 x 1.192 Pixel. Beachten Sie darüber hinaus, dass die channel-Ressourcendokumentation die maximalen Größen aller Bannerbilder angibt, die von der API bereitgestellt werden. Die maximale Größe des brandingSettings.image.bannerTvImageUrl-Bilds für Fernsehanwendungen beträgt beispielsweise 2.120 x 1.192 Pixel, das tatsächliche Bild kann aber 2.048 x 1.152 Pixel haben. In der YouTube-Hilfe findest du weitere Informationen dazu, wie du Kanalbilder für die Darstellung auf verschiedenen Gerätetypen optimieren kannst.
Mehrere Definitionen von channel-Ressourcenattributen wurden aktualisiert, um die folgenden Informationen widerzuspiegeln:
- Der Wert der Property brandingSettings.channel.description darf maximal 1.000 Zeichen lang sein.
- Das Attribut brandingSettings.channel.featuredChannelsTitle darf maximal 30 Zeichen lang sein.
- Mit der Property brandingSettings.channel.featuredChannelsUrls[] können jetzt bis zu 100 Kanäle aufgelistet werden.
- Der Property-Wert brandingSettings.channel.unsubscribedTrailer muss, falls festgelegt, die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos angeben, das dem Kanalinhaber gehört.
Die Methode channels.update unterstützt jetzt Aktualisierungen des Attributs invideoPromotion.items[].promotedByContentOwner. Diese Eigenschaft gibt an, ob der Name des Rechteinhabers bei der Anzeige der Werbung angezeigt wird. Es kann nur festgelegt werden, wenn die API-Anfrage, die den Attributwert festlegt, im Namen des Rechteinhabers mit dem Parameter onBehalfOfContentOwner 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 eine Altersfreigabe vom Australian Classification Board (ACB) für Filme oder von der Australian Communications and Media Authority (ACMA) für Kinderfernsehprogramme angegeben werden.
Die neuen Properties contentDetails.contentRating.catvRating und contentDetails.contentRating.catvfrRating identifizieren die Altersfreigaben, die ein Video nach dem kanadischen TV-Klassifizierungssystem bzw. dem französischsprachigen Altersfreigabesystem Régie du cinéma erhalten hat, das in Quebec verwendet wird.
Die neue Property snippet.assignable der videoCategory-Ressource gibt an, ob aktualisierte Videos oder neu hochgeladene Videos mit dieser Videokategorie verknüpft werden können.
Codebeispiele wurden für die folgenden Methoden hinzugefügt:
- activities.insert (Go)
- channelBanners.insert (Python)
- channels.update (Python)
- playlistItems.list (Go)
- search.list (Go)
- thumbnails.set (Java)
- videos.insert (Go)

24. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

Die API enthält zwei zusätzliche Funktionen für das Auffinden und Präsentieren von Live-Übertragungsinhalten:
Die neue Property snippet.liveBroadcastContent 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-Eigenschaft der video-Ressource gibt an, ob es sich bei dem Video um eine anstehende oder aktive Livestream-Übertragung handelt. In der folgenden Liste werden die möglichen Werte der Property erläutert:
  - upcoming: Das Video ist eine Liveübertragung, die noch nicht gestartet wurde.
  - active: Das Video ist eine laufende Liveübertragung.
  - none: Das Video ist keine anstehende oder aktive Liveübertragung. Das ist der Property-Wert für abgeschlossene Übertragungen, die noch auf YouTube angesehen werden können.
- 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 Properties:
  - liveStreamingDetails.actualStartTime: Der Zeitpunkt, zu dem die Übertragung tatsächlich gestartet wurde. Dieser Wert ist vorhanden, sobald der Status der Übertragung active ist.
  - liveStreamingDetails.actualEndTime: Der Zeitpunkt, zu dem die Übertragung tatsächlich beendet wurde. (Dieser Wert ist vorhanden, sobald die Übertragung beendet ist.)
  - liveStreamingDetails.scheduledStartTime: Der Zeitpunkt, zu dem die Übertragung geplant ist.
  - liveStreamingDetails.scheduledEndTime – Die Uhrzeit, zu der die Übertragung enden soll. Wenn der Eigenschaftswert leer oder die Eigenschaft nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit geplant.
  - liveStreamingDetails.concurrentViewers – Die Anzahl der Zuschauer, die sich die Übertragung ansehen.
  Wenn Sie diese Metadaten abrufen möchten, geben Sie beim Aufrufen der Methode videos.list, videos.insert oder videos.update den Wert liveStreamingDetails in den Parameter part ein.
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 videos.insert-Methode unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube Nutzern, die den Kanal des Videos abonniert haben, eine Benachrichtigung über das neue Video senden soll. Der Standardwert des Parameters ist True. Das bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch auf False setzen, damit die Abonnenten des Kanals nicht über jedes neue Video benachrichtigt werden.
Die Liste der Attribute, die beim Aufrufen der Methode channels.update geändert werden können, wurde aktualisiert und enthält jetzt die Attribute invideoPromotion.items[].customMessage und invideoPromotion.items[].websiteUrl. Außerdem wurde die Liste geändert, um die brandingSettings-Eigenschaften anzugeben, die änderbar sind. Diese brandingSettings-Properties waren bereits bearbeitbar. Die Änderung der Dokumentation bedeutet also keine Änderung an den vorhandenen Funktionen der API.
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 mehrere 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 snippet.liveBroadcastContent-Eigenschaft, die Teil der Suchergebnisse ist, wurde korrigiert. Sie zeigt jetzt, dass live ein gültiger Eigenschaftswert ist, active aber kein gültiger Eigenschaftswert.
Das Attribut contentDetails.contentRating.mibacRating der video-Ressource 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.
Das neue Attribut invideoPromotion.items[].promotedByContentOwner der channel-Ressource gibt an, ob der Name des Rechteinhabers bei der Präsentation des Angebots angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn die API-Anfrage, mit der der Wert festgelegt wird, im Namen des Rechteinhabers erfolgt. Weitere Informationen finden Sie im Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

Das neue auditDetails-Objekt der Ressource channel enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu entscheiden, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, muss ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten. Außerdem muss jedes Token, das diesen Geltungsbereich nutzt, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach der Ausstellung des Tokens.
Die Property invideoPromotion.items[].id.type der Ressource channel unterstützt jetzt den Wert recentUpload. Das bedeutet, dass das beworbene Element das zuletzt hochgeladene Video eines bestimmten Kanals ist.

Standardmäßig ist der Kanal der gleiche, für den die Daten zu In-Video-Werbung festgelegt wurden. Sie können jedoch das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem Sie den Wert der neuen invideoPromotion.items[].id.recentlyUploadedBy-Property auf die Kanal-ID dieses Kanals festlegen.
Die Ressource channel enthält drei neue Eigenschaften – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl und brandingSettings.image.bannerTvHighImageUrl –, mit denen die URLs für die Bannerbilder festgelegt werden, die auf Kanalseiten in Fernsehanwendungen angezeigt werden.
Die neue Eigenschaft snippet.liveBroadcastContent in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Werte für die Property sind upcoming, active und none.
- Bei einer video-Ressource gibt der Wert upcoming an, dass es sich um eine Liveübertragung handelt, die noch nicht gestartet wurde. Der Wert active hingegen gibt an, dass es sich um eine laufende Liveübertragung handelt.
- Bei einer channel-Ressource gibt der Wert upcoming an, dass der Kanal eine geplante Übertragung hat, die noch nicht begonnen hat, während der Wert acive darauf hinweist, dass auf dem Kanal eine laufende Liveübertragung läuft.
In der watermark-Ressource 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 Eigenschaft targetChannelId jetzt diesen Wert selbst an. Entsprechend wurde auch das Attribut targetChannelId.value der Ressource entfernt.
Die Methode thumbnails.set unterstützt jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.
Die Methode search.list unterstützt jetzt den Parameter eventType, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungsereignisse einschränkt.
Die neue contentDetails.contentRating.mibacRating-Property enthält die Bewertung, 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 Inhaber des bewerteten Videos die Altersfreigabe für dieses Video deaktiviert hat.

27. August 2013

Dieses Update enthält die folgenden Änderungen:

Die neue Ressource watermark identifiziert ein Bild, das während der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Du kannst auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Timing-Details, die festlegen, wann das Wasserzeichen während der Videowiedergabe angezeigt wird und wie lange es sichtbar ist.

Mit der Methode watermarks.set wird das Wasserzeichen 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. Der Wert der Property lautet daher 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 verschiedene 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 nach ISO 3166-1.

In der 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 für die Anfrage angegebenen OAuth 2.0-Tokens verknüpften Bereiche reichen für den Zugriff auf die angeforderten Daten nicht aus.

15. August 2013

Dieses Update enthält die folgenden Änderungen:

Das Objekt invideoPromotion der Ressource channel hat die folgenden neuen und aktualisierten Attribute:
- Die API unterstützt jetzt die Möglichkeit, eine Website als beworbener Artikel anzugeben. Legen Sie dazu den Wert des Attributs invideoPromotion.items[].id.type auf website fest und geben Sie die URL mit der neuen Property invideoPromotion.items[].id.websiteUrl an. Mit der neuen invideoPromotion.items[].customMessage-Property kannst du auch eine benutzerdefinierte Nachricht definieren, die für das Angebot angezeigt werden soll.
  
  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 unter Verknüpfte Websites und Händlerwebsites.
  
  Durch das Hinzufügen von Werbelinks erklären Sie sich damit einverstanden, dass diese Links nicht dazu verwendet werden, Zugriffe auf nicht autorisierte Websites weiterzuleiten. Außerdem erklären Sie sich damit einverstanden, dass diese Links den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.
- Die Properties im Zusammenhang mit den Zeiteinstellungen für die Anzeige von Anzeigen während der Videowiedergabe wurden umstrukturiert:
  - Das Objekt invideoPromotion.timing wurde in den Ordner invideoPromotion.items[].timing verschoben. Mit diesem Objekt können Sie jetzt die Zeitangaben für jeden beworbenen Artikel in der Liste invideoPromotion.items[] anpassen.
  - Das neue invideoPromotion.defaultTiming-Objekt gibt Standardeinstellungen für den zeitlichen Ablauf deiner Werbeaktion an. Mit diesen Einstellungen legst du fest, wann ein beworbener Artikel während der Wiedergabe eines Videos auf deinem Kanal angezeigt wird. Mit dem invideoPromotion.items[].timing-Objekt kannst du die Standardzeit für jeden beworbenen Artikel überschreiben.
  - Mit der neuen Property invideoPromotion.items[].timing.durationMs wird die Dauer in Millisekunden angegeben, für die das Angebot angezeigt werden soll. Das invideoPromotion.defaultTiming-Objekt enthält außerdem ein durationMs-Feld, das die Standarddauer angibt, für die das beworbene Element angezeigt wird.
- Die Eigenschaften invideoPromotion.items[].type und invideoPromotion.items[].videoId wurden in das invideoPromotion.items[].id-Objekt verschoben.
Die Methode subscriptions.list unterstützt jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Beide Parameter werden bereits für mehrere andere Methoden unterstützt.
In der API-Antwort auf eine thumbnails.set-Anfrage wurde der kind-Eigenschaftswert von youtube#thumbnailListResponse in youtube#thumbnailSetResponse geändert.
Codebeispiele wurden für die folgenden Methoden hinzugefügt:
- channels.update (Java, Python)
- playlists.insert (.NET, PHP)
- subscriptions.insert (PHP, Python)
- thumbnails.set (PHP, Python)
- videos.insert (PHP)
- videos.list (PHP)
- videos.rate (Python)
- videos.update (Java, PHP, Python)
Das Python-Beispiel für die playlistItems.insert-Methode wurde ebenfalls entfernt, da die darin demonstrierte Funktion jetzt von der videos.rate-Methode verarbeitet wird.

Die error documentation beschreibt den folgenden neuen Fehler im Anfragekontext, 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 kannst entweder den `mine`-Parameter entfernen, dich als YouTube-Nutzer durch Entfernen des `onBehalfOfContentOwner`-Parameters authentifizieren oder als einer der Partnerkanäle agieren, indem du den `onBehalfOfContentOwnerChannel`-Parameter angibst, sofern dieser für die aufgerufene Methode verfügbar ist.

8. August 2013

Dieses Update enthält die folgenden Änderungen:

Der Abschnitt Kontingentnutzung im Leitfaden Einstieg in die YouTube Data API wurde aktualisiert, da sich die Kontingentkosten für einen Videoupload von etwa 16.000 auf etwa 1.600 Einheiten geändert haben.

30. Juli 2013

Dieses Update enthält die folgenden Änderungen:

In einer channelBanner-Ressource hat sich der Wert des Attributs kind von youtube#channelBannerInsertResponse in 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 Eigenschaftswert besteht aus einem Pfundzeichen (#), gefolgt von einem sechsstelligen hexadezimalen String wie z. B. #2793e6.
Die API unterstützt jetzt die Angabe, ob ein Abo sich auf alle Aktivitäten eines Kanals oder nur auf neue Uploads bezieht. Mit der neuen Property contentDetails.activityType der subscription-Ressource werden die Arten von Aktivitäten angegeben, ü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 mit den beliebtesten Videos auf YouTube:
- Mit dem Parameter chart wird das Diagramm angegeben, das Sie abrufen möchten. Derzeit wird nur der Wert mostPopular unterstützt. Der chart-Parameter ist ein Filterparameter. Er kann also nicht in derselben Anfrage wie andere Filterparameter (id und myRating) verwendet werden.
- 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.
Die neue Property topicDetails.relevantTopicIds[] der Ressource video enthält eine Liste von Freebase-Themen-IDs, die für das Video oder seinen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt werden oder darin vorkommen.
Die Property recordingDetails.location.elevation der Ressource video wurde in recordingDetails.location.altitude umbenannt und die Property fileDetails.recordingLocation.location.elevation in fileDetails.recordingLocation.location.altitude.
Das contentDetails.contentRating-Objekt der video-Ressource gibt die Altersfreigaben an, die ein Video gemäß verschiedenen Altersfreigabesystemen erhalten hat, z. B. die Altersfreigaben der MPAA und TVPG. Für jedes Altersfreigabesystem unterstützt die API jetzt einen Altersfreigabewert, der angibt, dass das Video nicht bewertet wurde. Bei MPAA-Altersfreigaben wird die Altersfreigabe „Nicht bewertet“ häufig verwendet, 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 Inhalte aufweist, die für Nutzer unter 18 Jahren nicht geeignet sind. Wenn die Property fehlt oder der Property-Wert leer ist, wurden die Inhalte nicht als altersbeschränkt gekennzeichnet.
Der Parameter mySubscribers der Methode channels.list wurde eingestellt. Verwende die Methode subscriptions.list und den 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 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 zu verdeutlichen, dass diese Methode zum Aktualisieren des brandingSettings-Objekts der Ressource channel und ihrer untergeordneten Attribute verwendet werden kann. In der Dokumentation wird jetzt auch die aktualisierte Liste der Attribute aufgeführt, 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 auf eine bestimmte API-Methode. Gibt an, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln.
`forbidden`	`authenticatedUserAccountClosed`	Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Das YouTube-Konto des authentifizierten Nutzers ist geschlossen. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass das andere Konto geschlossen wurde.
`forbidden`	`authenticatedUserAccountSuspended`	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass das andere Konto gesperrt ist.
`forbidden`	`authenticatedUserNotChannel`	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Es 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 auf eine bestimmte API-Methode. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln.
`notFound`	`contentOwnerAccountNotFound`	Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Das angegebene Rechteinhaber-Konto wurde nicht gefunden.
`badRequest`	`invalidPart`	Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Der `part`-Parameter 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, wenn das Video, das du aktualisieren möchtest, nicht gefunden werden kann. 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 Parameter forUsername der Methode channels.list können Sie Informationen zu einem Kanal abrufen, indem Sie den 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 vorherigen Aktivitäten des autorisierten Nutzers auf YouTube nicht genügend Informationen liefern, um den Aktivitätsfeed zu generieren.
Playlist-Ressourcen enthalten jetzt die Property snippet.tags. Die Eigenschaft wird nur an autorisierte Nutzer zurückgegeben, die Daten zu ihren eigenen Playlists abrufen. Autorisierte Nutzer können Playlist-Tags auch beim Aufrufen der Methoden playlists.insert oder playlists.update festlegen.
Der Parameter onBehalfOfContentOwner, der zuvor 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 in der Anfrage auch ein Wert für den neuen Parameter onBehalfOfContentOwnerChannel angegeben werden, der den Kanal angibt, dem das Video hinzugefügt werden soll. Der Kanal muss mit dem Rechteinhaber verknüpft sein, der im Parameter onBehalfOfContentOwner angegeben ist.

Der Parameter gibt an, dass die Autorisierungs-Anmeldedaten 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 besitzen und verwalten. Mit diesem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne Anmeldedaten für jeden einzelnen Kanal angeben zu müssen.

Mit diesem Parameter können Contentpartner jetzt Videos auf allen ihren YouTube-Kanälen einfügen, aktualisieren oder löschen.

In der error documentation werden die folgenden neuen Fehler beschrieben:

Fehlertyp	Fehlerdetails	Beschreibung
`forbidden`	`insufficientCapabilities`	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Gibt an, dass der CMS-Nutzer, der die API aufruft, nicht über ausreichende Berechtigungen zum Ausführen des angeforderten Vorgangs verfügt. Dieser Fehler ist mit der Verwendung des Parameters `onBehalfOfContentOwner` verbunden, der für mehrere API-Methoden unterstützt wird.
`unauthorized`	`authorizationRequired`	Die `activities.list`-Methode gibt diesen Fehler zurück, wenn in der Anfrage der Parameter `home` verwendet wird, aber nicht ordnungsgemäß autorisiert ist.

In der channels-Ressource wurde die Property invideoPromotion.channelId entfernt, da die Kanal-ID bereits über die Property id der Ressource angegeben ist.
Im neuen Leitfaden Mit Kanal-IDs arbeiten wird erläutert, wie Kanal-IDs in der API verwendet werden. Der Leitfaden ist besonders hilfreich für Entwickler, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den Nutzer default anfordern oder davon ausgehen, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat, was nicht mehr der Fall ist.

22. Mai 2013

Dieses Update enthält die folgenden Änderungen:

Mit der neuen Methode channelBanners.insert kannst du ein Bannerbild hochladen, das anschließend über das neue Attribut brandingSettings.image.bannerExternalUrl der Ressource channel als Bannerbild für einen Kanal festgelegt werden kann.
Die Dokumentation zur channels.update-Methode wurde aktualisiert. Dort werden jetzt die Properties aufgeführt, die beim Aufrufen der Methode geändert werden können.
In der video-Ressourcendokumentation wird unspecified nicht mehr als gültiger Attributwert für die Attribute suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] und suggestions.editorSuggestions[] aufgeführt.
Der Parameter maxResults der Methode videos.list hat jetzt den Standardwert 5.
In der error documentation werden jetzt Fehler für die Methoden channelBanners.insert und subscriptions.list aufgeführt. Außerdem werden mehrere neue Fehler für die channels.update-Methode aufgeführt.

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:

YouTube kennzeichnet experimentelle API-Funktionen und ‑Dienste nicht mehr. Stattdessen stellen wir jetzt eine Liste der YouTube APIs bereit, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.

8. Mai 2013

Dieses Update enthält die folgenden Änderungen:

Kanalressourcen unterstützen jetzt das inVideoPromotion-Objekt, 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 während der Wiedergabe der Videos des Kanals anzuzeigen.

Du kannst diese Daten abrufen, indem du invideoPromotion in den Parameterwert part in einer channels.list-Anfrage einfügst.
Mit der neuen Methode channels.update können die Daten zu In-Video-Werbekampagnen eines Kanals aktualisiert werden. Beachten Sie, dass die Methode nur Aktualisierungen des invideoPromotion-Teils der channel-Ressource unterstützt, jedoch noch keine Aktualisierungen anderer Teile dieser Ressource.

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

Kanalressourcen unterstützen jetzt das Attribut status.isLinked. Damit wird angegeben, ob in den Kanaldaten ein Nutzer angegeben ist, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Nutzer mit einer solchen Verknüpfung haben bereits eine öffentliche YouTube-Identität, die Voraussetzung für verschiedene Aktionen wie das Hochladen von Videos ist.
Aboressourcen unterstützen jetzt den Teil subscriberSnippet. Dieses 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 myRating-Parameter der videos.list-Methode kannst du eine Liste von Videos abrufen, die der authentifizierte Nutzer mit der Einstufung like oder dislike bewertet hat.

Der Parameter myRating und der Parameter id gelten jetzt als Filterparameter. Das bedeutet, dass in einer API-Anfrage genau einer der Parameter angegeben werden muss. Bisher war der Parameter id für diese Methode erforderlich.

Die Methode gibt den Fehler forbidden zurück, wenn bei einer Anfrage versucht wird, Informationen zur Altersfreigabe von Videos abzurufen, die Person aber nicht berechtigt ist, dies zu tun.
Mit der Einführung des Parameters myRating wurde auch die Methode videos.list aktualisiert, um die Paginierung zu unterstützen. Beachten Sie jedoch, dass Paging-Parameter nur für Anfragen mit dem myRating-Parameter unterstützt werden. Parameter und Informationen zum Seitenwechsel werden für Anfragen, die den Parameter id verwenden, nicht unterstützt.
- Mit dem Parameter maxResults wird die maximale Anzahl von Videos angegeben, die die API im Ergebnissatz zurückgeben kann. Der Parameter pageToken gibt eine bestimmte Seite im Ergebnissatz an, die du abrufen möchtest.
- 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 in der aktuellen Ergebnismenge enthält. Die youtube#videoListResponse-Ressource kann auch nextPageToken- und prevPageToken-Properties enthalten. Jedes dieser Properties bietet ein Token, mit dem eine bestimmte Seite in der Ergebnismenge abgerufen werden kann.
Die Methode videos.insert unterstützt die folgenden neuen Parameter:
- autoLevels: Wenn du diesen Parameter auf true setzt, wird YouTube angewiesen, die Belichtung und Farben des Videos automatisch zu verbessern.
- stabilize: Setze diesen Parameterwert auf true, um YouTube anzuweisen, wackelige Bewegungen aufgrund von Kamerabewegungen zu entfernen.
Die Property channelTitle wurde der snippet für die folgenden Ressourcen hinzugefügt:
- playlistItem: Mit diesem Attribut wird der Name des Kanals angegeben, der das Playlist-Element hinzugefügt hat.
- playlist: Die Eigenschaft gibt den Namen des Kanals an, über den die Playlist erstellt wurde.
- subscription: Die Eigenschaft gibt den Namen des abonnierten Kanals an.
Für die folgenden Methoden wurden Codebeispiele hinzugefügt:
- activities.insert (Ruby)
- playlistItems.list (.NET)
- search.list (.NET)
- subscriptions.insert (Java, Ruby)
- videos.insert (.NET, Ruby)
Mit dem neuen Parameter mySubscribers der Methode subscriptions.list kannst du eine Liste der Abonnenten des aktuell authentifizierten Nutzers abrufen. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Hinweis: Diese Funktion soll den Parameter mySubscribers ersetzen, der derzeit für die Methode channels.list unterstützt wird. Dieser Parameter wird eingestellt.
In einer video-Ressource ist der Eigenschaftswert unspecified für keine der folgenden Properties mehr zulässig:
API-Anfragen mit einem unerwarteten Parameter geben jetzt den Fehler badRequest zurück. Als Grund für den Fehler wird unexpectedParameter angegeben.
Der Fehler, der von der Methode playlistItems.insert zurückgegeben wird, wenn die Playlist bereits die maximal zulässige Anzahl von Elementen enthält, wurde aktualisiert. Der Fehler wird jetzt als forbidden-Fehler mit der Fehlerursache playlistContainsMaximumNumberOfVideos gemeldet.

19. April 2013

Dieses Update enthält die folgenden Änderungen:

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

Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält jetzt die Fehler, die die API als Reaktion auf einen videos.rate-Methodenaufruf zurückgeben kann.
Thumbnail-Bilder werden in der API-Dokumentation jetzt als separate Ressource aufgeführt. Mit der neuen Methode thumbnails.set kannst du ein benutzerdefiniertes Video-Thumbnail auf YouTube hochladen und für ein Video festlegen.

Die Fehlerdokumentation wurde ebenfalls aktualisiert und listet nun die Fehler auf, die die API möglicherweise als Antwort auf einen thumbnails.set-Methodenaufruf zurückgibt.

Diese Änderung hat keine Auswirkungen auf vorhandene Ressourcen, die Miniaturansichten zurückgeben. Miniaturansichten werden in diesen Ressourcen auf die gleiche Weise wie zuvor zurückgegeben. In der Dokumentation sind jetzt jedoch die Namen der verschiedenen Miniaturansichten aufgeführt, die die API zurückgeben kann.
Der neue brandingSettings-Teil der Ressource channel enthält die Einstellungen, Texte 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 zum Playlist-Element und das Attribut status.privacyStatus gibt den Datenschutzstatus des Playlist-Elements an.

Die video-Ressource enthält die folgenden neuen Properties:

Die Property status.publicStatsViewable gibt an, ob erweiterte Videostatistiken auf der Wiedergabeseite öffentlich einsehbar sind. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Aufrufzahlen und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Property auf false festgelegt ist. Sie können den Wert dieses Attributs festlegen, wenn Sie die Methode videos.insert oder videos.update aufrufen.

Das contentDetails.contentRating-Objekt enthält die Bewertungen, die das Video bei verschiedenen Einstufungsschemata erhalten hat. In der folgenden Liste sind die unterstützten Bewertungssysteme aufgeführt. Außerdem finden Sie dort einen Link zu der Unterkunft, die dem jeweiligen Bewertungssystem zugeordnet ist. Die Property-Definitionen geben die unterstützten Bewertungswerte für jedes System an.

Land	Bewertungssystem	Attribut
USA	Motion Picture Association of America (MPAA)	`contentDetails.contentRating.mpaaRating`
USA	TV Parental Guidelines	`contentDetails.contentRating.tvpgRating`
Australien	Australian Classification Board (ACB)	`contentDetails.contentRating.acbRating`
Brasilien	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
Kanada	Canadian Home Video Rating System (CHVRS)	`contentDetails.contentRating.chvrsRating`
Frankreich	Centre national du cinéma et de l'image animée (französisches Kulturministerium)	`contentDetails.contentRating.fmocRating`
Deutschland	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	`contentDetails.contentRating.fskRating`
Großbritannien	British Board of Film Classification (BBFC)	`contentDetails.contentRating.bbfcRating`
Indien	Central Board of Film Certification (CBFC) (Central Board of Film Certification, CBFC)	`contentDetails.contentRating.cbfcRating`
Japan	映倫管理委員会 (EIRIN)	`contentDetails.contentRating.eirinRating`
Korea	영상물등급위원회 (KMRB)	`contentDetails.contentRating.kmrbRating`
Mexiko	General Directorate of Radio, Television and Cinematography (RTC)	`contentDetails.contentRating.rtcRating`
Neuseeland	Office of Film and Literature Classification	`contentDetails.contentRating.oflcRating`
Russland	National Film Registry der Russischen Föderation	`contentDetails.contentRating.russiaRating`
Spanien	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	`contentDetails.contentRating.icaaRating`

Die Dokumentation der Methode playlistItems.update wurde aktualisiert, um darauf hinzuweisen, dass die Property snippet.resourceId in der Ressource angegeben werden muss, die als Anfragetext gesendet wird.
Die search.list-Methode unterstützt jetzt die folgenden Funktionen:
- Mit dem neuen Parameter forMine wird die Suche so eingeschränkt, 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 die 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`	Für die Property `snippet.categoryId` ist eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode `videoCategories.list`, um unterstützte Kategorien abzurufen.
`badRequest`	`invalidRecordingDetails`	`metadata specifies invalid recording details.`
`badRequest`	`invalidVideoGameRating`	Die Metadaten der Anfrage enthalten eine ungültige Altersfreigabe für Videospiele.
`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 Eigenschaft gibt den Namen des Kanals an, der für die Aktivität verantwortlich ist.
- search: Mit dieser Property wird der Name des Kanals angegeben, der mit der im Suchergebnis angegebenen Ressource verknüpft ist.
- video: Mit diesem Attribut wird der Name des Kanals angegeben, auf den das Video hochgeladen wurde.
Die Methode search.list unterstützt die folgenden neuen Parameter:
- Mit dem Parameter channelType können Sie die Suche nach Kanälen auf alle Kanäle oder nur auf Sendungen beschränken.
- Mit dem Parameter videoType können Sie die Suche nach Videos so einschränken, dass entweder alle Videos oder nur Filme oder nur Folgen von Serien abgerufen werden.
Die Definition des recordingDetails-Teils der Ressource video wurde aktualisiert, um zu beachten, dass das Objekt nur dann für ein Video zurückgegeben wird, wenn die Standortdaten des Videos oder die Aufnahmezeit des Videos festgelegt wurden.
Die Methode playlistItems.update gibt jetzt einen invalidSnippet-Fehler 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-Inhaltspartner gedacht sind. Zu den YouTube-Inhaltspartnern gehören Film- und Fernsehstudios, Musiklabels und andere Creator, die ihre Inhalte auf YouTube verfügbar machen.
- Der Parameter onBehalfOfContentOwner 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 besitzen und verwalten. Mit diesem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne Anmeldedaten 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 Parameter managedByMe, der von der Methode channels.list unterstützt wird, weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die im Parameter onBehalfOfContentOwner angegeben sind.
- Der Parameter forContentOwner, der von der Methode search.list unterstützt wird, weist die API an, die Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der im Parameter onBehalfOfContentOwner angegeben ist.

25. Februar 2013

Dieses Update enthält die folgenden Änderungen:

Die API unterstützt mehrere neue Teile und Attribute für video-Ressourcen:
- Die neuen Teile für fileDetails, processingDetails und suggestions bieten Rechteinhabern Informationen zu ihren hochgeladenen Videos. Diese Daten sind in Apps, die Videouploads ermöglichen, sehr nützlich. Sie umfassen Folgendes:
  - Verarbeitungsstatus und -fortschritt
  - Fehler oder andere Probleme bei der Verarbeitung eines Videos
  - Verfügbarkeit von Thumbnail-Bildern
  - Vorschläge zur Verbesserung der Video- oder Metadatenqualität
  - Details zur auf YouTube hochgeladenen Originaldatei
  Alle diese Teile können nur vom Rechteinhaber des Videos abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der video-Ressourcendokumentation werden alle Attribute definiert, die die einzelnen Teile enthalten.
  - Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, z. B. die Auflösung, die Dauer, die Audio- und Video-Codecs und die Stream-Bitraten.
  - Das processingProgress-Objekt enthält Informationen zum Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube. Die Eigenschaften des Objekts geben den aktuellen Verarbeitungsstatus an und schätzen die verbleibende Zeit bis zur vollständigen Verarbeitung des Videos. Außerdem wird hier angezeigt, ob verschiedene Daten- oder Inhaltstypen wie Dateidetails oder Thumbnail-Bilder für das Video verfügbar sind.
    Dieses Objekt ist für Abfragen konzipiert, damit der Video-Uploader den Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube verfolgen kann.
  - Das suggestions-Objekt enthält Vorschläge zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video.
- Der Teil contentDetails enthält vier neue Eigenschaften. 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 Untertitel für das Video verfügbar sind.
  - licensedContent: Gibt an, ob das Video Inhalte enthält, auf die ein Anspruch von einem YouTube-Contentpartner erhoben wurde.
- Der Teil status enthält zwei neue Properties. Videoinhaber können beim Einfügen oder Aktualisieren eines Videos Werte für beide Properties 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 part-Parameters 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 contentDetails.googlePlusUserId-Eigenschaft der channel-Ressource gibt die Google+ Profil-ID an, die mit dem Kanal verknüpft ist. Mit diesem Wert kann ein Link zum Google+-Profil generiert werden.
Bei jedem Thumbnail-Bildobjekt werden jetzt die Breite und Höhe des Bilds angegeben. Miniaturansichten werden derzeit in den Ressourcen activity, channel, playlist, playlistItem, search result, subscription und video zurückgegeben.
playlistItems.list unterstützt jetzt den videoId-Parameter, der in Verbindung mit dem playlistId-Parameter verwendet werden kann, um nur das Playlist-Element abzurufen, das das angegebene Video repräsentiert.

Die API gibt einen notFound-Fehler 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 darauf hinweist, dass eine Anfrage nicht ordnungsgemäß für die angeforderte Aktion autorisiert ist.
Das Attribut snippet.channelId der Ressource channel wurde entfernt. Das Attribut id der Ressource bietet denselben Wert.

30. Januar 2013

Dieses Update enthält die folgenden Änderungen:

Auf der neuen Seite Fehler sind Fehler aufgeführt, die von der API zurückgegeben werden können. 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:

Codebeispiele sind jetzt für die in der folgenden Liste aufgeführten Methoden und Sprachen verfügbar:
- activities.insert: Java
- playlistItems.insert – Python
- playlistItems.list: Java, JavaScript, PHP, Python, Ruby
- playlists.insert – Java, JavaScript, Python
- search.list – Java, JavaScript, Python, Ruby
- videos.insert: Java
Eine activity-Ressource kann jetzt eine channelItem-Aktion melden. Diese tritt auf, wenn YouTube einem automatisch generierten YouTube-Kanal ein Video hinzufügt. (YouTube-Algorithmen identifizieren Themen, die auf der YouTube-Website stark vertreten sind, und erstellen automatisch Kanäle für diese Themen.)
Die folgenden search.list-Parameter wurden aktualisiert:
- Der Parameter q ist nicht mehr als Filter gekennzeichnet. Das bedeutet:
- Der Parameter relatedToVideo wurde in relatedToVideoId umbenannt.
- Der Parameter published wurde durch zwei neue Parameter ersetzt: publishedAfter und publishedBefore. Sie werden unten beschrieben.

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`	Filtern Sie die Videosuchergebnisse, sodass nur Videos angezeigt werden, die mit der angegebenen Videokategorie verknüpft sind.
`videoEmbeddable`	`string`	Sie können die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die in einem eingebetteten Player auf einer Webseite wiedergegeben werden können. Legen Sie den Parameterwert auf `true` fest, um nur einbettbare Videos abzurufen.
`videoSyndicated`	`string`	Mit diesem Parameter kannst du die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die außerhalb von YouTube.com wiedergegeben werden können. Wenn du den Parameterwert auf `true` festlegst, werden nur syndizierte Videos zurückgegeben.

Mehrere API-Ressourcen unterstützen neue Properties. In der folgenden Tabelle sind die Ressourcen und ihre neuen Properties aufgeführt:

Ressource	Property-Name	Wert	Beschreibung
`activity`	`contentDetails.playlistItem.playlistItemId`	`string`	Die Playlist-Element-ID, die YouTube zugewiesen wurde, um das Element in der Playlist eindeutig zu identifizieren.
`activity`	`contentDetails.channelItem`	`object`	Ein Objekt mit Informationen zu einer Ressource, die einem Kanal hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn `snippet.type` `channelItem` ist.
`activity`	`contentDetails.channelItem.resourceId`	`object`	Ein Objekt, das die Ressource identifiziert, die dem Kanal hinzugefügt wurde. Wie andere `resourceId`-Attribute enthält es eine `kind`-Eigenschaft, die den Ressourcentyp angibt, z. B. Video oder Playlist. Außerdem enthält es genau eine von mehreren Eigenschaften (z. B. `videoId` oder `playlistId`), die die ID angibt, mit der die Ressource eindeutig identifiziert wird.
`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 kannst.
`playlist`	`player.embedHtml`	`string`	Ein `<iframe>`-Tag, das einen Videoplayer einbettet, der die Playlist wiedergibt.
`video`	`recordingDetails`	`object`	Dieses Objekt enthält Informationen zur Identifizierung oder Beschreibung des Ortes und der Zeit, zu der das Video aufgezeichnet wurde.
`video`	`recordingDetails.location`	`object`	Dieses Objekt enthält Informationen zur Geolokalisierung, 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`	Die Höhe über der Erde in Metern.
`video`	`recordingDetails.locationDescription`	`string`	Eine Textbeschreibung des Orts, an dem das Video aufgenommen wurde.
`video`	`recordingDetails.recordingDate`	`datetime`	Datum und Uhrzeit der Aufnahme des Videos. Der Wert wird im Format ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`) angegeben.

Die Dokumentation für mehrere API-Methoden identifiziert nun Eigenschaften, die im Anfragetext angegeben werden müssen oder die anhand der Werte im Anfragetext aktualisiert werden müssen. In der folgenden Tabelle sind diese Methoden sowie die erforderlichen oder änderbaren Eigenschaften aufgeführt.

Hinweis: In der Dokumentation zu anderen Methoden sind möglicherweise bereits erforderliche und änderbare Eigenschaften aufgeführt.

Methode	Attribute
`activities.insert`	Erforderliche Attribute: `snippet.description` Modifizierbare Eigenschaften: `snippet.description` `contentDetails.bulletin.resourceId`
`playlists.update`	Erforderliche Eigenschaften: `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 Playlist hat, die bereits im selben Kanal vorhanden ist.

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 mit dem Parameter `id` angegebene Kategorie für die Anleitung kann nicht gefunden werden. Mit der Methode guideCategories.list können Sie eine Liste der gültigen Werte abrufen.
`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 wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.